Clarify monthly usage attribution month restriction

.generator/schemas/v1/openapi.yaml

@@ -44106,6 +44106,10 @@ paths:
 
         **Note**: All `estimated_*` usage types will be deprecated on February 1, 2027.
 
+        Each request returns usage for the month specified by `start_month`. If `end_month` is omitted
+        or differs from `start_month`, it is treated as equal to `start_month`.
+        To retrieve multiple months, make a separate request for each month.
+
         This API endpoint is paginated. To make sure you receive all records, check if the value of `next_record_id` is
         set in the response. If it is, make another request and pass `next_record_id` as a parameter.
         Pseudo code example:
@@ -44122,15 +44126,18 @@ paths:
       operationId: GetMonthlyUsageAttribution
       parameters:
         - description: |-
-            Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for usage beginning in this month.
-            Maximum of 15 months ago.
+            Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]` for the month to retrieve.
+            Maximum of 15 months ago. Only one month is supported per request.
           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 usage ending this month."
+        - description: |-
+            Datetime in ISO-8601 format, UTC, precise to month: `[YYYY-MM]`.
+            If omitted or different from `start_month`, it is treated as equal to `start_month`.
+            Only usage for `start_month` is returned; this parameter does not extend the requested range.
           in: query
           name: end_month
           required: false

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

@@ -1360,8 +1360,10 @@ public static class GetMonthlyUsageAttributionOptionalParameters {
     /**
      * Set endMonth.
      *
-     * @param endMonth Datetime in ISO-8601 format, UTC, precise to month: <code>[YYYY-MM]</code>
-     *     for usage ending this month. (optional)
+     * @param endMonth Datetime in ISO-8601 format, UTC, precise to month: <code>[YYYY-MM]</code>.
+     *     If omitted or different from <code>start_month</code>, it is treated as equal to <code>
+     *     start_month</code>. Only usage for <code>start_month</code> is returned; this parameter
+     *     does not extend the requested range. (optional)
      * @return GetMonthlyUsageAttributionOptionalParameters
      */
     public GetMonthlyUsageAttributionOptionalParameters endMonth(OffsetDateTime endMonth) {
@@ -1444,7 +1446,8 @@ public GetMonthlyUsageAttributionOptionalParameters includeDescendants(
    * <p>See {@link #getMonthlyUsageAttributionWithHttpInfo}.
    *
    * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: <code>[YYYY-MM]</code>
-   *     for usage beginning in this month. Maximum of 15 months ago. (required)
+   *     for the month to retrieve. Maximum of 15 months ago. Only one month is supported per
+   *     request. (required)
    * @param fields Comma-separated list of usage types to return, or <code>*</code> for all usage
    *     types. Usage types are in the format <code>&lt;usage_type&gt;_usage</code> and <code>
    *     &lt;usage_type&gt;_percentage</code>. Example: <code>infra_host_usage,infra_host_percentage
@@ -1469,7 +1472,8 @@ startMonth, fields, new GetMonthlyUsageAttributionOptionalParameters())
    * <p>See {@link #getMonthlyUsageAttributionWithHttpInfoAsync}.
    *
    * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: <code>[YYYY-MM]</code>
-   *     for usage beginning in this month. Maximum of 15 months ago. (required)
+   *     for the month to retrieve. Maximum of 15 months ago. Only one month is supported per
+   *     request. (required)
    * @param fields Comma-separated list of usage types to return, or <code>*</code> for all usage
    *     types. Usage types are in the format <code>&lt;usage_type&gt;_usage</code> and <code>
    *     &lt;usage_type&gt;_percentage</code>. Example: <code>infra_host_usage,infra_host_percentage
@@ -1495,7 +1499,8 @@ startMonth, fields, new GetMonthlyUsageAttributionOptionalParameters())
    * <p>See {@link #getMonthlyUsageAttributionWithHttpInfo}.
    *
    * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: <code>[YYYY-MM]</code>
-   *     for usage beginning in this month. Maximum of 15 months ago. (required)
+   *     for the month to retrieve. Maximum of 15 months ago. Only one month is supported per
+   *     request. (required)
    * @param fields Comma-separated list of usage types to return, or <code>*</code> for all usage
    *     types. Usage types are in the format <code>&lt;usage_type&gt;_usage</code> and <code>
    *     &lt;usage_type&gt;_percentage</code>. Example: <code>infra_host_usage,infra_host_percentage
@@ -1521,7 +1526,8 @@ public MonthlyUsageAttributionResponse getMonthlyUsageAttribution(
    * <p>See {@link #getMonthlyUsageAttributionWithHttpInfoAsync}.
    *
    * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: <code>[YYYY-MM]</code>
-   *     for usage beginning in this month. Maximum of 15 months ago. (required)
+   *     for the month to retrieve. Maximum of 15 months ago. Only one month is supported per
+   *     request. (required)
    * @param fields Comma-separated list of usage types to return, or <code>*</code> for all usage
    *     types. Usage types are in the format <code>&lt;usage_type&gt;_usage</code> and <code>
    *     &lt;usage_type&gt;_percentage</code>. Example: <code>infra_host_usage,infra_host_percentage
@@ -1549,6 +1555,10 @@ public CompletableFuture<MonthlyUsageAttributionResponse> getMonthlyUsageAttribu
    * <p><strong>Note</strong>: All <code>estimated_*</code> usage types will be deprecated on
    * February 1, 2027.
    *
+   * <p>Each request returns usage for the month specified by <code>start_month</code>. If <code>
+   * end_month</code> is omitted or differs from <code>start_month</code>, it is treated as equal to
+   * <code>start_month</code>. To retrieve multiple months, make a separate request for each month.
+   *
    * <p>This API endpoint is paginated. To make sure you receive all records, check if the value of
    * <code>next_record_id</code> is set in the response. If it is, make another request and pass
    * <code>next_record_id</code> as a parameter. Pseudo code example:
@@ -1562,7 +1572,8 @@ public CompletableFuture<MonthlyUsageAttributionResponse> getMonthlyUsageAttribu
    * END</code>
    *
    * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: <code>[YYYY-MM]</code>
-   *     for usage beginning in this month. Maximum of 15 months ago. (required)
+   *     for the month to retrieve. Maximum of 15 months ago. Only one month is supported per
+   *     request. (required)
    * @param fields Comma-separated list of usage types to return, or <code>*</code> for all usage
    *     types. Usage types are in the format <code>&lt;usage_type&gt;_usage</code> and <code>
    *     &lt;usage_type&gt;_percentage</code>. Example: <code>infra_host_usage,infra_host_percentage
@@ -1650,7 +1661,8 @@ public ApiResponse<MonthlyUsageAttributionResponse> getMonthlyUsageAttributionWi
    * <p>See {@link #getMonthlyUsageAttributionWithHttpInfo}.
    *
    * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: <code>[YYYY-MM]</code>
-   *     for usage beginning in this month. Maximum of 15 months ago. (required)
+   *     for the month to retrieve. Maximum of 15 months ago. Only one month is supported per
+   *     request. (required)
    * @param fields Comma-separated list of usage types to return, or <code>*</code> for all usage
    *     types. Usage types are in the format <code>&lt;usage_type&gt;_usage</code> and <code>
    *     &lt;usage_type&gt;_percentage</code>. Example: <code>infra_host_usage,infra_host_percentage