diff --git a/.generator/schemas/v1/openapi.yaml b/.generator/schemas/v1/openapi.yaml index 3f09c0483c4..62832808c87 100644 --- a/.generator/schemas/v1/openapi.yaml +++ b/.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 diff --git a/src/main/java/com/datadog/api/client/v1/api/UsageMeteringApi.java b/src/main/java/com/datadog/api/client/v1/api/UsageMeteringApi.java index d78ae9a7dbb..05f22ac747a 100644 --- a/src/main/java/com/datadog/api/client/v1/api/UsageMeteringApi.java +++ b/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: [YYYY-MM] - * for usage ending this month. (optional) + * @param endMonth 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. (optional) * @return GetMonthlyUsageAttributionOptionalParameters */ public GetMonthlyUsageAttributionOptionalParameters endMonth(OffsetDateTime endMonth) { @@ -1444,7 +1446,8 @@ public GetMonthlyUsageAttributionOptionalParameters includeDescendants( *

See {@link #getMonthlyUsageAttributionWithHttpInfo}. * * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] - * 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 * for all usage * types. Usage types are in the format <usage_type>_usage and * <usage_type>_percentage. Example: infra_host_usage,infra_host_percentage @@ -1469,7 +1472,8 @@ startMonth, fields, new GetMonthlyUsageAttributionOptionalParameters()) *

See {@link #getMonthlyUsageAttributionWithHttpInfoAsync}. * * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] - * 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 * for all usage * types. Usage types are in the format <usage_type>_usage and * <usage_type>_percentage. Example: infra_host_usage,infra_host_percentage @@ -1495,7 +1499,8 @@ startMonth, fields, new GetMonthlyUsageAttributionOptionalParameters()) *

See {@link #getMonthlyUsageAttributionWithHttpInfo}. * * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] - * 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 * for all usage * types. Usage types are in the format <usage_type>_usage and * <usage_type>_percentage. Example: infra_host_usage,infra_host_percentage @@ -1521,7 +1526,8 @@ public MonthlyUsageAttributionResponse getMonthlyUsageAttribution( *

See {@link #getMonthlyUsageAttributionWithHttpInfoAsync}. * * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] - * 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 * for all usage * types. Usage types are in the format <usage_type>_usage and * <usage_type>_percentage. Example: infra_host_usage,infra_host_percentage @@ -1549,6 +1555,10 @@ public CompletableFuture getMonthlyUsageAttribu *

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: @@ -1562,7 +1572,8 @@ public CompletableFuture getMonthlyUsageAttribu * END * * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] - * 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 * for all usage * types. Usage types are in the format <usage_type>_usage and * <usage_type>_percentage. Example: infra_host_usage,infra_host_percentage @@ -1650,7 +1661,8 @@ public ApiResponse getMonthlyUsageAttributionWi *

See {@link #getMonthlyUsageAttributionWithHttpInfo}. * * @param startMonth Datetime in ISO-8601 format, UTC, precise to month: [YYYY-MM] - * 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 * for all usage * types. Usage types are in the format <usage_type>_usage and * <usage_type>_percentage. Example: infra_host_usage,infra_host_percentage