datadog get-monthly-usage-attribution
Get monthly usage attribution
Description
Get monthly usage attribution
Synopsis
datadog get-monthly-usage-attribution
[--site <site>]
--start <start>
[--end <end>]
--fields <fields>
[--sort_direction <sort_direction>]
[--sort_name <sort_name>]
[--tag_breakdown <tag_breakdown>]
[--next <next>]
[--exclude_descendants]
Arguments
site
- (string)
Site where this command will be executed
Example: --site "site-1"
Default: input.site
Attributes: optional
start
- (time)
For usage beginning in this month, max 15 months
Example: --start "2019-10-12T07:20:50.52Z"
Default: 6 months ago
Attributes: required
end
- (string)
For usage ending this month
Example: --end "end-1"
Default: _None_
Attributes: optional
fields
- (string)
usage types to return, or * for all usage types
Example: --fields "fields-1"
Default: _None_
Attributes: required, multiple allowed
Validation:
allowed values: api_usage, api_percentage, apm_fargate_usage, apm_fargate_percentage, appsec_fargate_usage, appsec_fargate_percentage, apm_host_usage, apm_host_percentage, appsec_usage, appsec_percentage, browser_usage, browser_percentage, container_usage, container_percentage, cspm_containers_percentage, cspm_containers_usage, cspm_hosts_percentage, cspm_hosts_usage, custom_timeseries_usage, custom_timeseries_percentage, cws_containers_percentage, cws_containers_usage, cws_hosts_percentage, cws_hosts_usage, dbm_hosts_percentage, dbm_hosts_usage, dbm_queries_percentage, dbm_queries_usage, estimated_indexed_logs_usage, estimated_indexed_logs_percentage, estimated_ingested_logs_usage, estimated_ingested_logs_percentage, estimated_indexed_spans_usage, estimated_indexed_spans_percentage, estimated_ingested_spans_usage, estimated_ingested_spans_percentage, fargate_usage, fargate_percentage, functions_usage, functions_percentage, indexed_logs_usage, indexed_logs_percentage, infra_host_usage, infra_host_percentage, invocations_usage, invocations_percentage, npm_host_usage, npm_host_percentage, profiled_container_usage, profiled_container_percentage, profiled_host_usage, profiled_host_percentage, snmp_usage, snmp_percentage, estimated_rum_sessions_usage, estimated_rum_sessions_percentage, cont_usage, cont_percentage, *
sort_direction
- (string)
The direction to sort by
Example: --sort_direction "sort_direction-1"
Default: _None_
Attributes: optional
Validation:
allowed values: desc, asc
sort_name
- (string)
The field to sort by
Example: --sort_name "sort_name-1"
Default: _None_
Attributes: optional
Validation:
allowed values: api_usage, api_percentage, apm_fargate_usage, apm_fargate_percentage, appsec_fargate_usage, appsec_fargate_percentage, apm_host_usage, apm_host_percentage, appsec_usage, appsec_percentage, browser_usage, browser_percentage, container_usage, container_percentage, cspm_containers_percentage, cspm_containers_usage, cspm_hosts_percentage, cspm_hosts_usage, custom_timeseries_usage, custom_timeseries_percentage, cws_containers_percentage, cws_containers_usage, cws_hosts_percentage, cws_hosts_usage, dbm_hosts_percentage, dbm_hosts_usage, dbm_queries_percentage, dbm_queries_usage, estimated_indexed_logs_usage, estimated_indexed_logs_percentage, estimated_ingested_logs_usage, estimated_ingested_logs_percentage, estimated_indexed_spans_usage, estimated_indexed_spans_percentage, estimated_ingested_spans_usage, estimated_ingested_spans_percentage, fargate_usage, fargate_percentage, functions_usage, functions_percentage, indexed_logs_usage, indexed_logs_percentage, infra_host_usage, infra_host_percentage, invocations_usage, invocations_percentage, npm_host_usage, npm_host_percentage, profiled_container_usage, profiled_container_percentage, profiled_host_usage, profiled_host_percentage, snmp_usage, snmp_percentage, estimated_rum_sessions_usage, estimated_rum_sessions_percentage, cont_usage, cont_percentage, *
tag_breakdown
- (string)
If no value is provided the usage will not be broken down by tags
Example: --tag_breakdown "tag_breakdown-1"
Default: _None_
Attributes: optional, multiple allowed
next
- (string)
List following results with a next_record_id provided in the previous query
Example: --next "next-1"
Default: _None_
Attributes: optional
exclude_descendants
- (bool)
Include child org usage in the response
Example: --exclude_descendants
Default: false
Attributes: optional
Examples
Input:
Output:Access Control
To use this command, you need access to the following:
Field | Value |
---|---|
Action | "read" |
Service Type | "datadog" |
Service Instance | |
Namespace | |
Object Type | "usage" |
Object ID |
Please see Access Control for details.