billing_dimension_mapping

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

Overview

Name	billing_dimension_mapping
Type	Resource
Id	datadog.organization.billing_dimension_mapping

Fields

The following fields are returned by SELECT queries:

get_billing_dimension_mapping

Name	Datatype	Description
id	string	ID of the billing dimension.
attributes	object	Mapping of billing dimensions to endpoint keys.
type	string	Type of active billing dimensions data. (billing_dimensions) (default: billing_dimensions)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_billing_dimension_mapping	select		filter[month], filter[view]	Get a mapping of billing dimensions to the corresponding keys for the supported usage metering public API endpoints.<br />Mapping data is updated on a monthly cadence.<br /><br />This endpoint is only accessible to [parent-level organizations](https:​//docs.datadoghq.com/account_management/multi_organization/).

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
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.
filter[month]	string (date-time)	Datetime in ISO-8601 format, UTC, and for mappings beginning this month. Defaults to the current month.
filter[view]	string	String to specify whether to retrieve active billing dimension mappings for the contract or for all available mappings. Allowed views have the string active or all. Defaults to active.

SELECT examples

get_billing_dimension_mapping

Get a mapping of billing dimensions to the corresponding keys for the supported usage metering public API endpoints.<br />Mapping data is updated on a monthly cadence.<br /><br />This endpoint is only accessible to [parent-level organizations](https:​//docs.datadoghq.com/account_management/multi_organization/).

SELECT
id,
attributes,
type
FROM datadog.organization.billing_dimension_mapping
WHERE filter[month] = '{{ filter[month] }}'
AND filter[view] = '{{ filter[view] }}'
;