commitment_utilization_scalar
Creates, updates, deletes, gets or lists a commitment_utilization_scalar resource.
Overview
| Name | commitment_utilization_scalar |
| Type | Resource |
| Id | datadog.cloud_costs.commitment_utilization_scalar |
Fields
The following fields are returned by SELECT queries:
- get_commitments_utilization_scalar
| Name | Datatype | Description |
|---|---|---|
columns | array | Array of scalar columns in the response. |
product_breakdown | array | Array of per-product utilization breakdown entries. |
Methods
The following methods are available for this resource:
| Name | Accessible by | Required Params | Optional Params | Description |
|---|---|---|---|---|
get_commitments_utilization_scalar | select | provider, product, start, end | filter_by, commitment_type | Get scalar utilization metrics for cloud commitment programs, including utilization percentage and unused cost. |
Parameters
Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.
| Name | Datatype | Description |
|---|---|---|
end | integer (int64) | End of the query time range in Unix milliseconds. (example: 1696118400000) |
product | string | Cloud product identifier (for example, ec2, rds, virtualmachines). (example: ec2) |
provider | string | Cloud provider for commitment programs (aws or azure). |
site | string | The Datadog site (region) for your organization, for example datadoghq.com, us3.datadoghq.com, us5.datadoghq.com, ap1.datadoghq.com, ap2.datadoghq.com, datadoghq.eu, ddog-gov.com. Resolved from the DD_SITE environment variable when set. Optional: defaults to datadoghq.com, or the value of the DD_SITE environment variable when set; a WHERE value overrides both. |
start | integer (int64) | Start of the query time range in Unix milliseconds. (example: 1693526400000) |
commitment_type | string | Type of commitment to query. ri for Reserved Instances, sp for Savings Plans. Defaults to ri. (wire: commitmentType) |
filter_by | string | Optional filter expression to narrow down results. (wire: filterBy) |
SELECT examples
- get_commitments_utilization_scalar
Get scalar utilization metrics for cloud commitment programs, including utilization percentage and unused cost.
SELECT
columns,
product_breakdown
FROM datadog.cloud_costs.commitment_utilization_scalar
WHERE provider = '{{ provider }}' -- required
AND product = '{{ product }}' -- required
AND start = '{{ start }}' -- required
AND end = '{{ end }}' -- required
AND filter_by = '{{ filter_by }}'
AND commitment_type = '{{ commitment_type }}'
;