Class: Aws::CostExplorer::Types::GetReservationCoverageRequest

Inherits:
Struct
  • Object
show all
Includes:
Structure
Defined in:
lib/aws-sdk-costexplorer/types.rb

Overview

You can use the following request parameters to query for how much of your instance usage a reservation covered.

See Also:

Constant Summary collapse

SENSITIVE = 
[]

Instance Attribute Summary collapse

Instance Attribute Details

#filter ⇒ Types::Expression

Filters utilization data by dimensions. You can filter by the following dimensions:

  • AZ

  • CACHE_ENGINE

  • DATABASE_ENGINE

  • DEPLOYMENT_OPTION

  • INSTANCE_TYPE

  • LINKED_ACCOUNT

  • OPERATING_SYSTEM

  • PLATFORM

  • REGION

  • SERVICE

  • TAG

  • TENANCY

‘GetReservationCoverage` uses the same [Expression] object as the other operations, but only `AND` is supported among each dimension. You can nest only one level deep. If there are multiple values for a dimension, they are OR’d together.

If you don’t provide a ‘SERVICE` filter, Cost Explorer defaults to EC2.

Cost category is also supported.

[1]: docs.aws.amazon.com/aws-cost-management/latest/APIReference/API_Expression.html

Returns:



3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
 
# File 'lib/aws-sdk-costexplorer/types.rb', line 3372

class GetReservationCoverageRequest < Struct.new(
  :time_period,
  :group_by,
  :granularity,
  :filter,
  :metrics,
  :next_page_token,
  :sort_by,
  :max_results)
  SENSITIVE = []
  include Aws::Structure
end

#granularity ⇒ String

The granularity of the Amazon Web Services cost data for the reservation. Valid values are ‘MONTHLY` and `DAILY`.

If ‘GroupBy` is set, `Granularity` can’t be set. If ‘Granularity` isn’t set, the response object doesn’t include ‘Granularity`, either `MONTHLY` or `DAILY`.

The ‘GetReservationCoverage` operation supports only `DAILY` and `MONTHLY` granularities.

Returns:

  • (String) 


3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
 
# File 'lib/aws-sdk-costexplorer/types.rb', line 3372

class GetReservationCoverageRequest < Struct.new(
  :time_period,
  :group_by,
  :granularity,
  :filter,
  :metrics,
  :next_page_token,
  :sort_by,
  :max_results)
  SENSITIVE = []
  include Aws::Structure
end

#group_by ⇒ Array<Types::GroupDefinition>

You can group the data by the following attributes:

  • AZ

  • CACHE_ENGINE

  • DATABASE_ENGINE

  • DEPLOYMENT_OPTION

  • INSTANCE_TYPE

  • INVOICING_ENTITY

  • LINKED_ACCOUNT

  • OPERATING_SYSTEM

  • PLATFORM

  • REGION

  • TENANCY

Returns:



3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
 
# File 'lib/aws-sdk-costexplorer/types.rb', line 3372

class GetReservationCoverageRequest < Struct.new(
  :time_period,
  :group_by,
  :granularity,
  :filter,
  :metrics,
  :next_page_token,
  :sort_by,
  :max_results)
  SENSITIVE = []
  include Aws::Structure
end

#max_results ⇒ Integer

The maximum number of objects that you returned for this request. If more objects are available, in the response, Amazon Web Services provides a NextPageToken value that you can use in a subsequent call to get the next batch of objects.

Returns:

  • (Integer) 


3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
 
# File 'lib/aws-sdk-costexplorer/types.rb', line 3372

class GetReservationCoverageRequest < Struct.new(
  :time_period,
  :group_by,
  :granularity,
  :filter,
  :metrics,
  :next_page_token,
  :sort_by,
  :max_results)
  SENSITIVE = []
  include Aws::Structure
end

#metrics ⇒ Array<String>

The measurement that you want your reservation coverage reported in.

Valid values are ‘Hour`, `Unit`, and `Cost`. You can use multiple values in a request.

Returns:

  • (Array<String>) 


3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
 
# File 'lib/aws-sdk-costexplorer/types.rb', line 3372

class GetReservationCoverageRequest < Struct.new(
  :time_period,
  :group_by,
  :granularity,
  :filter,
  :metrics,
  :next_page_token,
  :sort_by,
  :max_results)
  SENSITIVE = []
  include Aws::Structure
end

#next_page_token ⇒ String

The token to retrieve the next set of results. Amazon Web Services provides the token when the response from a previous call has more results than the maximum page size.

Returns:

  • (String) 


3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
 
# File 'lib/aws-sdk-costexplorer/types.rb', line 3372

class GetReservationCoverageRequest < Struct.new(
  :time_period,
  :group_by,
  :granularity,
  :filter,
  :metrics,
  :next_page_token,
  :sort_by,
  :max_results)
  SENSITIVE = []
  include Aws::Structure
end

#sort_by ⇒ Types::SortDefinition

The value by which you want to sort the data.

The following values are supported for ‘Key`:

  • ‘OnDemandCost`

  • ‘CoverageHoursPercentage`

  • ‘OnDemandHours`

  • ‘ReservedHours`

  • ‘TotalRunningHours`

  • ‘CoverageNormalizedUnitsPercentage`

  • ‘OnDemandNormalizedUnits`

  • ‘ReservedNormalizedUnits`

  • ‘TotalRunningNormalizedUnits`

  • ‘Time`

Supported values for ‘SortOrder` are `ASCENDING` or `DESCENDING`.

Returns:



3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
 
# File 'lib/aws-sdk-costexplorer/types.rb', line 3372

class GetReservationCoverageRequest < Struct.new(
  :time_period,
  :group_by,
  :granularity,
  :filter,
  :metrics,
  :next_page_token,
  :sort_by,
  :max_results)
  SENSITIVE = []
  include Aws::Structure
end

#time_period ⇒ Types::DateInterval

The start and end dates of the period that you want to retrieve data about reservation coverage for. You can retrieve data for a maximum of 13 months: the last 12 months and the current month. The start date is inclusive, but the end date is exclusive. For example, if ‘start` is `2017-01-01` and `end` is `2017-05-01`, then the cost and usage data is retrieved from `2017-01-01` up to and including `2017-04-30` but not including `2017-05-01`.

Returns:



3372
3373
3374
3375
3376
3377
3378
3379
3380
3381
3382
3383
 
# File 'lib/aws-sdk-costexplorer/types.rb', line 3372

class GetReservationCoverageRequest < Struct.new(
  :time_period,
  :group_by,
  :granularity,
  :filter,
  :metrics,
  :next_page_token,
  :sort_by,
  :max_results)
  SENSITIVE = []
  include Aws::Structure
end