AWS Cost Explorer icon

AWS Cost Explorer

Retrieve cost, usage, anomalies and recommendations from AWS Cost Explorer

Actions12

Savings Plans → Get Coverage

AI-generated

Summary

Retrieve Savings Plans coverage for a given date range

Inputs

  • startDate (required) — Start date of the coverage period in YYYY-MM-DD format (inclusive)
  • endDate (required) — End date of the coverage period in YYYY-MM-DD format (exclusive)
  • granularity — Granularity of the coverage data, either 'DAILY' or 'MONTHLY' (default: MONTHLY)

Output shape

Array of Savings Plans coverage records as returned by AWS, each containing fields such as SavingsPlanArn, Coverage, and optional pagination metadata

All pages are aggregated; the exact fields depend on the AWS response and may include additional attributes.

Examples

Example 1: Get coverage for EC2 Savings Plans from 2024-01-01 to 2024-01-31 with monthly granularity

Start Date: 2024-01-01, End Date: 2024-01-31, Granularity: MONTHLY

Links

Discussion