Regenerate client from commit 1a314fa of spec repo

Author: ci.datadog-api-spec

.generator/schemas/v1/openapi.yaml

@@ -22813,10 +22813,11 @@ components:
       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.
+        For SDK users only: all fields at this response level are accessible through the
+        `additionalProperties` map. Existing typed-field getters are unchanged. New billing
+        dimensions will not have typed-field getters. Use
+        [Get available fields for usage summary](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields)
+        to enumerate every available key.
       properties:
         agent_host_top99p:
           description: Shows the 99th percentile of all agent hosts over all hours in the current date for all organizations.
@@ -24115,10 +24116,11 @@ components:
       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.
+        For SDK users only: all fields at this response level are accessible through the
+        `additionalProperties` map. Existing typed-field getters are unchanged. New billing
+        dimensions will not have typed-field getters. Use
+        [Get available fields for usage summary](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields)
+        to enumerate every available key.
       properties:
         account_name:
           description: The account name.
@@ -25436,10 +25438,11 @@ components:
         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.
+        For SDK users only: all fields at this response level are accessible through the
+        `additionalProperties` map. Existing typed-field getters are unchanged. New billing
+        dimensions will not have typed-field getters. Use
+        [Get available fields for usage summary](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields)
+        to enumerate every available key.
       properties:
         agent_host_top99p_sum:
           description: Shows the 99th percentile of all agent hosts over all hours in the current month for all organizations.
@@ -43215,11 +43218,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.
+        For SDK users only: all fields on `UsageSummaryResponse`, `UsageSummaryDate`, and
+        `UsageSummaryDateOrg` are accessible through each object's `additionalProperties` map.
+        Existing typed-field getters are unchanged. New billing dimensions will not have
+        typed-field getters. Use
+        [Get available fields for usage summary](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields)
+        to enumerate every available key at each response level.
 
         This endpoint is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/).
       operationId: GetUsageSummary

.generator/schemas/v2/openapi.yaml

@@ -187306,6 +187306,37 @@ paths:
         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/).
+
+        Go example:
+
+        ```go
+        fields, _, err := api.GetUsageSummaryAvailableFields(ctx)
+        attr := fields.Data.GetAttributes()
+
+        // resp is the *UsageSummaryResponse returned by api.GetUsageSummary(ctx, ...)
+        // Layer 1: UsageSummaryResponse
+        for _, key := range attr.GetResponseFields() {
+            if val, ok := resp.AdditionalProperties[key]; ok {
+                fmt.Println(key, val.(json.Number))
+            }
+        }
+        // Layer 2: UsageSummaryDate (per month)
+        for _, date := range resp.GetUsage() {
+            for _, key := range attr.GetDateFields() {
+                if val, ok := date.AdditionalProperties[key]; ok {
+                    fmt.Println(key, val.(json.Number))
+                }
+            }
+            // Layer 3: UsageSummaryDateOrg (per org per month)
+            for _, org := range date.GetOrgs() {
+                for _, key := range attr.GetDateOrgFields() {
+                    if val, ok := org.AdditionalProperties[key]; ok {
+                        fmt.Println(key, val.(json.Number))
+                    }
+                }
+            }
+        }
+        ```
       operationId: GetUsageSummaryAvailableFields
       responses:
         "200":

src/main/java/com/datadog/api/client/v1/api/UsageMeteringApi.java

@@ -7231,11 +7231,12 @@ public CompletableFuture<UsageSummaryResponse> getUsageSummaryAsync(
   /**
    * Get all usage across your account.
    *
-   * <p>Newly added billing dimensions and usage types appear as untyped keys on the <code>
-   * additionalProperties</code> map of <code>UsageSummaryResponse</code>, <code>UsageSummaryDate
-   * </code>, and <code>UsageSummaryDateOrg</code> instead of as typed fields. Call <code>
-   * GET /api/v2/usage/summary/available_fields</code> to enumerate every key returned at each
-   * response level—both typed fields and <code>additionalProperties</code> keys.
+   * <p>For SDK users only: all fields on <code>UsageSummaryResponse</code>, <code>UsageSummaryDate
+   * </code>, and <code>UsageSummaryDateOrg</code> are accessible through each object's <code>
+   * additionalProperties</code> map. Existing typed-field getters are unchanged. New billing
+   * dimensions will not have typed-field getters. Use <a
+   * href="https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields">Get
+   * available fields for usage summary</a> to enumerate every available key at each response level.
    *
    * <p>This endpoint is only accessible for <a
    * href="https://docs.datadoghq.com/account_management/multi_organization/">parent-level

src/main/java/com/datadog/api/client/v1/model/UsageSummaryDate.java

@@ -22,10 +22,11 @@
 /**
  * Response with hourly report of all data billed by Datadog for all organizations.
  *
- * <p>Newly added billing dimensions and usage types appear as untyped keys on the <code>
- * additionalProperties</code> map instead of as typed fields. Call <code>
- * GET /api/v2/usage/summary/available_fields</code> to enumerate every key returned at this
- * response level—both typed fields and <code>additionalProperties</code> keys.
+ * <p>For SDK users only: all fields at this response level are accessible through the <code>
+ * additionalProperties</code> map. Existing typed-field getters are unchanged. New billing
+ * dimensions will not have typed-field getters. Use <a
+ * href="https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields">Get
+ * available fields for usage summary</a> to enumerate every available key.
  */
 @JsonPropertyOrder({
   UsageSummaryDate.JSON_PROPERTY_AGENT_HOST_TOP99P,

src/main/java/com/datadog/api/client/v1/model/UsageSummaryDateOrg.java

@@ -19,10 +19,11 @@
 /**
  * Global hourly report of all data billed by Datadog for a given organization.
  *
- * <p>Newly added billing dimensions and usage types appear as untyped keys on the <code>
- * additionalProperties</code> map instead of as typed fields. Call <code>
- * GET /api/v2/usage/summary/available_fields</code> to enumerate every key returned at this
- * response level—both typed fields and <code>additionalProperties</code> keys.
+ * <p>For SDK users only: all fields at this response level are accessible through the <code>
+ * additionalProperties</code> map. Existing typed-field getters are unchanged. New billing
+ * dimensions will not have typed-field getters. Use <a
+ * href="https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields">Get
+ * available fields for usage summary</a> to enumerate every available key.
  */
 @JsonPropertyOrder({
   UsageSummaryDateOrg.JSON_PROPERTY_ACCOUNT_NAME,

src/main/java/com/datadog/api/client/v1/model/UsageSummaryResponse.java

@@ -23,10 +23,11 @@
  * Response summarizing all usage aggregated across the months in the request for all organizations,
  * and broken down by month and by organization.
  *
- * <p>Newly added billing dimensions and usage types appear as untyped keys on the <code>
- * additionalProperties</code> map instead of as typed fields. Call <code>
- * GET /api/v2/usage/summary/available_fields</code> to enumerate every key returned at this
- * response level—both typed fields and <code>additionalProperties</code> keys.
+ * <p>For SDK users only: all fields at this response level are accessible through the <code>
+ * additionalProperties</code> map. Existing typed-field getters are unchanged. New billing
+ * dimensions will not have typed-field getters. Use <a
+ * href="https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields">Get
+ * available fields for usage summary</a> to enumerate every available key.
  */
 @JsonPropertyOrder({
   UsageSummaryResponse.JSON_PROPERTY_AGENT_HOST_TOP99P_SUM,

src/main/java/com/datadog/api/client/v2/api/UsageMeteringApi.java

@@ -3066,6 +3066,20 @@ public UsageSummaryAvailableFieldsResponse getUsageSummaryAvailableFields() thro
    * href="https://docs.datadoghq.com/account_management/multi_organization/">parent-level
    * organizations</a>.
    *
+   * <p>Go example:
+   *
+   * <p>```go fields, _, err := api.GetUsageSummaryAvailableFields(ctx) attr :=
+   * fields.Data.GetAttributes()
+   *
+   * <p>// resp is the *UsageSummaryResponse returned by api.GetUsageSummary(ctx, ...) // Layer 1:
+   * UsageSummaryResponse for <em>, key := range attr.GetResponseFields() { if val, ok :=
+   * resp.AdditionalProperties[key]; ok { fmt.Println(key, val.(json.Number)) } } // Layer 2:
+   * UsageSummaryDate (per month) for </em>, date := range resp.GetUsage() { for <em>, key := range
+   * attr.GetDateFields() { if val, ok := date.AdditionalProperties[key]; ok { fmt.Println(key,
+   * val.(json.Number)) } } // Layer 3: UsageSummaryDateOrg (per org per month) for </em>, org :=
+   * range date.GetOrgs() { for _, key := range attr.GetDateOrgFields() { if val, ok :=
+   * org.AdditionalProperties[key]; ok { fmt.Println(key, val.(json.Number)) } } } } ```
+   *
    * @return ApiResponse&lt;UsageSummaryAvailableFieldsResponse&gt;
    * @throws ApiException if fails to make API call
    * @http.response.details