fix(aws): mark v1 endpoints which have v2 replacement as deprecated (#2908)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v1/openapi.yaml

@@ -64,12 +64,20 @@ components:
           additionalProperties:
             description: A list of additional properties.
             type: boolean
-          description: 'An object, (in the form `{"namespace1":true/false, "namespace2":true/false}`),
+          description: 'An object (in the form `{"namespace1":true/false, "namespace2":true/false}`)
+            containing user-supplied overrides
 
-            that enables or disables metric collection for specific AWS namespaces
-            for this
+            for AWS namespace metric collection. **Important**: This field only contains
+            namespaces explicitly configured through API calls,
 
-            AWS account only.'
+            not the comprehensive enabled or disabled status of all namespaces. If
+            a namespace is absent from this field, it uses Datadog''s
+
+            internal defaults (all namespaces enabled by default, except `AWS/SQS`,
+            `AWS/ElasticMapReduce`, and `AWS/Usage`).
+
+            For a complete view of all namespace statuses, use the V2 AWS Integration
+            API instead.'
           example:
             auto_scaling: false
             opswork: false
@@ -28067,8 +28075,9 @@ paths:
   /api/v1/integration/aws:
     delete:
       deprecated: true
-      description: Delete a Datadog-AWS integration matching the specified `account_id`
-        and `role_name parameters`.
+      description: '**This endpoint is deprecated - use the V2 endpoints instead.**
+        Delete a Datadog-AWS integration matching the specified `account_id` and `role_name
+        parameters`.'
       operationId: DeleteAWSAccount
       requestBody:
         content:
@@ -28114,7 +28123,8 @@ paths:
         - aws_configurations_manage
     get:
       deprecated: true
-      description: List all Datadog-AWS integrations available in your Datadog organization.
+      description: '**This endpoint is deprecated - use the V2 endpoints instead.**
+        List all Datadog-AWS integrations available in your Datadog organization.'
       operationId: ListAWSAccounts
       parameters:
       - description: Only return AWS accounts that matches this `account_id`.
@@ -28165,7 +28175,8 @@ paths:
         - aws_configuration_read
     post:
       deprecated: true
-      description: 'Create a Datadog-Amazon Web Services integration.
+      description: '"**This endpoint is deprecated - use the V2 endpoints instead.**
+        Create a Datadog-Amazon Web Services integration.
 
         Using the `POST` method updates your integration configuration
 
@@ -28217,7 +28228,8 @@ paths:
         - aws_configurations_manage
     put:
       deprecated: true
-      description: Update a Datadog-Amazon Web Services integration.
+      description: '**This endpoint is deprecated - use the V2 endpoints instead.**
+        Update a Datadog-Amazon Web Services integration.'
       operationId: UpdateAWSAccount
       parameters:
       - description: Only return AWS accounts that matches this `account_id`.
@@ -28287,8 +28299,9 @@ paths:
   /api/v1/integration/aws/available_namespace_rules:
     get:
       deprecated: true
-      description: List all namespace rules for a given Datadog-AWS integration. This
-        endpoint takes no arguments.
+      description: '**This endpoint is deprecated - use the V2 endpoints instead.**
+        List all namespace rules for a given Datadog-AWS integration. This endpoint
+        takes no arguments.'
       operationId: ListAvailableAWSNamespaces
       responses:
         '200':
@@ -28563,8 +28576,8 @@ paths:
   /api/v1/integration/aws/generate_new_external_id:
     put:
       deprecated: true
-      description: Generate a new AWS external ID for a given AWS account ID and role
-        name pair.
+      description: '**This endpoint is deprecated - use the V2 endpoints instead.**
+        Generate a new AWS external ID for a given AWS account ID and role name pair.'
       operationId: CreateNewAWSExternalID
       requestBody:
         content:
@@ -28791,9 +28804,10 @@ paths:
   /api/v1/integration/aws/logs/services:
     get:
       deprecated: true
-      description: Get the list of current AWS services that Datadog offers automatic
-        log collection. Use returned service IDs with the services parameter for the
-        Enable an AWS service log collection API endpoint.
+      description: '**This endpoint is deprecated - use the V2 endpoint instead.**
+        Get the list of current AWS services that Datadog offers automatic log collection.
+        Use returned service IDs with the services parameter for the Enable an AWS
+        service log collection API endpoint.'
       operationId: ListAWSLogsServices
       responses:
         '200':

services/aws_integration/src/v1/AWSIntegrationApi.ts

@@ -1497,7 +1497,7 @@ export class AWSIntegrationApi {
   }
 
   /**
-   * Create a Datadog-Amazon Web Services integration.
+   * "**This endpoint is deprecated - use the V2 endpoints instead.** Create a Datadog-Amazon Web Services integration.
    * Using the `POST` method updates your integration configuration
    * by adding your new configuration to the existing one in your Datadog organization.
    * A unique AWS Account ID for role based authentication.
@@ -1563,7 +1563,7 @@ export class AWSIntegrationApi {
   }
 
   /**
-   * Generate a new AWS external ID for a given AWS account ID and role name pair.
+   * **This endpoint is deprecated - use the V2 endpoints instead.** Generate a new AWS external ID for a given AWS account ID and role name pair.
    * @param param The request object
    */
   public createNewAWSExternalID(
@@ -1584,7 +1584,7 @@ export class AWSIntegrationApi {
   }
 
   /**
-   * Delete a Datadog-AWS integration matching the specified `account_id` and `role_name parameters`.
+   * **This endpoint is deprecated - use the V2 endpoints instead.** Delete a Datadog-AWS integration matching the specified `account_id` and `role_name parameters`.
    * @param param The request object
    */
   public deleteAWSAccount(
@@ -1647,7 +1647,7 @@ export class AWSIntegrationApi {
   }
 
   /**
-   * List all namespace rules for a given Datadog-AWS integration. This endpoint takes no arguments.
+   * **This endpoint is deprecated - use the V2 endpoints instead.** List all namespace rules for a given Datadog-AWS integration. This endpoint takes no arguments.
    * @param param The request object
    */
   public listAvailableAWSNamespaces(
@@ -1667,7 +1667,7 @@ export class AWSIntegrationApi {
   }
 
   /**
-   * List all Datadog-AWS integrations available in your Datadog organization.
+   * **This endpoint is deprecated - use the V2 endpoints instead.** List all Datadog-AWS integrations available in your Datadog organization.
    * @param param The request object
    */
   public listAWSAccounts(
@@ -1731,7 +1731,7 @@ export class AWSIntegrationApi {
   }
 
   /**
-   * Update a Datadog-Amazon Web Services integration.
+   * **This endpoint is deprecated - use the V2 endpoints instead.** Update a Datadog-Amazon Web Services integration.
    * @param param The request object
    */
   public updateAWSAccount(

services/aws_integration/src/v1/models/AWSAccount.ts

@@ -13,9 +13,11 @@ export class AWSAccount {
    */
   "accountId"?: string;
   /**
-   * An object, (in the form `{"namespace1":true/false, "namespace2":true/false}`),
-   * that enables or disables metric collection for specific AWS namespaces for this
-   * AWS account only.
+   * An object (in the form `{"namespace1":true/false, "namespace2":true/false}`) containing user-supplied overrides
+   * for AWS namespace metric collection. **Important**: This field only contains namespaces explicitly configured through API calls,
+   * not the comprehensive enabled or disabled status of all namespaces. If a namespace is absent from this field, it uses Datadog's
+   * internal defaults (all namespaces enabled by default, except `AWS/SQS`, `AWS/ElasticMapReduce`, and `AWS/Usage`).
+   * For a complete view of all namespace statuses, use the V2 AWS Integration API instead.
    */
   "accountSpecificNamespaceRules"?: { [key: string]: boolean };
   /**

services/aws_logs_integration/src/v1/AWSLogsIntegrationApi.ts

@@ -978,7 +978,7 @@ export class AWSLogsIntegrationApi {
   }
 
   /**
-   * Get the list of current AWS services that Datadog offers automatic log collection. Use returned service IDs with the services parameter for the Enable an AWS service log collection API endpoint.
+   * **This endpoint is deprecated - use the V2 endpoint instead.** Get the list of current AWS services that Datadog offers automatic log collection. Use returned service IDs with the services parameter for the Enable an AWS service log collection API endpoint.
    * @param param The request object
    */
   public listAWSLogsServices(