Regenerate client from commit 0f4fd9de of spec repo

.apigentools-info

@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-11-25 17:56:00.736453",
-            "spec_repo_commit": "3cfd102e"
+            "regenerated": "2024-11-25 20:30:33.140292",
+            "spec_repo_commit": "0f4fd9de"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-11-25 17:56:00.754382",
-            "spec_repo_commit": "3cfd102e"
+            "regenerated": "2024-11-25 20:30:33.158637",
+            "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:

src/datadog_api_client/v2/api/aws_integration_api.py

@@ -210,9 +210,9 @@ def delete_aws_account(
     ) -> None:
         """Delete an AWS integration.
 
-        Delete an AWS Account Integration Config
+        Delete an AWS Account Integration Config by config ID.
 
-        :param aws_account_config_id: Unique Datadog ID of the AWS Account Integration Config
+        :param aws_account_config_id: 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.
         :type aws_account_config_id: str
         :rtype: None
         """
@@ -227,9 +227,9 @@ def get_aws_account(
     ) -> AWSAccountResponse:
         """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: Unique Datadog ID of the AWS Account Integration Config
+        :param aws_account_config_id: 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.
         :type aws_account_config_id: str
         :rtype: AWSAccountResponse
         """
@@ -247,7 +247,7 @@ def list_aws_accounts(
 
         Get a list of AWS Account Integration Configs.
 
-        :param aws_account_id: Optional query filter accounts by AWS Account ID
+        :param aws_account_id: Optional query parameter to filter accounts by AWS Account ID. If not provided, all accounts are returned.
         :type aws_account_id: str, optional
         :rtype: AWSAccountsResponse
         """
@@ -276,9 +276,9 @@ def update_aws_account(
     ) -> AWSAccountResponse:
         """Update an AWS integration.
 
-        Update an AWS Account Integration Config
+        Update an AWS Account Integration Config by config ID.
 
-        :param aws_account_config_id: Unique Datadog ID of the AWS Account Integration Config
+        :param aws_account_config_id: 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.
         :type aws_account_config_id: str
         :type body: AWSAccountUpdateRequest
         :rtype: AWSAccountResponse

src/datadog_api_client/v2/model/aws_account_response_data.py

@@ -49,7 +49,7 @@ def __init__(
         :param attributes: The AWS Account Integration Config
         :type attributes: AWSAccountResponseAttributes, optional
 
-        :param id: Unique Datadog ID of the AWS Account Integration Config
+        :param id: 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.
         :type id: str
 
         :param type: AWS Account resource type.

src/datadog_api_client/v2/model/aws_account_update_request_data.py

@@ -49,7 +49,7 @@ def __init__(
         :param attributes: The AWS Account Integration Config to be updated
         :type attributes: AWSAccountUpdateRequestAttributes
 
-        :param id: Unique Datadog ID of the AWS Account Integration Config
+        :param id: 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.
         :type id: str, optional
 
         :param type: AWS Account resource type.

src/datadog_api_client/v2/model/aws_namespace_filters.py

@@ -15,7 +15,7 @@ def __init__(self, **kwargs):
         """
         AWS Metrics namespace filters
 
-        :param exclude_only: Exclude only these namespaces
+        :param exclude_only: Exclude only these namespaces from metrics collection. `AWS/SQS` and `AWS/ElasticMapReduce` are excluded by default to reduce CloudWatch costs from `GetMetricData` API calls.
         :type exclude_only: [str]
 
         :param include_only: Include only these namespaces

src/datadog_api_client/v2/model/aws_namespace_filters_exclude_only.py

@@ -3,7 +3,6 @@
 # Copyright 2019-Present Datadog, Inc.
 from __future__ import annotations
 
-from typing import List
 
 from datadog_api_client.model_utils import (
     ModelNormal,
@@ -22,13 +21,14 @@ def openapi_types(_):
         "exclude_only": "exclude_only",
     }
 
-    def __init__(self_, exclude_only: List[str], **kwargs):
+    def __init__(self_, **kwargs):
         """
-        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.
 
-        :param exclude_only: Exclude only these namespaces
+        :param exclude_only: Exclude only these namespaces from metrics collection. ``AWS/SQS`` and ``AWS/ElasticMapReduce`` are excluded by default to reduce CloudWatch costs from ``GetMetricData`` API calls.
         :type exclude_only: [str]
         """
         super().__init__(kwargs)
+        exclude_only = kwargs.get("exclude_only", ["AWS/SQS", "AWS/ElasticMapReduce"])
 
         self_.exclude_only = exclude_only

src/datadog_api_client/v2/model/aws_regions_include_all.py

@@ -21,13 +21,14 @@ def openapi_types(_):
         "include_all": "include_all",
     }
 
-    def __init__(self_, include_all: bool, **kwargs):
+    def __init__(self_, **kwargs):
         """
         Include all regions
 
         :param include_all: Include all regions
         :type include_all: bool
         """
         super().__init__(kwargs)
+        include_all = kwargs.get("include_all", true)
 
         self_.include_all = include_all

src/datadog_api_client/v2/model/aws_resources_config.py

@@ -35,10 +35,10 @@ def __init__(
         """
         AWS Resources config
 
-        :param cloud_security_posture_management_collection: Whether Datadog collects cloud security posture management resources from your AWS account.
+        :param cloud_security_posture_management_collection: Enable Cloud Security Management to scan AWS resources for vulnerabilities, misconfigurations, identity risks, and compliance violations. Requires ``extended_collection`` to be set to ``true``.
         :type cloud_security_posture_management_collection: bool, optional
 
-        :param extended_collection: Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for ``cspm_resource_collection``.
+        :param extended_collection: Whether Datadog collects additional attributes and configuration information about the resources in your AWS account. Required for ``cloud_security_posture_management_collection``.
         :type extended_collection: bool, optional
         """
         if cloud_security_posture_management_collection is not unset:

src/datadog_api_client/v2/model/x_ray_services_include_only.py

@@ -3,7 +3,6 @@
 # Copyright 2019-Present Datadog, Inc.
 from __future__ import annotations
 
-from typing import List
 
 from datadog_api_client.model_utils import (
     ModelNormal,
@@ -24,13 +23,14 @@ def openapi_types(_):
         "include_only": "include_only",
     }
 
-    def __init__(self_, include_only: List[str], **kwargs):
+    def __init__(self_, **kwargs):
         """
         Include only these services
 
         :param include_only: Include only these services
         :type include_only: [str]
         """
         super().__init__(kwargs)
+        include_only = kwargs.get("include_only", [])
 
         self_.include_only = include_only