historical_cost_by_org

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

Overview

Name	historical_cost_by_org
Type	Resource
Id	datadog.organization.historical_cost_by_org

Fields

The following fields are returned by SELECT queries:

get_historical_cost_by_org

Name	Datatype	Description
id	string	Unique ID of the response.
attributes	object	Cost attributes data.
type	string	Type of cost data. (cost_by_org) (default: cost_by_org, example: cost_by_org)

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get_historical_cost_by_org	select	start_month	view, end_month, include_connected_accounts	Get historical cost across multi-org and single root-org accounts.<br />Cost data for a given month becomes available no later than the 16th of the following month.<br /><br />This endpoint is only accessible for [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.
start_month	string (date-time)	Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for cost beginning this month.
end_month	string (date-time)	Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for cost ending this month.
include_connected_accounts	boolean	Boolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to false.
view	string	String to specify whether cost is broken down at a parent-org level or at the sub-org level. Available views are summary and sub-org. Defaults to summary.

SELECT examples

get_historical_cost_by_org

Get historical cost across multi-org and single root-org accounts.<br />Cost data for a given month becomes available no later than the 16th of the following month.<br /><br />This endpoint is only accessible for [parent-level organizations](https:​//docs.datadoghq.com/account_management/multi_organization/).

SELECT
id,
attributes,
type
FROM datadog.organization.historical_cost_by_org
WHERE start_month = '{{ start_month }}' -- required
AND view = '{{ view }}'
AND end_month = '{{ end_month }}'
AND include_connected_accounts = '{{ include_connected_accounts }}'
;