Update AWS v2 API docs

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-11-25 17:56:03.740290",
-            "spec_repo_commit": "3cfd102e"
+            "regenerated": "2024-11-25 20:30:31.028009",
+            "spec_repo_commit": "0f4fd9de"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-11-25 17:56:03.759282",
-            "spec_repo_commit": "3cfd102e"
+            "regenerated": "2024-11-25 20:30:31.046769",
+            "spec_repo_commit": "0f4fd9de"
         }
     }
 }

.generator/schemas/v2/openapi.yaml

@@ -85,7 +85,9 @@ components:
       schema:
         $ref: '#/components/schemas/APIKeysSort'
     AWSAccountConfigIDPathParameter:
-      description: Unique Datadog ID of the AWS Account Integration Config
+      description: Unique Datadog ID of the AWS Account Integration Config. To get
+        the config ID for an account, use the [List all AWS integrations](https://docs.datadoghq.com/api/latest/aws-integration/#list-all-aws-integrations)
+        endpoint and query by AWS Account ID.
       in: path
       name: aws_account_config_id
       required: true
@@ -991,7 +993,9 @@ components:
       x-enum-varnames:
       - API_KEYS
     AWSAccountConfigID:
-      description: Unique Datadog ID of the AWS Account Integration Config
+      description: Unique Datadog ID of the AWS Account Integration Config. To get
+        the config ID for an account, use the [List all AWS integrations](https://docs.datadoghq.com/api/latest/aws-integration/#list-all-aws-integrations)
+        endpoint and query by AWS Account ID.
       example: 00000000-abcd-0001-0000-000000000000
       type: string
     AWSAccountCreateRequest:
@@ -1112,10 +1116,11 @@ components:
       - type
       type: object
     AWSAccountTags:
+      default: []
       description: Tags to apply to all metrics in the account
       items:
         description: Tag to apply to all metrics in the account
-        example: key:value
+        example: env:prod
         type: string
       nullable: true
       type: array
@@ -1224,12 +1229,14 @@ components:
       description: AWS Lambda forwarder
       properties:
         lambdas:
+          default: []
           description: List of Datadog Lambda Log Forwarder ARNs
           items:
             example: arn:aws:lambda:us-east-1:123456789012:function:DatadogLambdaLogForwarder
             type: string
           type: array
         sources:
+          default: []
           description: List of AWS services that will send logs to the Datadog Lambda
             Log Forwarder
           items:
@@ -1294,18 +1301,22 @@ components:
       description: AWS Metrics config
       properties:
         automute_enabled:
+          default: true
           description: Enable EC2 automute for AWS metrics
           example: true
           type: boolean
         collect_cloudwatch_alarms:
+          default: false
           description: Enable CloudWatch alarms collection
           example: true
           type: boolean
         collect_custom_metrics:
+          default: false
           description: Enable custom metrics collection
           example: true
           type: boolean
         enabled:
+          default: true
           description: Enable AWS metrics collection
           example: true
           type: boolean
@@ -1323,12 +1334,20 @@ components:
       - $ref: '#/components/schemas/AWSNamespaceFiltersExcludeOnly'
       - $ref: '#/components/schemas/AWSNamespaceFiltersIncludeOnly'
     AWSNamespaceFiltersExcludeOnly:
-      description: Exclude only these namespaces
+      description: Exclude only these namespaces from metrics collection. `AWS/SQS`
+        and `AWS/ElasticMapReduce` are excluded by default to reduce CloudWatch costs
+        from `GetMetricData` API calls.
       properties:
         exclude_only:
-          description: Exclude only these namespaces
+          default:
+          - AWS/SQS
+          - AWS/ElasticMapReduce
+          description: Exclude only these namespaces from metrics collection. `AWS/SQS`
+            and `AWS/ElasticMapReduce` are excluded by default to reduce CloudWatch
+            costs from `GetMetricData` API calls.
           example:
-          - AWS/EC2
+          - AWS/SQS
+          - AWS/ElasticMapReduce
           items:
             example: AWS/EC2
             type: string
@@ -1462,6 +1481,7 @@ components:
       description: Include all regions
       properties:
         include_all:
+          default: true
           description: Include all regions
           example: false
           type: boolean
@@ -1484,14 +1504,17 @@ components:
       description: AWS Resources config
       properties:
         cloud_security_posture_management_collection:
-          description: Whether Datadog collects cloud security posture management
-            resources from your AWS account.
+          default: false
+          description: Enable Cloud Security Management to scan AWS resources for
+            vulnerabilities, misconfigurations, identity risks, and compliance violations.
+            Requires `extended_collection` to be set to `true`.
           example: false
           type: boolean
         extended_collection:
+          default: true
           description: Whether Datadog collects additional attributes and configuration
-            information about the resources in your AWS account. Required for `cspm_resource_collection`.
-          example: false
+            information about the resources in your AWS account. Required for `cloud_security_posture_management_collection`.
+          example: true
           type: boolean
       type: object
     AWSTracesConfig:
@@ -27338,6 +27361,7 @@ components:
       nullable: true
       properties:
         include_only:
+          default: []
           description: Include only these services
           example:
           - AWS/AppSync
@@ -32464,7 +32488,8 @@ paths:
       description: Get a list of AWS Account Integration Configs.
       operationId: ListAWSAccounts
       parameters:
-      - description: Optional query filter accounts by AWS Account ID
+      - description: Optional query parameter to filter accounts by AWS Account ID.
+          If not provided, all accounts are returned.
         example: '123456789012'
         in: query
         name: aws_account_id
@@ -32489,7 +32514,7 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_read
-      x-unstable: '**Note: This endpoint is in public beta. If you have any feedback,
+      x-unstable: '**Note: This endpoint is in Preview. If you have any feedback,
 
         contact [Datadog support](https://docs.datadoghq.com/help/).**'
     post:
@@ -32524,12 +32549,12 @@ paths:
         operator: OR
         permissions:
         - aws_configurations_manage
-      x-unstable: '**Note: This endpoint is in public beta. If you have any feedback,
+      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
+      description: Delete an AWS Account Integration Config by config ID.
       operationId: DeleteAWSAccount
       parameters:
       - $ref: '#/components/parameters/AWSAccountConfigIDPathParameter'
@@ -32551,11 +32576,11 @@ paths:
         operator: OR
         permissions:
         - aws_configurations_manage
-      x-unstable: '**Note: This endpoint is in public beta. If you have any feedback,
+      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
+      description: Get an AWS Account Integration Config by config ID.
       operationId: GetAWSAccount
       parameters:
       - $ref: '#/components/parameters/AWSAccountConfigIDPathParameter'
@@ -32581,11 +32606,11 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_read
-      x-unstable: '**Note: This endpoint is in public beta. If you have any feedback,
+      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
+      description: Update an AWS Account Integration Config by config ID.
       operationId: UpdateAWSAccount
       parameters:
       - $ref: '#/components/parameters/AWSAccountConfigIDPathParameter'
@@ -32618,7 +32643,7 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_edit
-      x-unstable: '**Note: This endpoint is in public beta. If you have any feedback,
+      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:
@@ -32644,7 +32669,7 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_read
-      x-unstable: '**Note: This endpoint is in public beta. If you have any feedback,
+      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:
@@ -32669,7 +32694,7 @@ paths:
         operator: OR
         permissions:
         - aws_configuration_edit
-      x-unstable: '**Note: This endpoint is in public beta. If you have any feedback,
+      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/logs/services:

lib/datadog_api_client/v2/api/aws_integration_api.rb

@@ -172,9 +172,9 @@ def delete_aws_account(aws_account_config_id, opts = {})
 
     # Delete an AWS integration.
     #
-    # Delete an AWS Account Integration Config
+    # Delete an AWS Account Integration Config by config ID.
     #
-    # @param aws_account_config_id [String] Unique Datadog ID of the AWS Account Integration Config
+    # @param aws_account_config_id [String] Unique Datadog ID of the AWS Account Integration Config. To get the config ID for an account, use the [List all AWS integrations](https://docs.datadoghq.com/api/latest/aws-integration/#list-all-aws-integrations) endpoint and query by AWS Account ID.
     # @param opts [Hash] the optional parameters
     # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
     def delete_aws_account_with_http_info(aws_account_config_id, opts = {})
@@ -243,9 +243,9 @@ def get_aws_account(aws_account_config_id, opts = {})
 
     # Get an AWS integration by config ID.
     #
-    # Get an AWS Account Integration Config
+    # Get an AWS Account Integration Config by config ID.
     #
-    # @param aws_account_config_id [String] Unique Datadog ID of the AWS Account Integration Config
+    # @param aws_account_config_id [String] Unique Datadog ID of the AWS Account Integration Config. To get the config ID for an account, use the [List all AWS integrations](https://docs.datadoghq.com/api/latest/aws-integration/#list-all-aws-integrations) endpoint and query by AWS Account ID.
     # @param opts [Hash] the optional parameters
     # @return [Array<(AWSAccountResponse, Integer, Hash)>] AWSAccountResponse data, response status code and response headers
     def get_aws_account_with_http_info(aws_account_config_id, opts = {})
@@ -317,7 +317,7 @@ def list_aws_accounts(opts = {})
     # Get a list of AWS Account Integration Configs.
     #
     # @param opts [Hash] the optional parameters
-    # @option opts [String] :aws_account_id Optional query filter accounts by AWS Account ID
+    # @option opts [String] :aws_account_id Optional query parameter to filter accounts by AWS Account ID. If not provided, all accounts are returned.
     # @return [Array<(AWSAccountsResponse, Integer, Hash)>] AWSAccountsResponse data, response status code and response headers
     def list_aws_accounts_with_http_info(opts = {})
       unstable_enabled = @api_client.config.unstable_operations["v2.list_aws_accounts".to_sym]
@@ -448,9 +448,9 @@ def update_aws_account(aws_account_config_id, body, opts = {})
 
     # Update an AWS integration.
     #
-    # Update an AWS Account Integration Config
+    # Update an AWS Account Integration Config by config ID.
     #
-    # @param aws_account_config_id [String] Unique Datadog ID of the AWS Account Integration Config
+    # @param aws_account_config_id [String] Unique Datadog ID of the AWS Account Integration Config. To get the config ID for an account, use the [List all AWS integrations](https://docs.datadoghq.com/api/latest/aws-integration/#list-all-aws-integrations) endpoint and query by AWS Account ID.
     # @param body [AWSAccountUpdateRequest] 
     # @param opts [Hash] the optional parameters
     # @return [Array<(AWSAccountResponse, Integer, Hash)>] AWSAccountResponse data, response status code and response headers

lib/datadog_api_client/v2/models/aws_account_response_data.rb

@@ -24,7 +24,7 @@ class AWSAccountResponseData
     # The AWS Account Integration Config
     attr_accessor :attributes
 
-    # Unique Datadog ID of the AWS Account Integration Config
+    # Unique Datadog ID of the AWS Account Integration Config. To get the config ID for an account, use the [List all AWS integrations](https://docs.datadoghq.com/api/latest/aws-integration/#list-all-aws-integrations) endpoint and query by AWS Account ID.
     attr_reader :id
 
     # AWS Account resource type.

lib/datadog_api_client/v2/models/aws_account_update_request_data.rb

@@ -24,7 +24,7 @@ class AWSAccountUpdateRequestData
     # The AWS Account Integration Config to be updated
     attr_reader :attributes
 
-    # Unique Datadog ID of the AWS Account Integration Config
+    # Unique Datadog ID of the AWS Account Integration Config. To get the config ID for an account, use the [List all AWS integrations](https://docs.datadoghq.com/api/latest/aws-integration/#list-all-aws-integrations) endpoint and query by AWS Account ID.
     attr_accessor :id
 
     # AWS Account resource type.

lib/datadog_api_client/v2/models/aws_namespace_filters_exclude_only.rb

@@ -17,11 +17,11 @@
 require 'time'
 
 module DatadogAPIClient::V2
-  # Exclude only these namespaces
+  # Exclude only these namespaces from metrics collection. `AWS/SQS` and `AWS/ElasticMapReduce` are excluded by default to reduce CloudWatch costs from `GetMetricData` API calls.
   class AWSNamespaceFiltersExcludeOnly
     include BaseGenericModel
 
-    # Exclude only these namespaces
+    # Exclude only these namespaces from metrics collection. `AWS/SQS` and `AWS/ElasticMapReduce` are excluded by default to reduce CloudWatch costs from `GetMetricData` API calls.
     attr_reader :exclude_only
 
     attr_accessor :additional_properties

lib/datadog_api_client/v2/models/aws_resources_config.rb

@@ -21,10 +21,10 @@ module DatadogAPIClient::V2
   class AWSResourcesConfig
     include BaseGenericModel
 
-    # Whether Datadog collects cloud security posture management resources from your AWS account.
+    # Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations, identity risks, and compliance violations. Requires `extended_collection` to be set to `true`.
     attr_accessor :cloud_security_posture_management_collection
 
-    # Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for `cspm_resource_collection`.
+    # Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for `cloud_security_posture_management_collection`.
     attr_accessor :extended_collection
 
     attr_accessor :additional_properties