Regenerate client from commit 4359eda of spec repo (#3630)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v1/openapi.yaml

@@ -22716,7 +22716,13 @@ components:
           $ref: "#/components/schemas/UsageSpecifiedCustomReportsMeta"
       type: object
     UsageSummaryDate:
-      description: Response with hourly report of all data billed by Datadog all organizations.
+      description: |-
+        Response with hourly report of all data billed by Datadog for all organizations.
+
+        Newly added billing dimensions and usage types appear as untyped keys on the
+        `additionalProperties` map instead of as typed fields. Call
+        `GET /api/v2/usage/summary/available_fields` to enumerate every key returned
+        at this response level—both typed fields and `additionalProperties` keys.
       properties:
         agent_host_top99p:
           description: Shows the 99th percentile of all agent hosts over all hours in the current date for all organizations.
@@ -23739,7 +23745,13 @@ components:
           type: integer
       type: object
     UsageSummaryDateOrg:
-      description: Global hourly report of all data billed by Datadog for a given organization.
+      description: |-
+        Global hourly report of all data billed by Datadog for a given organization.
+
+        Newly added billing dimensions and usage types appear as untyped keys on the
+        `additionalProperties` map instead of as typed fields. Call
+        `GET /api/v2/usage/summary/available_fields` to enumerate every key returned
+        at this response level—both typed fields and `additionalProperties` keys.
       properties:
         account_name:
           description: The account name.
@@ -24780,7 +24792,14 @@ components:
           type: integer
       type: object
     UsageSummaryResponse:
-      description: Response summarizing all usage aggregated across the months in the request for all organizations, and broken down by month and by organization.
+      description: |-
+        Response summarizing all usage aggregated across the months in the request for
+        all organizations, and broken down by month and by organization.
+
+        Newly added billing dimensions and usage types appear as untyped keys on the
+        `additionalProperties` map instead of as typed fields. Call
+        `GET /api/v2/usage/summary/available_fields` to enumerate every key returned
+        at this response level—both typed fields and `additionalProperties` keys.
       properties:
         agent_host_top99p_sum:
           description: Shows the 99th percentile of all agent hosts over all hours in the current month for all organizations.
@@ -42260,6 +42279,12 @@ paths:
       description: |-
         Get all usage across your account.
 
+        Newly added billing dimensions and usage types appear as untyped keys on the
+        `additionalProperties` map of `UsageSummaryResponse`, `UsageSummaryDate`, and
+        `UsageSummaryDateOrg` instead of as typed fields. Call
+        `GET /api/v2/usage/summary/available_fields` to enumerate every key returned
+        at each response level—both typed fields and `additionalProperties` keys.
+
         This endpoint is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/).
       operationId: GetUsageSummary
       parameters:

.generator/schemas/v2/openapi.yaml

@@ -96978,6 +96978,67 @@ components:
             $ref: "#/components/schemas/UsageDataObject"
           type: array
       type: object
+    UsageSummaryAvailableFieldsAttributes:
+      description: |-
+        The lists of field names returned by `GET /api/v1/usage/summary` at each
+        of its three response levels. Each list contains every key the data endpoint
+        emits—both typed fields declared in the OpenAPI spec and untyped keys
+        exposed through `additionalProperties`.
+      properties:
+        date_fields:
+          description: |-
+            Sorted list of every key returned inside each `UsageSummaryDate`
+            entry of `usage[]` (typed fields and `additionalProperties` keys
+            combined).
+          items:
+            type: string
+          type: array
+        date_org_fields:
+          description: |-
+            Sorted list of every key returned inside each `UsageSummaryDateOrg`
+            entry of `usage[].orgs[]` (typed fields and `additionalProperties`
+            keys combined).
+          items:
+            type: string
+          type: array
+        response_fields:
+          description: |-
+            Sorted list of every key returned as a direct property of
+            `UsageSummaryResponse` (typed fields and `additionalProperties`
+            keys combined).
+          items:
+            type: string
+          type: array
+      type: object
+    UsageSummaryAvailableFieldsBody:
+      description: Available-fields data.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/UsageSummaryAvailableFieldsAttributes"
+        id:
+          description: The identifier for the discovery scope. Always `"all"`.
+          example: all
+          type: string
+        type:
+          $ref: "#/components/schemas/UsageSummaryAvailableFieldsType"
+      type: object
+    UsageSummaryAvailableFieldsResponse:
+      description: |-
+        Response listing every field name returned by `GET /api/v1/usage/summary`
+        at each of its three response levels. Includes both typed fields and untyped
+        `additionalProperties` keys.
+      properties:
+        data:
+          $ref: "#/components/schemas/UsageSummaryAvailableFieldsBody"
+      type: object
+    UsageSummaryAvailableFieldsType:
+      default: usage_summary_available_fields
+      description: Type of available-fields data.
+      enum:
+        - usage_summary_available_fields
+      type: string
+      x-enum-varnames:
+        - USAGE_SUMMARY_AVAILABLE_FIELDS
     UsageTimeSeriesObject:
       description: Usage timeseries data.
       properties:
@@ -174018,6 +174079,67 @@ paths:
         permissions:
           - usage_read
           - billing_read
+  /api/v2/usage/summary/available_fields:
+    get:
+      description: |-
+        List the field names returned by `GET /api/v1/usage/summary` at each of its
+        three response levels. Each list contains every key the data endpoint
+        emits—both typed fields declared in the OpenAPI spec and untyped keys
+        exposed through `additionalProperties` (the latter used for billing
+        dimensions and usage types added after the v1 schema freeze).
+
+        This endpoint is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/).
+      operationId: GetUsageSummaryAvailableFields
+      responses:
+        "200":
+          content:
+            application/json;datetime-format=rfc3339:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        date_fields:
+                          - agent_host_top99p
+                          - aws_host_top99p
+                          - ccm_anthropic_spend_last
+                        date_org_fields:
+                          - agent_host_top99p
+                          - aws_host_top99p
+                          - ccm_anthropic_spend_last
+                        response_fields:
+                          - agent_host_top99p_sum
+                          - aws_host_top99p_sum
+                          - ccm_anthropic_spend_last_sum
+                      id: all
+                      type: usage_summary_available_fields
+              schema:
+                $ref: "#/components/schemas/UsageSummaryAvailableFieldsResponse"
+          description: OK.
+        "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 available fields for usage summary
+      tags:
+        - Usage Metering
+      "x-permission":
+        operator: OR
+        permissions:
+          - usage_read
   /api/v2/usage/usage-attribution-types:
     get:
       description: |-

docs/datadog_api_client.v2.model.rst

@@ -42074,6 +42074,34 @@ datadog\_api\_client.v2.model.usage\_observability\_pipelines\_response module
    :members:
    :show-inheritance:
 
+datadog\_api\_client.v2.model.usage\_summary\_available\_fields\_attributes module
+----------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.usage_summary_available_fields_attributes
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.usage\_summary\_available\_fields\_body module
+----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.usage_summary_available_fields_body
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.usage\_summary\_available\_fields\_response module
+--------------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.usage_summary_available_fields_response
+   :members:
+   :show-inheritance:
+
+datadog\_api\_client.v2.model.usage\_summary\_available\_fields\_type module
+----------------------------------------------------------------------------
+
+.. automodule:: datadog_api_client.v2.model.usage_summary_available_fields_type
+   :members:
+   :show-inheritance:
+
 datadog\_api\_client.v2.model.usage\_time\_series\_object module
 ----------------------------------------------------------------
 

examples/v2/usage-metering/GetUsageSummaryAvailableFields.py

@@ -0,0 +1,13 @@
+"""
+Get available fields for usage summary returns "OK." response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.usage_metering_api import UsageMeteringApi
+
+configuration = Configuration()
+with ApiClient(configuration) as api_client:
+    api_instance = UsageMeteringApi(api_client)
+    response = api_instance.get_usage_summary_available_fields()
+
+    print(response)

examples/v2/usage-metering/GetUsageSummaryAvailableFields_2682263043.py

@@ -0,0 +1,13 @@
+"""
+Get available fields for usage summary returns "OK" response
+"""
+
+from datadog_api_client import ApiClient, Configuration
+from datadog_api_client.v2.api.usage_metering_api import UsageMeteringApi
+
+configuration = Configuration()
+with ApiClient(configuration) as api_client:
+    api_instance = UsageMeteringApi(api_client)
+    response = api_instance.get_usage_summary_available_fields()
+
+    print(response)

src/datadog_api_client/v1/api/usage_metering_api.py

@@ -2170,6 +2170,12 @@ def get_usage_summary(
 
         Get all usage across your account.
 
+        Newly added billing dimensions and usage types appear as untyped keys on the
+        ``additionalProperties`` map of ``UsageSummaryResponse`` , ``UsageSummaryDate`` , and
+        ``UsageSummaryDateOrg`` instead of as typed fields. Call
+        ``GET /api/v2/usage/summary/available_fields`` to enumerate every key returned
+        at each response level—both typed fields and ``additionalProperties`` keys.
+
         This endpoint is only accessible for `parent-level organizations <https://docs.datadoghq.com/account_management/multi_organization/>`_.
 
         :param start_month: Datetime in ISO-8601 format, UTC, precise to month: ``[YYYY-MM]`` for usage beginning in this month.

src/datadog_api_client/v1/model/usage_summary_date.py

@@ -787,7 +787,12 @@ def __init__(
         **kwargs,
     ):
         """
-        Response with hourly report of all data billed by Datadog all organizations.
+        Response with hourly report of all data billed by Datadog for all organizations.
+
+        Newly added billing dimensions and usage types appear as untyped keys on the
+        ``additionalProperties`` map instead of as typed fields. Call
+        ``GET /api/v2/usage/summary/available_fields`` to enumerate every key returned
+        at this response level—both typed fields and ``additionalProperties`` keys.
 
         :param agent_host_top99p: Shows the 99th percentile of all agent hosts over all hours in the current date for all organizations.
         :type agent_host_top99p: int, optional

src/datadog_api_client/v1/model/usage_summary_date_org.py

@@ -800,6 +800,11 @@ def __init__(
         """
         Global hourly report of all data billed by Datadog for a given organization.
 
+        Newly added billing dimensions and usage types appear as untyped keys on the
+        ``additionalProperties`` map instead of as typed fields. Call
+        ``GET /api/v2/usage/summary/available_fields`` to enumerate every key returned
+        at this response level—both typed fields and ``additionalProperties`` keys.
+
         :param account_name: The account name.
         :type account_name: str, optional
 

src/datadog_api_client/v1/model/usage_summary_response.py

@@ -822,7 +822,13 @@ def __init__(
         **kwargs,
     ):
         """
-        Response summarizing all usage aggregated across the months in the request for all organizations, and broken down by month and by organization.
+        Response summarizing all usage aggregated across the months in the request for
+        all organizations, and broken down by month and by organization.
+
+        Newly added billing dimensions and usage types appear as untyped keys on the
+        ``additionalProperties`` map instead of as typed fields. Call
+        ``GET /api/v2/usage/summary/available_fields`` to enumerate every key returned
+        at this response level—both typed fields and ``additionalProperties`` keys.
 
         :param agent_host_top99p_sum: Shows the 99th percentile of all agent hosts over all hours in the current month for all organizations.
         :type agent_host_top99p_sum: int, optional

src/datadog_api_client/v2/api/usage_metering_api.py

@@ -26,6 +26,7 @@
 from datadog_api_client.v2.model.usage_lambda_traced_invocations_response import UsageLambdaTracedInvocationsResponse
 from datadog_api_client.v2.model.usage_observability_pipelines_response import UsageObservabilityPipelinesResponse
 from datadog_api_client.v2.model.projected_cost_response import ProjectedCostResponse
+from datadog_api_client.v2.model.usage_summary_available_fields_response import UsageSummaryAvailableFieldsResponse
 from datadog_api_client.v2.model.usage_attribution_types_response import UsageAttributionTypesResponse
 
 
@@ -463,6 +464,22 @@ def __init__(self, api_client=None):
             api_client=api_client,
         )
 
+        self._get_usage_summary_available_fields_endpoint = _Endpoint(
+            settings={
+                "response_type": (UsageSummaryAvailableFieldsResponse,),
+                "auth": ["apiKeyAuth", "appKeyAuth", "AuthZ"],
+                "endpoint_path": "/api/v2/usage/summary/available_fields",
+                "operation_id": "get_usage_summary_available_fields",
+                "http_method": "GET",
+                "version": "v2",
+            },
+            params_map={},
+            headers_map={
+                "accept": ["application/json;datetime-format=rfc3339"],
+            },
+            api_client=api_client,
+        )
+
     def get_active_billing_dimensions(
         self,
     ) -> ActiveBillingDimensionsResponse:
@@ -908,3 +925,21 @@ def get_usage_observability_pipelines(
 
         warnings.warn("get_usage_observability_pipelines is deprecated", DeprecationWarning, stacklevel=2)
         return self._get_usage_observability_pipelines_endpoint.call_with_http_info(**kwargs)
+
+    def get_usage_summary_available_fields(
+        self,
+    ) -> UsageSummaryAvailableFieldsResponse:
+        """Get available fields for usage summary.
+
+        List the field names returned by ``GET /api/v1/usage/summary`` at each of its
+        three response levels. Each list contains every key the data endpoint
+        emits—both typed fields declared in the OpenAPI spec and untyped keys
+        exposed through ``additionalProperties`` (the latter used for billing
+        dimensions and usage types added after the v1 schema freeze).
+
+        This endpoint is only accessible for `parent-level organizations <https://docs.datadoghq.com/account_management/multi_organization/>`_.
+
+        :rtype: UsageSummaryAvailableFieldsResponse
+        """
+        kwargs: Dict[str, Any] = {}
+        return self._get_usage_summary_available_fields_endpoint.call_with_http_info(**kwargs)