Skip to main content

estimated_cost_by_org

Creates, updates, deletes, gets or lists an estimated_cost_by_org resource.

Overview

Nameestimated_cost_by_org
TypeResource
Iddatadog.organization.estimated_cost_by_org

Fields

The following fields are returned by SELECT queries:

NameDatatypeDescription
idstringUnique ID of the response.
attributesobjectCost attributes data.
typestringType of cost data. (default: cost_by_org, example: cost_by_org)

Methods

The following methods are available for this resource:

NameAccessible byRequired ParamsOptional ParamsDescription
get_estimated_cost_by_orgselectregionview, start_month, end_month, start_date, end_date, include_connected_accountsGet estimated cost across multi-org and single root-org accounts.
Estimated cost data is only available for the current month and previous month
and is delayed by up to 72 hours from when it was incurred.
To access historical costs prior to this, use the /historical_cost endpoint.

This endpoint is only accessible for parent-level organizations.

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.

NameDatatypeDescription
regionstring(default: datadoghq.com)
end_datestring (date-time)Datetime in ISO-8601 format, UTC, precise to day: [YYYY-MM-DD] for cost ending this day.
end_monthstring (date-time)Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for cost ending this month.
include_connected_accountsbooleanBoolean to specify whether to include accounts connected to the current account as partner customers in the Datadog partner network program. Defaults to false.
start_datestring (date-time)Datetime in ISO-8601 format, UTC, precise to day: [YYYY-MM-DD] for cost beginning this day. Either start_month or start_date should be specified, but not both. (start_date cannot go beyond two months in the past). Provide an end_date to view day-over-day cumulative cost.
start_monthstring (date-time)Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] for cost beginning this month. Either start_month or start_date should be specified, but not both. (start_month cannot go beyond two months in the past). Provide an end_month to view month-over-month cost.
viewstringString 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 estimated cost across multi-org and single root-org accounts.
Estimated cost data is only available for the current month and previous month
and is delayed by up to 72 hours from when it was incurred.
To access historical costs prior to this, use the /historical_cost endpoint.

This endpoint is only accessible for parent-level organizations.

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