commitment_coverage_timeseries

Creates, updates, deletes, gets or lists a commitment_coverage_timeseries resource.

Overview

Name	commitment_coverage_timeseries
Type	Resource
Id	datadog.cloud_costs.commitment_coverage_timeseries

Fields

The following fields are returned by SELECT queries:

get_commitments_coverage_timeseries

Name	Datatype	Description
cost	object	A timeseries metric containing timestamps, series values, and optional unit metadata.
hours	object	A timeseries metric containing timestamps, series values, and optional unit metadata.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_commitments_coverage_timeseries	select	provider, product, start, end	filter_by	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.

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)
filter_by	string	Optional filter expression to narrow down results. (wire: filterBy)

SELECT examples

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.

SELECT
cost,
hours
FROM datadog.cloud_costs.commitment_coverage_timeseries
WHERE provider = '{{ provider }}' -- required
AND product = '{{ product }}' -- required
AND start = '{{ start }}' -- required
AND end = '{{ end }}' -- required
AND filter_by = '{{ filter_by }}'
;