v1

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

Get commitments coverage (timeseries)

Get timeseries coverage metrics for cloud commitment programs, broken down by coverage type (Reserved Instances, Savings Plans, On-Demand, and Spot) for both hours and cost.

get/api/v2/cost/commitments/coverage/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.

Response

OK

Example response

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