DAdatadog
Cloud Cost Management

Get commitments on-demand hot spots (scalar)

Get scalar on-demand hot-spots data for cloud commitment programs, showing per-dimension breakdowns of on-demand spending with coverage metrics and potential savings.

get/api/v2/cost/commitments/on-demand-hot-spots/scalar

Request

  • Base URL
    https://api.datadoghq.com
  • URL
    https://api.datadoghq.com/api/v2/cost/commitments/on-demand-hot-spots/scalar
  • Auth
    • API key in header DD-API-KEY and API key in header DD-APPLICATION-KEY
    • or OAuth 2
      Authorization code: /oauth2/v1/authorize
      Token URL: /oauth2/v1/token scopes: cloud_cost_management_read

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

{
  "columns": [
    {
      "meta": {
        "unit": {
          "family": "percentage",
          "id": 17,
          "name": "percent",
          "plural": "percent",
          "scale_factor": 1,
          "short_name": "%"
        }
      },
      "name": "utilization",
      "type": "group",
      "values": [
        0.85,
        0.72
      ]
    }
  ],
  "meta": {
    "on_demand_filters": "region:us-east-1"
  },
  "total": [
    {
      "meta": {
        "unit": {
          "family": "percentage",
          "id": 17,
          "name": "percent",
          "plural": "percent",
          "scale_factor": 1,
          "short_name": "%"
        }
      },
      "name": "utilization",
      "type": "group",
      "values": [
        0.85,
        0.72
      ]
    }
  ]
}

Changes

No recorded changes to this operation across all 1 revision of this API.