SavingsPlansCoverageQuery - AWS Billing and Cost Management
Services or capabilities described in AWS documentation might vary by Region. To see the differences applicable to the AWS European Sovereign Cloud Region, see the AWS European Sovereign Cloud User Guide.

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: