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

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/datadog_api_client/v1/api/aws_integration_api.py

@@ -305,7 +305,7 @@ def create_aws_account(
     ) -> AWSAccountCreateResponse:
         """Create an AWS integration. **Deprecated**.
 
-        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.
@@ -363,7 +363,7 @@ def create_new_aws_external_id(
     ) -> AWSAccountCreateResponse:
         """Generate a new external ID. **Deprecated**.
 
-        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 body: Your Datadog role delegation name.
             For more information about your AWS account Role name,
@@ -383,7 +383,7 @@ def delete_aws_account(
     ) -> dict:
         """Delete an AWS integration. **Deprecated**.
 
-        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 body: AWS request object
         :type body: AWSAccountDeleteRequest
@@ -436,7 +436,7 @@ def list_available_aws_namespaces(
     ) -> List[str]:
         """List namespace rules. **Deprecated**.
 
-        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.
 
         :rtype: [str]
         """
@@ -453,7 +453,7 @@ def list_aws_accounts(
     ) -> AWSAccountListResponse:
         """List all AWS integrations. **Deprecated**.
 
-        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 account_id: Only return AWS accounts that matches this ``account_id``.
         :type account_id: str, optional
@@ -517,7 +517,7 @@ def update_aws_account(
     ) -> dict:
         """Update an AWS integration. **Deprecated**.
 
-        Update a Datadog-Amazon Web Services integration.
+        **This endpoint is deprecated - use the V2 endpoints instead.** Update a Datadog-Amazon Web Services integration.
 
         :param body: AWS request object
         :type body: AWSAccount

src/datadog_api_client/v1/api/aws_logs_integration_api.py

@@ -278,7 +278,7 @@ def list_aws_logs_services(
     ) -> List[AWSLogsListServicesResponse]:
         """Get list of AWS log ready services. **Deprecated**.
 
-        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.
 
         :rtype: [AWSLogsListServicesResponse]
         """

src/datadog_api_client/v1/model/aws_account.py

@@ -71,9 +71,11 @@ def __init__(
         :param account_id: Your AWS Account ID without dashes.
         :type account_id: str, optional
 
-        :param account_specific_namespace_rules: 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.
+        :param account_specific_namespace_rules: 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.
         :type account_specific_namespace_rules: {str: (bool,)}, optional
 
         :param cspm_resource_collection_enabled: Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general ``resource_collection``.