diff --git a/.generator/schemas/v1/openapi.yaml b/.generator/schemas/v1/openapi.yaml index 7023d0d7bb9..7528268e99a 100644 --- a/.generator/schemas/v1/openapi.yaml +++ b/.generator/schemas/v1/openapi.yaml @@ -22719,10 +22719,10 @@ 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. + SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the + `additionalProperties` map instead of as typed fields. To enumerate every key at this + response level—both typed fields and `additionalProperties` keys—make a request to the + [Get available fields for usage summary API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields). properties: agent_host_top99p: description: Shows the 99th percentile of all agent hosts over all hours in the current date for all organizations. @@ -23948,10 +23948,10 @@ 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. + SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the + `additionalProperties` map instead of as typed fields. To enumerate every key at this + response level—both typed fields and `additionalProperties` keys—make a request to the + [Get available fields for usage summary API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields). properties: account_name: description: The account name. @@ -25196,10 +25196,10 @@ 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. + SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the + `additionalProperties` map instead of as typed fields. To enumerate every key at this + response level—both typed fields and `additionalProperties` keys—make a request to the + [Get available fields for usage summary API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields). properties: agent_host_top99p_sum: description: Shows the 99th percentile of all agent hosts over all hours in the current month for all organizations. @@ -42879,11 +42879,11 @@ paths: description: |- Get all usage across your account. - Newly added billing dimensions and usage types appear as untyped keys on the + SDK users only: 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. + `UsageSummaryDateOrg` instead of as typed fields. To enumerate every key at each + response level—both typed fields and `additionalProperties` keys—make a request to the + [Get available fields for usage summary API](https://docs.datadoghq.com/api/latest/usage-metering/#get-usage-summary-available-fields). This endpoint is only accessible for [parent-level organizations](https://docs.datadoghq.com/account_management/multi_organization/). operationId: GetUsageSummary @@ -43428,7 +43428,7 @@ paths: operator: OR permissions: - user_access_invite - "/api/v1/user/{user_handle}": + /api/v1/user/{user_handle}: delete: description: |- Delete a user from an organization. diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml index 6fb49c2d3a1..69249f3aa92 100644 --- a/.generator/schemas/v2/openapi.yaml +++ b/.generator/schemas/v2/openapi.yaml @@ -64631,7 +64631,8 @@ components: OrgConfigGetResponse: description: A response with a single Org Config. properties: - data: {$ref: "#/components/schemas/OrgConfigRead"} + data: + $ref: "#/components/schemas/OrgConfigRead" required: [data] type: object OrgConfigListResponse: @@ -64639,19 +64640,22 @@ components: properties: data: description: An array of Org Configs. - items: {$ref: "#/components/schemas/OrgConfigRead"} + items: + $ref: "#/components/schemas/OrgConfigRead" type: array required: [data] type: object OrgConfigRead: description: A single Org Config. properties: - attributes: {$ref: "#/components/schemas/OrgConfigReadAttributes"} + attributes: + $ref: "#/components/schemas/OrgConfigReadAttributes" id: description: A unique identifier for an Org Config. example: abcd1234 type: string - type: {$ref: "#/components/schemas/OrgConfigType"} + type: + $ref: "#/components/schemas/OrgConfigType" required: [id, type, attributes] type: object OrgConfigReadAttributes: @@ -64688,8 +64692,10 @@ components: OrgConfigWrite: description: An Org Config write operation. properties: - attributes: {$ref: "#/components/schemas/OrgConfigWriteAttributes"} - type: {$ref: "#/components/schemas/OrgConfigType"} + attributes: + $ref: "#/components/schemas/OrgConfigWriteAttributes" + type: + $ref: "#/components/schemas/OrgConfigType" required: [type, attributes] type: object OrgConfigWriteAttributes: @@ -64702,7 +64708,8 @@ components: OrgConfigWriteRequest: description: A request to update an Org Config. properties: - data: {$ref: "#/components/schemas/OrgConfigWrite"} + data: + $ref: "#/components/schemas/OrgConfigWrite" required: [data] type: object OrgConnection: @@ -102560,7 +102567,7 @@ paths: operator: OR permissions: - apps_datastore_manage - "/api/v2/actions-datastores/{datastore_id}": + /api/v2/actions-datastores/{datastore_id}: delete: description: Deletes a datastore by its unique identifier. operationId: DeleteDatastore @@ -102704,7 +102711,7 @@ paths: operator: OR permissions: - apps_datastore_manage - "/api/v2/actions-datastores/{datastore_id}/items": + /api/v2/actions-datastores/{datastore_id}/items: delete: description: Deletes an item from a datastore by its key. operationId: DeleteDatastoreItem @@ -102916,7 +102923,7 @@ paths: operator: OR permissions: - apps_datastore_write - "/api/v2/actions-datastores/{datastore_id}/items/bulk": + /api/v2/actions-datastores/{datastore_id}/items/bulk: delete: description: >- Deletes multiple items from a datastore by their keys in a single operation. @@ -105936,7 +105943,7 @@ paths: - apps_write - connections_resolve - workflows_run - "/api/v2/app-builder/apps/{app_id}": + /api/v2/app-builder/apps/{app_id}: delete: description: Delete a single app. This API requires a [registered application key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). Alternatively, you can configure these permissions [in the UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). operationId: DeleteApp @@ -106138,7 +106145,7 @@ paths: - apps_write - connections_resolve - workflows_run - "/api/v2/app-builder/apps/{app_id}/deployment": + /api/v2/app-builder/apps/{app_id}/deployment: delete: description: Unpublish an app, removing the live version of the app. Unpublishing creates a new instance of a `deployment` object on the app, with a nil `app_version_id` (`00000000-0000-0000-0000-000000000000`). The app can still be updated and published again in the future. This API requires a [registered application key](https://docs.datadoghq.com/api/latest/action-connection/#register-a-new-app-key). Alternatively, you can configure these permissions [in the UI](https://docs.datadoghq.com/account_management/api-app-keys/#actions-api-access). operationId: UnpublishApp @@ -106247,7 +106254,7 @@ paths: operator: OR permissions: - apps_write - "/api/v2/app-builder/apps/{app_id}/favorite": + /api/v2/app-builder/apps/{app_id}/favorite: patch: description: Add or remove an app from the current user's favorites. Favorited apps can be filtered for using the `filter[favorite]` query parameter on the [List Apps](https://docs.datadoghq.com/api/latest/app-builder/#list-apps) endpoint. operationId: UpdateAppFavorite @@ -106303,7 +106310,7 @@ paths: operator: OR permissions: - apps_run - "/api/v2/app-builder/apps/{app_id}/protection-level": + /api/v2/app-builder/apps/{app_id}/protection-level: patch: description: Update the publication protection level of an app. When set to `approval_required`, future publishes must go through an approval workflow before going live. operationId: UpdateProtectionLevel @@ -106377,7 +106384,7 @@ paths: operator: OR permissions: - apps_write - "/api/v2/app-builder/apps/{app_id}/publish-request": + /api/v2/app-builder/apps/{app_id}/publish-request: post: description: Create a publish request to ask for approval to publish an app whose protection level is `approval_required`. Publishing happens automatically once the request is approved by a user with the appropriate permissions. operationId: CreatePublishRequest @@ -106450,7 +106457,7 @@ paths: operator: OR permissions: - apps_write - "/api/v2/app-builder/apps/{app_id}/revert": + /api/v2/app-builder/apps/{app_id}/revert: post: description: Revert an app to a previous version. The version to revert to is selected through the `version` query parameter. The reverted version becomes the new latest version of the app. operationId: RevertApp @@ -106518,7 +106525,7 @@ paths: operator: OR permissions: - apps_write - "/api/v2/app-builder/apps/{app_id}/self-service": + /api/v2/app-builder/apps/{app_id}/self-service: patch: description: Enable or disable self-service for an app. Self-service apps can be discovered and run by users in your organization without explicit access being granted. operationId: UpdateAppSelfService @@ -106574,7 +106581,7 @@ paths: operator: OR permissions: - apps_write - "/api/v2/app-builder/apps/{app_id}/tags": + /api/v2/app-builder/apps/{app_id}/tags: patch: description: Replace the tags on an app. The provided list overwrites the existing tags entirely; tags not present in the request body are removed. operationId: UpdateAppTags @@ -106632,7 +106639,7 @@ paths: operator: OR permissions: - apps_write - "/api/v2/app-builder/apps/{app_id}/version-name": + /api/v2/app-builder/apps/{app_id}/version-name: patch: description: Assign a human-readable name to a specific version of an app. The version is selected through the `version` query parameter. operationId: UpdateAppVersionName @@ -106695,7 +106702,7 @@ paths: operator: OR permissions: - apps_write - "/api/v2/app-builder/apps/{app_id}/versions": + /api/v2/app-builder/apps/{app_id}/versions: get: description: List the versions of an app. This endpoint is paginated. operationId: ListAppVersions @@ -106775,7 +106782,7 @@ paths: permissions: - apps_run - connections_read - "/api/v2/app-builder/blueprint/{blueprint_id}": + /api/v2/app-builder/blueprint/{blueprint_id}: get: description: Retrieve an app blueprint by its ID. operationId: GetBlueprint @@ -106888,7 +106895,7 @@ paths: - apps_write - connections_read - connections_write - "/api/v2/app-builder/blueprints/integration-id/{integration_id}": + /api/v2/app-builder/blueprints/integration-id/{integration_id}: get: description: List app blueprints associated with a specific integration ID. operationId: GetBlueprintsByIntegrationId @@ -106939,7 +106946,7 @@ paths: - apps_write - connections_read - connections_write - "/api/v2/app-builder/blueprints/slugs/{slugs}": + /api/v2/app-builder/blueprints/slugs/{slugs}: get: description: Retrieve app blueprints by their slugs. operationId: GetBlueprintsBySlugs @@ -144794,12 +144801,17 @@ paths: value_type: bool id: abcd1234 type: org_configs - schema: {$ref: "#/components/schemas/OrgConfigListResponse"} + schema: + $ref: "#/components/schemas/OrgConfigListResponse" description: OK - "400": {$ref: "#/components/responses/BadRequestResponse"} - "401": {$ref: "#/components/responses/UnauthorizedResponse"} - "403": {$ref: "#/components/responses/ForbiddenResponse"} - "429": {$ref: "#/components/responses/TooManyRequestsResponse"} + "400": + $ref: "#/components/responses/BadRequestResponse" + "401": + $ref: "#/components/responses/UnauthorizedResponse" + "403": + $ref: "#/components/responses/ForbiddenResponse" + "429": + $ref: "#/components/responses/TooManyRequestsResponse" summary: List Org Configs tags: [Organizations] "x-permission": @@ -144809,7 +144821,8 @@ paths: get: description: Return the name, description, and value of a specific Org Config. operationId: GetOrgConfig - parameters: [$ref: "#/components/parameters/OrgConfigName"] + parameters: + - $ref: "#/components/parameters/OrgConfigName" responses: "200": content: @@ -144825,13 +144838,19 @@ paths: value_type: bool id: abcd1234 type: org_configs - schema: {$ref: "#/components/schemas/OrgConfigGetResponse"} + schema: + $ref: "#/components/schemas/OrgConfigGetResponse" description: OK - "400": {$ref: "#/components/responses/BadRequestResponse"} - "401": {$ref: "#/components/responses/UnauthorizedResponse"} - "403": {$ref: "#/components/responses/ForbiddenResponse"} - "404": {$ref: "#/components/responses/NotFoundResponse"} - "429": {$ref: "#/components/responses/TooManyRequestsResponse"} + "400": + $ref: "#/components/responses/BadRequestResponse" + "401": + $ref: "#/components/responses/UnauthorizedResponse" + "403": + $ref: "#/components/responses/ForbiddenResponse" + "404": + $ref: "#/components/responses/NotFoundResponse" + "429": + $ref: "#/components/responses/TooManyRequestsResponse" summary: Get a specific Org Config value tags: [Organizations] "x-permission": @@ -144840,7 +144859,8 @@ paths: patch: description: Update the value of a specific Org Config. operationId: UpdateOrgConfig - parameters: [$ref: "#/components/parameters/OrgConfigName"] + parameters: + - $ref: "#/components/parameters/OrgConfigName" requestBody: content: application/json: @@ -144851,7 +144871,8 @@ paths: attributes: value: UTC type: org_configs - schema: {$ref: "#/components/schemas/OrgConfigWriteRequest"} + schema: + $ref: "#/components/schemas/OrgConfigWriteRequest" required: true responses: "200": @@ -144868,13 +144889,19 @@ paths: value_type: bool id: abcd1234 type: org_configs - schema: {$ref: "#/components/schemas/OrgConfigGetResponse"} + schema: + $ref: "#/components/schemas/OrgConfigGetResponse" description: OK - "400": {$ref: "#/components/responses/BadRequestResponse"} - "401": {$ref: "#/components/responses/UnauthorizedResponse"} - "403": {$ref: "#/components/responses/ForbiddenResponse"} - "404": {$ref: "#/components/responses/NotFoundResponse"} - "429": {$ref: "#/components/responses/TooManyRequestsResponse"} + "400": + $ref: "#/components/responses/BadRequestResponse" + "401": + $ref: "#/components/responses/UnauthorizedResponse" + "403": + $ref: "#/components/responses/ForbiddenResponse" + "404": + $ref: "#/components/responses/NotFoundResponse" + "429": + $ref: "#/components/responses/TooManyRequestsResponse" summary: Update a specific Org Config tags: [Organizations] "x-permission": 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 43c0042b0f6..686dcbfbafb 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 @@ -7231,11 +7231,13 @@ public CompletableFuture getUsageSummaryAsync( /** * 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. + *

SDK users only: 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. To + * enumerate every key at each response level—both typed fields and additionalProperties + * keys—make a request to the Get + * available fields for usage summary API. * *

This endpoint is only accessible for parent-level diff --git a/src/main/java/com/datadog/api/client/v1/model/UsageSummaryDate.java b/src/main/java/com/datadog/api/client/v1/model/UsageSummaryDate.java index a57bd751726..ab29b6321a3 100644 --- a/src/main/java/com/datadog/api/client/v1/model/UsageSummaryDate.java +++ b/src/main/java/com/datadog/api/client/v1/model/UsageSummaryDate.java @@ -22,10 +22,12 @@ /** * 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. + *

SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the + * additionalProperties map instead of as typed fields. To enumerate every key at this + * response level—both typed fields and additionalProperties keys—make a request to the + * Get + * available fields for usage summary API. */ @JsonPropertyOrder({ UsageSummaryDate.JSON_PROPERTY_AGENT_HOST_TOP99P, diff --git a/src/main/java/com/datadog/api/client/v1/model/UsageSummaryDateOrg.java b/src/main/java/com/datadog/api/client/v1/model/UsageSummaryDateOrg.java index f2d924abf39..3903ba90da1 100644 --- a/src/main/java/com/datadog/api/client/v1/model/UsageSummaryDateOrg.java +++ b/src/main/java/com/datadog/api/client/v1/model/UsageSummaryDateOrg.java @@ -19,10 +19,12 @@ /** * 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. + *

SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the + * additionalProperties map instead of as typed fields. To enumerate every key at this + * response level—both typed fields and additionalProperties keys—make a request to the + * Get + * available fields for usage summary API. */ @JsonPropertyOrder({ UsageSummaryDateOrg.JSON_PROPERTY_ACCOUNT_NAME, diff --git a/src/main/java/com/datadog/api/client/v1/model/UsageSummaryResponse.java b/src/main/java/com/datadog/api/client/v1/model/UsageSummaryResponse.java index 0168918a32b..cbdc31d82c7 100644 --- a/src/main/java/com/datadog/api/client/v1/model/UsageSummaryResponse.java +++ b/src/main/java/com/datadog/api/client/v1/model/UsageSummaryResponse.java @@ -23,10 +23,12 @@ * 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. + *

SDK users only: Newly added billing dimensions and usage types appear as untyped keys on the + * additionalProperties map instead of as typed fields. To enumerate every key at this + * response level—both typed fields and additionalProperties keys—make a request to the + * Get + * available fields for usage summary API. */ @JsonPropertyOrder({ UsageSummaryResponse.JSON_PROPERTY_AGENT_HOST_TOP99P_SUM,