ReservationCoverageQuery

Defines the parameters for querying Reserved Instance coverage data, including grouping options, metrics, and sorting preferences.

Contents

timeRange

Defines a time period with explicit start and end times for data queries.

Type: DateTimeRange object

Required: Yes

filter

Defines complex filtering conditions using logical operators (AND, OR, NOT) and various filter types.

Type: Expression object

Required: No

granularity

The time granularity of the retrieved data: HOURLY, DAILY, or MONTHLY.

Type: String

Valid Values: HOURLY | DAILY | MONTHLY

Required: No

groupBy

Specifies how to group the Reserved Instance coverage data, such as by service, Region, or instance type.

Type: Array of GroupDefinition objects

Required: No

metrics

The coverage metrics to include in the results.

Note

Valid values for ReservationCoverageQuery metrics are Hour, Unit, and Cost.

Type: Array of strings

Valid Values: AmortizedCost | BlendedCost | NetAmortizedCost | NetUnblendedCost | NormalizedUsageAmount | UnblendedCost | UsageQuantity | SpendCoveredBySavingsPlans | Hour | Unit | Cost

Required: No

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following:

• AWS SDK for C++

• AWS SDK for Java V2

• AWS SDK for Ruby V3