Sign in

v1

latestOpenAPI 3.0.02026-07-141,4077,1665.2 MB
Cloud Cost Management

Get commitments utilization (timeseries)

Get timeseries utilization metrics for cloud commitment programs, including used and unused cost series over time.

get/api/v2/cost/commitments/utilization/timeseries

Query parameters

provider'aws' | 'azure' required

Cloud provider for commitment programs.

Example:aws

Cloud provider for commitment programs (aws or azure).

productstring required

Cloud product identifier (for example, ec2, rds, virtualmachines).

startinteger required

Start of the query time range in Unix milliseconds.

endinteger required

End of the query time range in Unix milliseconds.

filterBystring

Optional filter expression to narrow down results.

commitmentType'ri' | 'sp'

Type of commitment. ri for Reserved Instances, sp for Savings Plans.

Example:ri

Type of commitment to query. ri for Reserved Instances, sp for Savings Plans. Defaults to ri.

Response

OK

seriesCommitmentsTimeseriesSeries required

Timeseries data as a map of series names to their corresponding value arrays.

timesinteger[] required

Unix timestamps in seconds for the timeseries data points.

Example response

{
  "times": [
    1693526400,
    1693612800
  ],
  "unit": {
    "family": "percentage",
    "id": 17,
    "name": "percent",
    "plural": "percent",
    "scale_factor": 1,
    "short_name": "%"
  }
}