@@ -2179,6 +2179,74 @@ components:
2179
2179
- storage_account
2180
2180
- storage_container
2181
2181
type: object
2182
+ BillingDimensionsMappingBody:
2183
+ description: Billing dimensions mapping data.
2184
+ items:
2185
+ $ref: '#/components/schemas/BillingDimensionsMappingBodyItem'
2186
+ type: array
2187
+ BillingDimensionsMappingBodyItem:
2188
+ description: The mapping data for each billing dimension.
2189
+ properties:
2190
+ attributes:
2191
+ $ref: '#/components/schemas/BillingDimensionsMappingBodyItemAttributes'
2192
+ id:
2193
+ description: ID of the billing dimension.
2194
+ type: string
2195
+ type:
2196
+ $ref: '#/components/schemas/ActiveBillingDimensionsType'
2197
+ type: object
2198
+ BillingDimensionsMappingBodyItemAttributes:
2199
+ description: Mapping of billing dimensions to endpoint keys.
2200
+ properties:
2201
+ endpoints:
2202
+ description: List of supported endpoints with their keys mapped to the billing_dimension.
2203
+ items:
2204
+ $ref: '#/components/schemas/BillingDimensionsMappingBodyItemAttributesEndpointsItems'
2205
+ type: array
2206
+ in_app_label:
2207
+ description: Label used for the billing dimension in the Plan & Usage charts.
2208
+ example: APM Hosts
2209
+ type: string
2210
+ timestamp:
2211
+ description: 'Month in ISO-8601 format, UTC, and precise to the second:
2212
+ `[YYYY-MM-DDThh:mm:ss]`.'
2213
+ format: date-time
2214
+ type: string
2215
+ type: object
2216
+ BillingDimensionsMappingBodyItemAttributesEndpointsItems:
2217
+ description: An endpoint's keys mapped to the billing_dimension.
2218
+ properties:
2219
+ id:
2220
+ description: The URL for the endpoint.
2221
+ example: api/v1/usage/billable-summary
2222
+ type: string
2223
+ keys:
2224
+ description: The billing dimension.
2225
+ example:
2226
+ - apm_host_top99p
2227
+ - apm_host_sum
2228
+ items:
2229
+ example: apm_host_top99p
2230
+ type: string
2231
+ type: array
2232
+ status:
2233
+ $ref: '#/components/schemas/BillingDimensionsMappingBodyItemAttributesEndpointsItemsStatus'
2234
+ type: object
2235
+ BillingDimensionsMappingBodyItemAttributesEndpointsItemsStatus:
2236
+ description: Denotes whether mapping keys were available for this endpoint.
2237
+ enum:
2238
+ - OK
2239
+ - NOT_FOUND
2240
+ type: string
2241
+ x-enum-varnames:
2242
+ - OK
2243
+ - NOT_FOUND
2244
+ BillingDimensionsMappingResponse:
2245
+ description: Billing dimensions mapping response.
2246
+ properties:
2247
+ data:
2248
+ $ref: '#/components/schemas/BillingDimensionsMappingBody'
2249
+ type: object
2182
2250
BulkMuteFindingsRequest:
2183
2251
description: The new bulk mute finding request.
2184
2252
properties:
@@ -40478,6 +40546,70 @@ paths:
40478
40546
operator: OR
40479
40547
permissions:
40480
40548
- usage_read
40549
+ /api/v2/usage/billing_dimension_mapping:
40550
+ get:
40551
+ description: 'Get a mapping of billing dimensions to the corresponding keys
40552
+ for the supported usage metering public API endpoints.
40553
+
40554
+ Mapping data is updated on a monthly cadence.
40555
+
40556
+
40557
+ This endpoint is only accessible to [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/).'
40558
+ operationId: GetBillingDimensionMapping
40559
+ parameters:
40560
+ - description: Datetime in ISO-8601 format, UTC, and for mappings beginning
40561
+ this month. Defaults to the current month.
40562
+ in: query
40563
+ name: filter[month]
40564
+ required: false
40565
+ schema:
40566
+ format: date-time
40567
+ type: string
40568
+ - description: String to specify whether to retrieve active billing dimension
40569
+ mappings for the contract or for all available mappings. Allowed views have
40570
+ the string `active` or `all`. Defaults to `active`.
40571
+ in: query
40572
+ name: filter[view]
40573
+ required: false
40574
+ schema:
40575
+ default: active
40576
+ type: string
40577
+ responses:
40578
+ '200':
40579
+ content:
40580
+ application/json;datetime-format=rfc3339:
40581
+ schema:
40582
+ $ref: '#/components/schemas/BillingDimensionsMappingResponse'
40583
+ description: OK
40584
+ '400':
40585
+ content:
40586
+ application/json;datetime-format=rfc3339:
40587
+ schema:
40588
+ $ref: '#/components/schemas/APIErrorResponse'
40589
+ description: Bad Request
40590
+ '403':
40591
+ content:
40592
+ application/json;datetime-format=rfc3339:
40593
+ schema:
40594
+ $ref: '#/components/schemas/APIErrorResponse'
40595
+ description: Forbidden - User is not authorized
40596
+ '429':
40597
+ content:
40598
+ application/json;datetime-format=rfc3339:
40599
+ schema:
40600
+ $ref: '#/components/schemas/APIErrorResponse'
40601
+ description: Too many requests
40602
+ security:
40603
+ - apiKeyAuth: []
40604
+ appKeyAuth: []
40605
+ - AuthZ:
40606
+ - usage_read
40607
+ summary: Get billing dimension mapping for usage endpoints
40608
+ tags:
40609
+ - Usage Metering
40610
+ x-unstable: '**Note**: This endpoint is in Preview.
40611
+
40612
+ If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
40481
40613
/api/v2/usage/cost_by_org:
40482
40614
get:
40483
40615
deprecated: true
0 commit comments