Regenerate client from commit 98884042 of spec repo

Author: ci.datadog-api-spec

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2023-11-16 18:34:27.532496",
-            "spec_repo_commit": "973bd612"
+            "regenerated": "2023-11-16 19:38:34.020238",
+            "spec_repo_commit": "98884042"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2023-11-16 18:34:27.550231",
-            "spec_repo_commit": "973bd612"
+            "regenerated": "2023-11-16 19:38:34.039208",
+            "spec_repo_commit": "98884042"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -4123,6 +4123,63 @@ components:
       - IDENTITY
       - GZIP
       - DEFLATE
+    CostAttributionAggregates:
+      description: An array of available aggregates.
+      items:
+        $ref: '#/components/schemas/CostAttributionAggregatesBody'
+      type: array
+    CostAttributionAggregatesBody:
+      description: The object containing the aggregates.
+      properties:
+        agg_type:
+          description: The aggregate type.
+          example: sum
+          type: string
+        field:
+          description: The field.
+          example: infra_host_committed_cost
+          type: string
+        value:
+          description: The value for a given field.
+          format: double
+          type: number
+      type: object
+    CostAttributionTagNames:
+      additionalProperties:
+        description: 'A list of values that are associated with each tag key.
+
+          - An empty list means the resource use wasn''t tagged with the respective
+          tag.
+
+          - Multiple values means the respective tag was applied multiple times on
+          the resource.
+
+          - An `<empty>` value means the resource was tagged with the respective tag
+          but did not have a value.'
+        items:
+          description: A given tag in a list.
+          example: datadog-integrations-lab
+          type: string
+        type: array
+      description: 'Tag keys and values.
+
+        A `null` value here means that the requested tag breakdown cannot be applied
+        because it does not match the [tags
+
+        configured for usage attribution](https://docs.datadoghq.com/account_management/billing/usage_attribution/#getting-started).
+
+        In this scenario the API returns the total cost, not broken down by tags.'
+      nullable: true
+      type: object
+    CostAttributionType:
+      default: cost_by_tag
+      description: Type of cost attribution data.
+      enum:
+      - cost_by_tag
+      example: cost_by_tag
+      type: string
+      x-enum-varnames:
+      - COST_BY_TAG
     CostByOrg:
       description: Cost data.
       properties:
@@ -10921,6 +10978,75 @@ components:
           description: The monitor type.
           type: string
       type: object
+    MonthlyCostAttributionAttributes:
+      description: Cost Attribution by Tag for a given organization.
+      properties:
+        month:
+          description: 'Datetime in ISO-8601 format, UTC, precise to hour: `[YYYY-MM-DDThh]`.'
+          format: date-time
+          type: string
+        org_name:
+          description: The name of the organization.
+          type: string
+        public_id:
+          description: The organization public ID.
+          type: string
+        tag_config_source:
+          description: The source of the cost attribution tag configuration and the
+            selected tags in the format `<source_org_name>:::<selected tag 1>///<selected
+            tag 2>///<selected tag 3>`.
+          type: string
+        tags:
+          $ref: '#/components/schemas/CostAttributionTagNames'
+        updated_at:
+          description: Shows the most recent hour in the current months for all organizations
+            for which all costs were calculated.
+          type: string
+        values:
+          description: 'Fields in Cost Attribution by tag(s). Example: `infra_host_on_demand_cost`,
+            `infra_host_committed_cost`, `infra_host_total_cost`, `infra_host_percentage_in_org`,
+            `infra_host_percentage_in_account`.'
+          type: object
+      type: object
+    MonthlyCostAttributionBody:
+      description: Cost data.
+      properties:
+        attributes:
+          $ref: '#/components/schemas/MonthlyCostAttributionAttributes'
+        id:
+          description: Unique ID of the response.
+          type: string
+        type:
+          $ref: '#/components/schemas/CostAttributionType'
+      type: object
+    MonthlyCostAttributionMeta:
+      description: The object containing document metadata.
+      properties:
+        aggregates:
+          $ref: '#/components/schemas/CostAttributionAggregates'
+        pagination:
+          $ref: '#/components/schemas/MonthlyCostAttributionPagination'
+      type: object
+    MonthlyCostAttributionPagination:
+      description: The metadata for the current pagination.
+      properties:
+        next_record_id:
+          description: The cursor to use to get the next results, if any. To make
+            the next request, use the same parameters with the addition of the `next_record_id`.
+          nullable: true
+          type: string
+      type: object
+    MonthlyCostAttributionResponse:
+      description: Response containing the monthly cost attribution by tag(s).
+      properties:
+        data:
+          description: Response containing cost attribution.
+          items:
+            $ref: '#/components/schemas/MonthlyCostAttributionBody'
+          type: array
+        meta:
+          $ref: '#/components/schemas/MonthlyCostAttributionMeta'
+      type: object
     NullableRelationshipToUser:
       description: Relationship to user.
       nullable: true
@@ -17085,6 +17211,16 @@ components:
       - channel_name
       - redirect_url
       type: object
+    SortDirection:
+      default: desc
+      description: The direction to sort by.
+      enum:
+      - desc
+      - asc
+      type: string
+      x-enum-varnames:
+      - DESC
+      - ASC
     Span:
       description: Object description of a spans after being processed and stored
         by Datadog.
@@ -20906,6 +21042,128 @@ paths:
       x-unstable: '**Note**: This endpoint is in public beta.
 
         If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
+  /api/v2/cost_by_tag/monthly_cost_attribution:
+    get:
+      description: "Get monthly cost attribution by tag across multi-org and single
+        root-org accounts.\nCost Attribution data for a given month becomes available
+        no later than the 17th of the following month.\nThis API endpoint is paginated.
+        To make sure you receive all records, check if the value of `next_record_id`
+        is\nset in the response. If it is, make another request and pass `next_record_id`
+        as a parameter.\nPseudo code example:\n```\nresponse := GetMonthlyCostAttribution(start_month,
+        end_month)\ncursor := response.metadata.pagination.next_record_id\nWHILE cursor
+        != null BEGIN\n  sleep(5 seconds)  # Avoid running into rate limit\n  response
+        := GetMonthlyCostAttribution(start_month, end_month, next_record_id=cursor)\n
+        \ cursor := response.metadata.pagination.next_record_id\nEND\n```"
+      operationId: GetMonthlyCostAttribution
+      parameters:
+      - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`
+          for cost beginning in this month.'
+        in: query
+        name: start_month
+        required: true
+        schema:
+          format: date-time
+          type: string
+      - description: 'Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`
+          for cost ending this month.'
+        in: query
+        name: end_month
+        required: true
+        schema:
+          format: date-time
+          type: string
+      - description: 'Comma-separated list specifying cost types (e.g., `<billing_dimension>_on_demand_cost`,
+          `<billing_dimension>_committed_cost`, `<billing_dimension>_total_cost`)
+          and the
+
+          proportions (`<billing_dimension>_percentage_in_org`, `<billing_dimension>_percentage_in_account`).
+          Use `*` to retrieve all fields.
+
+          Example: `infra_host_on_demand_cost,infra_host_percentage_in_account`
+
+          To obtain the complete list of active billing dimensions that can be used
+          to replace
+
+          `<billing_dimension>` in the field names, make a request to the [Get active
+          billing dimensions API](https://docs.datadoghq.com/api/latest/usage-metering/#get-active-billing-dimensions-for-cost-attribution).'
+        in: query
+        name: fields
+        required: true
+        schema:
+          type: string
+      - description: 'The direction to sort by: `[desc, asc]`.'
+        in: query
+        name: sort_direction
+        required: false
+        schema:
+          $ref: '#/components/schemas/SortDirection'
+      - description: 'The billing dimension to sort by. Always sorted by total cost.
+          Example: `infra_host`.'
+        in: query
+        name: sort_name
+        required: false
+        schema:
+          type: string
+      - description: 'Comma separated list of tag keys used to group cost. If no value
+          is provided the cost will not be broken down by tags.
+
+          To see which tags are available, look for the value of `tag_config_source`
+          in the API response.'
+        in: query
+        name: tag_breakdown_keys
+        required: false
+        schema:
+          type: string
+      - description: List following results with a next_record_id provided in the
+          previous query.
+        in: query
+        name: next_record_id
+        required: false
+        schema:
+          type: string
+      - description: Include child org cost in the response. Defaults to `true`.
+        in: query
+        name: include_descendants
+        required: false
+        schema:
+          default: true
+          type: boolean
+      responses:
+        '200':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/MonthlyCostAttributionResponse'
+          description: OK
+        '400':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Bad Request
+        '403':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Forbidden - User is not authorized
+        '429':
+          content:
+            application/json;datetime-format=rfc3339:
+              schema:
+                $ref: '#/components/schemas/APIErrorResponse'
+          description: Too many requests
+      security:
+      - apiKeyAuth: []
+        appKeyAuth: []
+      - AuthZ:
+        - usage_read
+      summary: Get Monthly Cost Attribution
+      tags:
+      - Usage Metering
+      x-unstable: '**Note**: This endpoint is in public beta.
+
+        If you have any feedback, contact [Datadog support](https://docs.datadoghq.com/help/).'
   /api/v2/current_user/application_keys:
     get:
       description: List all application keys available for current user

cassettes/v2/Usage-Metering_938753175/Get-Monthly-Cost-Attribution-returns-Bad-Request-response_2819784758/frozen.json

@@ -0,0 +1 @@
+"2023-11-09T21:04:11.196Z"

cassettes/v2/Usage-Metering_938753175/Get-Monthly-Cost-Attribution-returns-Bad-Request-response_2819784758/recording.har

@@ -0,0 +1,70 @@
+{
+  "log": {
+    "_recordingName": "Usage Metering/Get Monthly Cost Attribution returns \"Bad Request\" response",
+    "creator": {
+      "comment": "persister:fs",
+      "name": "Polly.JS",
+      "version": "6.0.5"
+    },
+    "entries": [
+      {
+        "_id": "18ee4756df00da9bd5f76c9eb18f2a57",
+        "_order": 0,
+        "cache": {},
+        "request": {
+          "bodySize": 0,
+          "cookies": [],
+          "headers": [
+            {
+              "_fromType": "array",
+              "name": "accept",
+              "value": "application/json;datetime-format=rfc3339"
+            }
+          ],
+          "headersSize": 666,
+          "httpVersion": "HTTP/1.1",
+          "method": "GET",
+          "queryString": [
+            {
+              "name": "start_month",
+              "value": "2023-11-04T21:04:11.196Z"
+            },
+            {
+              "name": "end_month",
+              "value": "2023-11-06T21:04:11.196Z"
+            },
+            {
+              "name": "fields",
+              "value": "not_a_product"
+            }
+          ],
+          "url": "https://api.datadoghq.com/api/v2/cost_by_tag/monthly_cost_attribution?start_month=2023-11-04T21%3A04%3A11.196Z&end_month=2023-11-06T21%3A04%3A11.196Z&fields=not_a_product"
+        },
+        "response": {
+          "bodySize": 96,
+          "content": {
+            "mimeType": "application/json",
+            "size": 96,
+            "text": "{\"errors\":[\"API called with non-parent org keys. Data is only available at the root level org\"]}"
+          },
+          "cookies": [],
+          "headers": [
+            {
+              "name": "content-type",
+              "value": "application/json"
+            }
+          ],
+          "headersSize": 649,
+          "httpVersion": "HTTP/1.1",
+          "redirectURL": "",
+          "status": 400,
+          "statusText": "Bad Request"
+        },
+        "startedDateTime": "2023-11-09T21:04:11.207Z",
+        "time": 215
+      }
+    ],
+    "pages": [],
+    "version": "1.2"
+  }
+}

cassettes/v2/Usage-Metering_938753175/Get-Monthly-Cost-Attribution-returns-OK-response_718127100/frozen.json

@@ -0,0 +1 @@
+"2023-11-09T21:14:30.498Z"