AWS Cost Explorer icon

AWS Cost Explorer

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

Actions12

Reserved Instances → Get Utilization

AI-generated

Summary

Get Utilization operation for Reserved Instances retrieves AWS Reserved Instance utilization data.

Inputs

  • startDate (required) — Start date in YYYY-MM-DD format (inclusive).
  • endDate (required) — End date in YYYY-MM-DD format (exclusive).
  • granularity — Time granularity for the results: DAILY or MONTHLY (default MONTHLY).
  • riGroupByService — If true, breaks down utilization data by AWS service (default true).

Output shape

object

Returns the raw AWS GetReservationUtilization response, which includes UtilizationByTime array and total utilization metrics.

Examples

Example 1: Daily utilization broken down by service

Set startDate='2024-01-01', endDate='2024-02-01', granularity='DAILY', riGroupByService=true

Example 2: Monthly overall utilization

Set startDate='2024-01-01', endDate='2024-04-01', granularity='MONTHLY', riGroupByService=false

Links

Discussion