SavingsPlansCoverageQuery

Defines the parameters for querying Savings Plans coverage data, including metrics, grouping options, and time granularity.

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 Savings Plans coverage data, such as by service or instance family.

Type: Array of GroupDefinition objects

Required: No

metrics

The coverage metrics to include in the results.

Note

Valid value for SavingsPlansCoverageQuery metrics is SpendCoveredBySavingsPlans.

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