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

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: |-

api/datadogV1/api_usage_metering.go

@@ -3577,6 +3577,12 @@ func (r *GetUsageSummaryOptionalParameters) WithIncludeConnectedAccounts(include
 // GetUsageSummary Get usage across your account.
 // 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/).
 func (a *UsageMeteringApi) GetUsageSummary(ctx _context.Context, startMonth time.Time, o ...GetUsageSummaryOptionalParameters) (UsageSummaryResponse, *_nethttp.Response, error) {
 	var (

api/datadogV1/model_usage_summary_date.go

@@ -10,7 +10,12 @@ import (
 	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
 )
 
-// UsageSummaryDate Response with hourly report of all data billed by Datadog all organizations.
+// UsageSummaryDate 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.
 type UsageSummaryDate struct {
 	// Shows the 99th percentile of all agent hosts over all hours in the current date for all organizations.
 	AgentHostTop99p *int64 `json:"agent_host_top99p,omitempty"`

api/datadogV1/model_usage_summary_date_org.go

@@ -9,6 +9,11 @@ import (
 )
 
 // UsageSummaryDateOrg 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.
 type UsageSummaryDateOrg struct {
 	// The account name.
 	AccountName *string `json:"account_name,omitempty"`

api/datadogV1/model_usage_summary_response.go

@@ -10,7 +10,13 @@ import (
 	"github.com/DataDog/datadog-api-client-go/v2/api/datadog"
 )
 
-// UsageSummaryResponse Response summarizing all usage aggregated across the months in the request for all organizations, and broken down by month and by organization.
+// UsageSummaryResponse 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.
 type UsageSummaryResponse struct {
 	// Shows the 99th percentile of all agent hosts over all hours in the current month for all organizations.
 	AgentHostTop99pSum *int64 `json:"agent_host_top99p_sum,omitempty"`

api/datadogV2/api_usage_metering.go

@@ -1487,6 +1487,89 @@ func (a *UsageMeteringApi) GetUsageObservabilityPipelines(ctx _context.Context,
 	return localVarReturnValue, localVarHTTPResponse, nil
 }
 
+// GetUsageSummaryAvailableFields 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/).
+func (a *UsageMeteringApi) GetUsageSummaryAvailableFields(ctx _context.Context) (UsageSummaryAvailableFieldsResponse, *_nethttp.Response, error) {
+	var (
+		localVarHTTPMethod  = _nethttp.MethodGet
+		localVarPostBody    interface{}
+		localVarReturnValue UsageSummaryAvailableFieldsResponse
+	)
+
+	localBasePath, err := a.Client.Cfg.ServerURLWithContext(ctx, "v2.UsageMeteringApi.GetUsageSummaryAvailableFields")
+	if err != nil {
+		return localVarReturnValue, nil, datadog.GenericOpenAPIError{ErrorMessage: err.Error()}
+	}
+
+	localVarPath := localBasePath + "/api/v2/usage/summary/available_fields"
+
+	localVarHeaderParams := make(map[string]string)
+	localVarQueryParams := _neturl.Values{}
+	localVarFormParams := _neturl.Values{}
+	localVarHeaderParams["Accept"] = "application/json;datetime-format=rfc3339"
+
+	if a.Client.Cfg.DelegatedTokenConfig != nil {
+		err = datadog.UseDelegatedTokenAuth(ctx, &localVarHeaderParams, a.Client.Cfg.DelegatedTokenConfig)
+		if err != nil {
+			return localVarReturnValue, nil, err
+		}
+	} else {
+		datadog.SetAuthKeys(
+			ctx,
+			&localVarHeaderParams,
+			[2]string{"apiKeyAuth", "DD-API-KEY"},
+			[2]string{"appKeyAuth", "DD-APPLICATION-KEY"},
+		)
+	}
+	req, err := a.Client.PrepareRequest(ctx, localVarPath, localVarHTTPMethod, localVarPostBody, localVarHeaderParams, localVarQueryParams, localVarFormParams, nil)
+	if err != nil {
+		return localVarReturnValue, nil, err
+	}
+
+	localVarHTTPResponse, err := a.Client.CallAPI(req)
+	if err != nil || localVarHTTPResponse == nil {
+		return localVarReturnValue, localVarHTTPResponse, err
+	}
+
+	localVarBody, err := datadog.ReadBody(localVarHTTPResponse)
+	if err != nil {
+		return localVarReturnValue, localVarHTTPResponse, err
+	}
+
+	if localVarHTTPResponse.StatusCode >= 300 {
+		newErr := datadog.GenericOpenAPIError{
+			ErrorBody:    localVarBody,
+			ErrorMessage: localVarHTTPResponse.Status,
+		}
+		if localVarHTTPResponse.StatusCode == 403 || localVarHTTPResponse.StatusCode == 429 {
+			var v APIErrorResponse
+			err = a.Client.Decode(&v, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
+			if err != nil {
+				return localVarReturnValue, localVarHTTPResponse, newErr
+			}
+			newErr.ErrorModel = v
+		}
+		return localVarReturnValue, localVarHTTPResponse, newErr
+	}
+
+	err = a.Client.Decode(&localVarReturnValue, localVarBody, localVarHTTPResponse.Header.Get("Content-Type"))
+	if err != nil {
+		newErr := datadog.GenericOpenAPIError{
+			ErrorBody:    localVarBody,
+			ErrorMessage: err.Error(),
+		}
+		return localVarReturnValue, localVarHTTPResponse, newErr
+	}
+
+	return localVarReturnValue, localVarHTTPResponse, nil
+}
+
 // NewUsageMeteringApi Returns NewUsageMeteringApi.
 func NewUsageMeteringApi(client *datadog.APIClient) *UsageMeteringApi {
 	return &UsageMeteringApi{

api/datadogV2/doc.go

@@ -1229,6 +1229,7 @@
 //   - [UsageMeteringApi.GetUsageAttributionTypes]
 //   - [UsageMeteringApi.GetUsageLambdaTracedInvocations]
 //   - [UsageMeteringApi.GetUsageObservabilityPipelines]
+//   - [UsageMeteringApi.GetUsageSummaryAvailableFields]
 //   - [UsersApi.AnonymizeUsers]
 //   - [UsersApi.CreateUser]
 //   - [UsersApi.DeleteUserInvitations]