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

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

lib/datadog_api_client/v1/api/aws_integration_api.rb

@@ -33,7 +33,7 @@ def create_aws_account(body, opts = {})
 
     # Create an AWS integration.
     #
-    # 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.
@@ -246,7 +246,7 @@ def create_new_aws_external_id(body, opts = {})
 
     # Generate a new external ID.
     #
-    # 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.
     #
     # @deprecated This API is deprecated.
     #
@@ -316,7 +316,7 @@ def delete_aws_account(body, opts = {})
 
     # Delete an AWS integration.
     #
-    # 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`.
     #
     # @deprecated This API is deprecated.
     #
@@ -526,7 +526,7 @@ def list_available_aws_namespaces(opts = {})
 
     # List namespace rules.
     #
-    # 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.
     #
     # @deprecated This API is deprecated.
     #
@@ -589,7 +589,7 @@ def list_aws_accounts(opts = {})
 
     # List all AWS integrations.
     #
-    # 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.
     #
     # @deprecated This API is deprecated.
     #
@@ -790,7 +790,7 @@ def update_aws_account(body, opts = {})
 
     # Update an AWS integration.
     #
-    # Update a Datadog-Amazon Web Services integration.
+    # **This endpoint is deprecated - use the V2 endpoints instead.** Update a Datadog-Amazon Web Services integration.
     #
     # @deprecated This API is deprecated.
     #

lib/datadog_api_client/v1/api/aws_logs_integration_api.rb

@@ -450,7 +450,7 @@ def list_aws_logs_services(opts = {})
 
     # Get list of AWS log ready services.
     #
-    # 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.
     #
     # @deprecated This API is deprecated.
     #

lib/datadog_api_client/v1/models/aws_account.rb

@@ -27,9 +27,11 @@ class AWSAccount
     # Your AWS Account ID without dashes.
     attr_accessor :account_id
 
-    # 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.
     attr_accessor :account_specific_namespace_rules
 
     # Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general `resource_collection`.