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

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/datadogV1/api/api_aws_integration.rs

@@ -236,7 +236,7 @@ impl AWSIntegrationAPI {
         Self { config, client }
     }
 
-    /// 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.
@@ -261,7 +261,7 @@ impl 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.
@@ -707,7 +707,7 @@ impl 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.
     pub async fn create_new_aws_external_id(
         &self,
         body: crate::datadogV1::model::AWSAccount,
@@ -729,7 +729,7 @@ impl 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.
     pub async fn create_new_aws_external_id_with_http_info(
         &self,
         body: crate::datadogV1::model::AWSAccount,
@@ -861,7 +861,7 @@ impl 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`.
     pub async fn delete_aws_account(
         &self,
         body: crate::datadogV1::model::AWSAccountDeleteRequest,
@@ -883,7 +883,7 @@ impl 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`.
     pub async fn delete_aws_account_with_http_info(
         &self,
         body: crate::datadogV1::model::AWSAccountDeleteRequest,
@@ -1326,7 +1326,7 @@ impl 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.
     pub async fn list_aws_accounts(
         &self,
         params: ListAWSAccountsOptionalParams,
@@ -1346,7 +1346,7 @@ impl 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.
     pub async fn list_aws_accounts_with_http_info(
         &self,
         params: ListAWSAccountsOptionalParams,
@@ -1666,7 +1666,7 @@ impl 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.
     pub async fn list_available_aws_namespaces(
         &self,
     ) -> Result<Vec<String>, datadog::Error<ListAvailableAWSNamespacesError>> {
@@ -1684,7 +1684,7 @@ impl 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.
     pub async fn list_available_aws_namespaces_with_http_info(
         &self,
     ) -> Result<
@@ -1767,7 +1767,7 @@ impl AWSIntegrationAPI {
         }
     }
 
-    /// Update a Datadog-Amazon Web Services integration.
+    /// **This endpoint is deprecated - use the V2 endpoints instead.** Update a Datadog-Amazon Web Services integration.
     pub async fn update_aws_account(
         &self,
         body: crate::datadogV1::model::AWSAccount,
@@ -1790,7 +1790,7 @@ impl AWSIntegrationAPI {
         }
     }
 
-    /// Update a Datadog-Amazon Web Services integration.
+    /// **This endpoint is deprecated - use the V2 endpoints instead.** Update a Datadog-Amazon Web Services integration.
     pub async fn update_aws_account_with_http_info(
         &self,
         body: crate::datadogV1::model::AWSAccount,

src/datadogV1/api/api_aws_logs_integration.rs

@@ -1043,7 +1043,7 @@ impl 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.
     pub async fn list_aws_logs_services(
         &self,
     ) -> Result<
@@ -1064,7 +1064,7 @@ impl 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.
     pub async fn list_aws_logs_services_with_http_info(
         &self,
     ) -> Result<

src/datadogV1/model/model_aws_account.rs

@@ -17,9 +17,11 @@ pub struct AWSAccount {
     /// Your AWS Account ID without dashes.
     #[serde(rename = "account_id")]
     pub account_id: Option<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.
     #[serde(rename = "account_specific_namespace_rules")]
     pub account_specific_namespace_rules: Option<std::collections::BTreeMap<String, bool>>,
     /// Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general `resource_collection`.