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

Co-authored-by: ci.datadog-api-spec <[email protected]>

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':

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

@@ -89,9 +89,10 @@ public CompletableFuture<AWSAccountCreateResponse> createAWSAccountAsync(AWSAcco
   }
 
   /**
-   * Create a Datadog-Amazon Web Services integration. Using the <code>POST</code> 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.
+   * "<strong>This endpoint is deprecated - use the V2 endpoints instead.</strong> Create a
+   * Datadog-Amazon Web Services integration. Using the <code>POST</code> 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.
    *
    * @param body AWS Request Object (required)
    * @return ApiResponse&lt;AWSAccountCreateResponse&gt;
@@ -539,7 +540,8 @@ public CompletableFuture<AWSAccountCreateResponse> createNewAWSExternalIDAsync(A
   }
 
   /**
-   * Generate a new AWS external ID for a given AWS account ID and role name pair.
+   * <strong>This endpoint is deprecated - use the V2 endpoints instead.</strong> Generate a new AWS
+   * external ID for a given AWS account ID and role name pair.
    *
    * @param body Your Datadog role delegation name. For more information about your AWS account Role
    *     name, see the <a
@@ -685,7 +687,8 @@ public CompletableFuture<Object> deleteAWSAccountAsync(AWSAccountDeleteRequest b
   }
 
   /**
-   * Delete a Datadog-AWS integration matching the specified <code>account_id</code> and <code>
+   * <strong>This endpoint is deprecated - use the V2 endpoints instead.</strong> Delete a
+   * Datadog-AWS integration matching the specified <code>account_id</code> and <code>
    * role_name parameters</code>.
    *
    * @param body AWS request object (required)
@@ -1118,7 +1121,8 @@ public CompletableFuture<List<String>> listAvailableAWSNamespacesAsync() {
   }
 
   /**
-   * List all namespace rules for a given Datadog-AWS integration. This endpoint takes no arguments.
+   * <strong>This endpoint is deprecated - use the V2 endpoints instead.</strong> List all namespace
+   * rules for a given Datadog-AWS integration. This endpoint takes no arguments.
    *
    * @return ApiResponse&lt;List&lt;String&gt;&gt;
    * @throws ApiException if fails to make API call
@@ -1314,7 +1318,8 @@ public CompletableFuture<AWSAccountListResponse> listAWSAccountsAsync(
   }
 
   /**
-   * List all Datadog-AWS integrations available in your Datadog organization.
+   * <strong>This endpoint is deprecated - use the V2 endpoints instead.</strong> List all
+   * Datadog-AWS integrations available in your Datadog organization.
    *
    * @param parameters Optional parameters for the request.
    * @return ApiResponse&lt;AWSAccountListResponse&gt;
@@ -1802,7 +1807,8 @@ public CompletableFuture<Object> updateAWSAccountAsync(
   }
 
   /**
-   * Update a Datadog-Amazon Web Services integration.
+   * <strong>This endpoint is deprecated - use the V2 endpoints instead.</strong> Update a
+   * Datadog-Amazon Web Services integration.
    *
    * @param body AWS request object (required)
    * @param parameters Optional parameters for the request.

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

@@ -892,9 +892,9 @@ public CompletableFuture<List<AWSLogsListServicesResponse>> listAWSLogsServicesA
   }
 
   /**
-   * 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.
+   * <strong>This endpoint is deprecated - use the V2 endpoint instead.</strong> 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.
    *
    * @return ApiResponse&lt;List&lt;AWSLogsListServicesResponse&gt;&gt;
    * @throws ApiException if fails to make API call

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

@@ -136,8 +136,14 @@ public AWSAccount putAccountSpecificNamespaceRulesItem(
   }
 
   /**
-   * An object, (in the form <code>{"namespace1":true/false, "namespace2":true/false}</code>), that
-   * enables or disables metric collection for specific AWS namespaces for this AWS account only.
+   * An object (in the form <code>{"namespace1":true/false, "namespace2":true/false}</code>)
+   * containing user-supplied overrides for AWS namespace metric collection.
+   * <strong>Important</strong>: 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 <code>AWS/SQS</code>, <code>AWS/ElasticMapReduce</code>, and <code>AWS/Usage
+   * </code>). For a complete view of all namespace statuses, use the V2 AWS Integration API
+   * instead.
    *
    * @return accountSpecificNamespaceRules
    */