commitment_coverage_scalar

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

Overview

Name	commitment_coverage_scalar
Type	Resource
Id	datadog.cloud_costs.commitment_coverage_scalar

Fields

The following fields are returned by SELECT queries:

get_commitments_coverage_scalar

Name	Datatype	Description
name	string	The column name. (example: utilization)
meta	object	Metadata for a scalar column, including unit information.
type	string	The column type. "group" for dimension columns, "number" for metric columns. (group, number) (example: group)
values	array	Values for a scalar column. Arrays of strings for group columns, numbers for value columns.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_commitments_coverage_scalar	select	provider, product, start, end	filter_by	Get scalar coverage metrics for cloud commitment programs, including hours and cost coverage percentages.

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_scalar

Get scalar coverage metrics for cloud commitment programs, including hours and cost coverage percentages.

SELECT
name,
meta,
type,
values
FROM datadog.cloud_costs.commitment_coverage_scalar
WHERE provider = '{{ provider }}' -- required
AND product = '{{ product }}' -- required
AND start = '{{ start }}' -- required
AND end = '{{ end }}' -- required
AND filter_by = '{{ filter_by }}'
;