Promote unstable aws v2 APIs and deprecate v1 (#3337)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>
Co-authored-by: Damien Fleurisson <77481214+damfleu@users.noreply.github.com>

Author: 3 people

.generator/schemas/v1/openapi.yaml

@@ -27347,6 +27347,7 @@ paths:
         - hosts_read
   /api/v1/integration/aws:
     delete:
+      deprecated: true
       description: Delete a Datadog-AWS integration matching the specified `account_id`
         and `role_name parameters`.
       operationId: DeleteAWSAccount
@@ -27393,6 +27394,7 @@ paths:
         permissions:
         - aws_configurations_manage
     get:
+      deprecated: true
       description: List all Datadog-AWS integrations available in your Datadog organization.
       operationId: ListAWSAccounts
       parameters:
@@ -27443,6 +27445,7 @@ paths:
         permissions:
         - aws_configuration_read
     post:
+      deprecated: true
       description: 'Create a Datadog-Amazon Web Services integration.
 
         Using the `POST` method updates your integration configuration
@@ -27494,6 +27497,7 @@ paths:
         permissions:
         - aws_configurations_manage
     put:
+      deprecated: true
       description: Update a Datadog-Amazon Web Services integration.
       operationId: UpdateAWSAccount
       parameters:
@@ -27563,6 +27567,7 @@ paths:
         - aws_configuration_edit
   /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.
       operationId: ListAvailableAWSNamespaces
@@ -27708,6 +27713,7 @@ paths:
         - manage_integrations
   /api/v1/integration/aws/filtering:
     delete:
+      deprecated: true
       description: Delete a tag filtering entry.
       operationId: DeleteAWSTagFilter
       requestBody:
@@ -27749,6 +27755,7 @@ paths:
         permissions:
         - aws_configuration_edit
     get:
+      deprecated: true
       description: Get all AWS tag filters.
       operationId: ListAWSTagFilters
       parameters:
@@ -27787,6 +27794,7 @@ paths:
         permissions:
         - aws_configuration_read
     post:
+      deprecated: true
       description: Set an AWS tag filter.
       operationId: CreateAWSTagFilter
       requestBody:
@@ -27832,6 +27840,7 @@ paths:
         - aws_configuration_edit
   /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.
       operationId: CreateNewAWSExternalID
@@ -27917,6 +27926,7 @@ paths:
         permissions:
         - aws_configuration_edit
     get:
+      deprecated: true
       description: List all Datadog-AWS Logs integrations configured in your Datadog
         account.
       operationId: ListAWSLogsIntegrations
@@ -28058,6 +28068,7 @@ paths:
         - aws_configuration_read
   /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.
@@ -28100,6 +28111,7 @@ paths:
         permissions:
         - aws_configuration_read
     post:
+      deprecated: true
       description: Enable automatic log collection for a list of services. This should
         be run after running `CreateAWSLambdaARN` to save the configuration.
       operationId: EnableAWSLogServices

.generator/schemas/v2/openapi.yaml

@@ -55263,9 +55263,6 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_read
-      x-unstable: '**Note: This endpoint is in Preview. If you have any feedback,
-
-        contact [Datadog support](https://docs.datadoghq.com/help/).**'
     post:
       description: Create a new AWS Account Integration Config.
       operationId: CreateAWSAccount
@@ -55298,9 +55295,6 @@ paths:
         operator: OR
         permissions:
         - aws_configurations_manage
-      x-unstable: '**Note: This endpoint is in Preview. If you have any feedback,
-
-        contact [Datadog support](https://docs.datadoghq.com/help/).**'
   /api/v2/integration/aws/accounts/{aws_account_config_id}:
     delete:
       description: Delete an AWS Account Integration Config by config ID.
@@ -55325,9 +55319,6 @@ paths:
         operator: OR
         permissions:
         - aws_configurations_manage
-      x-unstable: '**Note: This endpoint is in Preview. If you have any feedback,
-
-        contact [Datadog support](https://docs.datadoghq.com/help/).**'
     get:
       description: Get an AWS Account Integration Config by config ID.
       operationId: GetAWSAccount
@@ -55355,9 +55346,6 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_read
-      x-unstable: '**Note: This endpoint is in Preview. If you have any feedback,
-
-        contact [Datadog support](https://docs.datadoghq.com/help/).**'
     patch:
       description: Update an AWS Account Integration Config by config ID.
       operationId: UpdateAWSAccount
@@ -55392,9 +55380,6 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_edit
-      x-unstable: '**Note: This endpoint is in Preview. If you have any feedback,
-
-        contact [Datadog support](https://docs.datadoghq.com/help/).**'
   /api/v2/integration/aws/available_namespaces:
     get:
       description: Get a list of available AWS CloudWatch namespaces that can send
@@ -55418,9 +55403,6 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_read
-      x-unstable: '**Note: This endpoint is in Preview. If you have any feedback,
-
-        contact [Datadog support](https://docs.datadoghq.com/help/).**'
   /api/v2/integration/aws/generate_new_external_id:
     post:
       description: Generate a new external ID for AWS role-based authentication.
@@ -55443,9 +55425,6 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_edit
-      x-unstable: '**Note: This endpoint is in Preview. If you have any feedback,
-
-        contact [Datadog support](https://docs.datadoghq.com/help/).**'
   /api/v2/integration/aws/iam_permissions:
     get:
       description: Get all AWS IAM permissions required for the AWS integration.
@@ -55484,9 +55463,6 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_read
-      x-unstable: '**Note: This endpoint is in public beta. If you have any feedback,
-
-        contact [Datadog support](https://docs.datadoghq.com/help/).**'
   /api/v2/integration/gcp/accounts:
     get:
       description: List all GCP STS-enabled service accounts configured in your Datadog

api/datadog/configuration.go

@@ -659,14 +659,6 @@ func NewConfiguration() *Configuration {
 			"v2.UpdateIncidentNotificationTemplate":      false,
 			"v2.UpdateIncidentTodo":                      false,
 			"v2.UpdateIncidentType":                      false,
-			"v2.CreateAWSAccount":                        false,
-			"v2.CreateNewAWSExternalID":                  false,
-			"v2.DeleteAWSAccount":                        false,
-			"v2.GetAWSAccount":                           false,
-			"v2.ListAWSAccounts":                         false,
-			"v2.ListAWSNamespaces":                       false,
-			"v2.UpdateAWSAccount":                        false,
-			"v2.ListAWSLogsServices":                     false,
 			"v2.CreateMonitorUserTemplate":               false,
 			"v2.DeleteMonitorUserTemplate":               false,
 			"v2.GetMonitorUserTemplate":                  false,

api/datadogV1/api_aws_integration.go

@@ -20,6 +20,8 @@ type AWSIntegrationApi datadog.Service
 // 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.
+//
+// Deprecated: This API is deprecated.
 func (a *AWSIntegrationApi) CreateAWSAccount(ctx _context.Context, body AWSAccount) (AWSAccountCreateResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPost
@@ -180,6 +182,8 @@ func (a *AWSIntegrationApi) CreateAWSEventBridgeSource(ctx _context.Context, bod
 
 // CreateAWSTagFilter Set an AWS tag filter.
 // Set an AWS tag filter.
+//
+// Deprecated: This API is deprecated.
 func (a *AWSIntegrationApi) CreateAWSTagFilter(ctx _context.Context, body AWSTagFilterCreateRequest) (interface{}, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPost
@@ -260,6 +264,8 @@ 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.
+//
+// Deprecated: This API is deprecated.
 func (a *AWSIntegrationApi) CreateNewAWSExternalID(ctx _context.Context, body AWSAccount) (AWSAccountCreateResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPut
@@ -340,6 +346,8 @@ 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`.
+//
+// Deprecated: This API is deprecated.
 func (a *AWSIntegrationApi) DeleteAWSAccount(ctx _context.Context, body AWSAccountDeleteRequest) (interface{}, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodDelete
@@ -500,6 +508,8 @@ func (a *AWSIntegrationApi) DeleteAWSEventBridgeSource(ctx _context.Context, bod
 
 // DeleteAWSTagFilter Delete a tag filtering entry.
 // Delete a tag filtering entry.
+//
+// Deprecated: This API is deprecated.
 func (a *AWSIntegrationApi) DeleteAWSTagFilter(ctx _context.Context, body AWSTagFilterDeleteRequest) (interface{}, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodDelete
@@ -611,6 +621,8 @@ func (r *ListAWSAccountsOptionalParameters) WithAccessKeyId(accessKeyId string)
 
 // ListAWSAccounts List all AWS integrations.
 // 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) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodGet
@@ -782,6 +794,8 @@ func (a *AWSIntegrationApi) ListAWSEventBridgeSources(ctx _context.Context) (AWS
 
 // ListAWSTagFilters Get all AWS tag filters.
 // Get all AWS tag filters.
+//
+// Deprecated: This API is deprecated.
 func (a *AWSIntegrationApi) ListAWSTagFilters(ctx _context.Context, accountId string) (AWSTagFilterListResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodGet
@@ -860,6 +874,8 @@ 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.
+//
+// Deprecated: This API is deprecated.
 func (a *AWSIntegrationApi) ListAvailableAWSNamespaces(ctx _context.Context) ([]string, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodGet
@@ -968,6 +984,8 @@ func (r *UpdateAWSAccountOptionalParameters) WithAccessKeyId(accessKeyId string)
 
 // UpdateAWSAccount Update an AWS integration.
 // 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) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPut

api/datadogV1/api_aws_logs_integration.go

@@ -353,6 +353,8 @@ func (a *AWSLogsIntegrationApi) DeleteAWSLambdaARN(ctx _context.Context, body AW
 
 // EnableAWSLogServices Enable an AWS Logs integration.
 // Enable automatic log collection for a list of services. This should be run after running `CreateAWSLambdaARN` to save the configuration.
+//
+// Deprecated: This API is deprecated.
 func (a *AWSLogsIntegrationApi) EnableAWSLogServices(ctx _context.Context, body AWSLogsServicesRequest) (interface{}, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodPost
@@ -433,6 +435,8 @@ func (a *AWSLogsIntegrationApi) EnableAWSLogServices(ctx _context.Context, body
 
 // ListAWSLogsIntegrations List all AWS Logs integrations.
 // List all Datadog-AWS Logs integrations configured in your Datadog account.
+//
+// Deprecated: This API is deprecated.
 func (a *AWSLogsIntegrationApi) ListAWSLogsIntegrations(ctx _context.Context) ([]AWSLogsListResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodGet
@@ -510,6 +514,8 @@ 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.
+//
+// Deprecated: This API is deprecated.
 func (a *AWSLogsIntegrationApi) ListAWSLogsServices(ctx _context.Context) ([]AWSLogsListServicesResponse, *_nethttp.Response, error) {
 	var (
 		localVarHTTPMethod  = _nethttp.MethodGet