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

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

api/datadogV1/api_aws_integration.go

@@ -16,7 +16,7 @@ import (
 type AWSIntegrationApi datadog.Service
 
 // CreateAWSAccount 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.
@@ -265,7 +265,7 @@ func (a *AWSIntegrationApi) CreateAWSTagFilter(ctx _context.Context, body AWSTag
 }
 
 // CreateNewAWSExternalID 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.
 func (a *AWSIntegrationApi) CreateNewAWSExternalID(ctx _context.Context, body AWSAccount) (AWSAccountCreateResponse, *_nethttp.Response, error) {
@@ -347,7 +347,7 @@ func (a *AWSIntegrationApi) CreateNewAWSExternalID(ctx _context.Context, body AW
 }
 
 // DeleteAWSAccount 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.
 func (a *AWSIntegrationApi) DeleteAWSAccount(ctx _context.Context, body AWSAccountDeleteRequest) (interface{}, *_nethttp.Response, error) {
@@ -624,7 +624,7 @@ func (r *ListAWSAccountsOptionalParameters) WithAccessKeyId(accessKeyId string)
 }
 
 // ListAWSAccounts 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.
 func (a *AWSIntegrationApi) ListAWSAccounts(ctx _context.Context, o ...ListAWSAccountsOptionalParameters) (AWSAccountListResponse, *_nethttp.Response, error) {
@@ -879,7 +879,7 @@ func (a *AWSIntegrationApi) ListAWSTagFilters(ctx _context.Context, accountId st
 }
 
 // ListAvailableAWSNamespaces 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.
 func (a *AWSIntegrationApi) ListAvailableAWSNamespaces(ctx _context.Context) ([]string, *_nethttp.Response, error) {
@@ -989,7 +989,7 @@ func (r *UpdateAWSAccountOptionalParameters) WithAccessKeyId(accessKeyId string)
 }
 
 // UpdateAWSAccount 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.
 func (a *AWSIntegrationApi) UpdateAWSAccount(ctx _context.Context, body AWSAccount, o ...UpdateAWSAccountOptionalParameters) (interface{}, *_nethttp.Response, error) {

api/datadogV1/api_aws_logs_integration.go

@@ -513,7 +513,7 @@ func (a *AWSLogsIntegrationApi) ListAWSLogsIntegrations(ctx _context.Context) ([
 }
 
 // ListAWSLogsServices 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.
 func (a *AWSLogsIntegrationApi) ListAWSLogsServices(ctx _context.Context) ([]AWSLogsListServicesResponse, *_nethttp.Response, error) {

api/datadogV1/model_aws_account.go

@@ -14,9 +14,11 @@ type AWSAccount struct {
 	AccessKeyId *string `json:"access_key_id,omitempty"`
 	// Your AWS Account ID without dashes.
 	AccountId *string `json:"account_id,omitempty"`
-	// 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 map[string]bool `json:"account_specific_namespace_rules,omitempty"`
 	// Whether Datadog collects cloud security posture management resources from your AWS account. This includes additional resources not covered under the general `resource_collection`.
 	CspmResourceCollectionEnabled *bool `json:"cspm_resource_collection_enabled,omitempty"`