Regenerate client from commit 0f4fd9de of spec repo

DataDog · Nov 25, 2024 · 5fe4ffd · 5fe4ffd
1 parent 943ebc1
commit 5fe4ffd
Show file tree

Hide file tree

Showing 7 changed files with 64 additions and 39 deletions.
diff --git a/.apigentools-info b/.apigentools-info
@@ -4,13 +4,13 @@
     "spec_versions": {
         "v1": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-11-25 17:55:57.446086",
-            "spec_repo_commit": "3cfd102e"
+            "regenerated": "2024-11-25 20:30:32.536166",
+            "spec_repo_commit": "0f4fd9de"
         },
         "v2": {
             "apigentools_version": "1.6.6",
-            "regenerated": "2024-11-25 17:55:57.465824",
-            "spec_repo_commit": "3cfd102e"
+            "regenerated": "2024-11-25 20:30:32.555648",
+            "spec_repo_commit": "0f4fd9de"
         }
     }
 }
diff --git a/.generator/schemas/v2/openapi.yaml b/.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:

diff --git a/src/datadogV2/api/api_aws_integration.rs b/src/datadogV2/api/api_aws_integration.rs
@@ -15,12 +15,12 @@ use std::io::Write;
 #[non_exhaustive]
 #[derive(Clone, Default, Debug)]
 pub struct ListAWSAccountsOptionalParams {
-    /// Optional query filter accounts by AWS Account ID
+    /// Optional query parameter to filter accounts by AWS Account ID. If not provided, all accounts are returned.
     pub aws_account_id: Option<String>,
 }
 
 impl ListAWSAccountsOptionalParams {
-    /// Optional query filter accounts by AWS Account ID
+    /// Optional query parameter to filter accounts by AWS Account ID. If not provided, all accounts are returned.
     pub fn aws_account_id(mut self, value: String) -> Self {
         self.aws_account_id = Some(value);
         self
@@ -423,7 +423,7 @@ impl AWSIntegrationAPI {
         }
     }
 
-    /// Delete an AWS Account Integration Config
+    /// Delete an AWS Account Integration Config by config ID.
     pub async fn delete_aws_account(
         &self,
         aws_account_config_id: String,
@@ -437,7 +437,7 @@ impl AWSIntegrationAPI {
         }
     }
 
-    /// Delete an AWS Account Integration Config
+    /// Delete an AWS Account Integration Config by config ID.
     pub async fn delete_aws_account_with_http_info(
         &self,
         aws_account_config_id: String,
@@ -522,7 +522,7 @@ impl AWSIntegrationAPI {
         }
     }
 
-    /// Get an AWS Account Integration Config
+    /// Get an AWS Account Integration Config by config ID.
     pub async fn get_aws_account(
         &self,
         aws_account_config_id: String,
@@ -545,7 +545,7 @@ impl AWSIntegrationAPI {
         }
     }
 
-    /// Get an AWS Account Integration Config
+    /// Get an AWS Account Integration Config by config ID.
     pub async fn get_aws_account_with_http_info(
         &self,
         aws_account_config_id: String,
@@ -876,7 +876,7 @@ impl AWSIntegrationAPI {
         }
     }
 
-    /// Update an AWS Account Integration Config
+    /// Update an AWS Account Integration Config by config ID.
     pub async fn update_aws_account(
         &self,
         aws_account_config_id: String,
@@ -900,7 +900,7 @@ impl AWSIntegrationAPI {
         }
     }
 
-    /// Update an AWS Account Integration Config
+    /// Update an AWS Account Integration Config by config ID.
     pub async fn update_aws_account_with_http_info(
         &self,
         aws_account_config_id: String,

diff --git a/src/datadogV2/model/model_aws_account_response_data.rs b/src/datadogV2/model/model_aws_account_response_data.rs
@@ -14,7 +14,7 @@ pub struct AWSAccountResponseData {
     /// The AWS Account Integration Config
     #[serde(rename = "attributes")]
     pub attributes: Option<crate::datadogV2::model::AWSAccountResponseAttributes>,
-    /// 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.
     #[serde(rename = "id")]
     pub id: String,
     /// AWS Account resource type.

diff --git a/src/datadogV2/model/model_aws_account_update_request_data.rs b/src/datadogV2/model/model_aws_account_update_request_data.rs
@@ -14,7 +14,7 @@ pub struct AWSAccountUpdateRequestData {
     /// The AWS Account Integration Config to be updated
     #[serde(rename = "attributes")]
     pub attributes: crate::datadogV2::model::AWSAccountUpdateRequestAttributes,
-    /// 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.
     #[serde(rename = "id")]
     pub id: Option<String>,
     /// AWS Account resource type.

diff --git a/src/datadogV2/model/model_aws_namespace_filters_exclude_only.rs b/src/datadogV2/model/model_aws_namespace_filters_exclude_only.rs
@@ -6,12 +6,12 @@ use serde::{Deserialize, Deserializer, Serialize};
 use serde_with::skip_serializing_none;
 use std::fmt::{self, Formatter};
 
-/// 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.
 #[non_exhaustive]
 #[skip_serializing_none]
 #[derive(Clone, Debug, PartialEq, Serialize)]
 pub struct AWSNamespaceFiltersExcludeOnly {
-    /// 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.
     #[serde(rename = "exclude_only")]
     pub exclude_only: Vec<String>,
     #[serde(flatten)]

diff --git a/src/datadogV2/model/model_aws_resources_config.rs b/src/datadogV2/model/model_aws_resources_config.rs
@@ -11,10 +11,10 @@ use std::fmt::{self, Formatter};
 #[skip_serializing_none]
 #[derive(Clone, Debug, PartialEq, Serialize)]
 pub struct AWSResourcesConfig {
-    /// 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`.
     #[serde(rename = "cloud_security_posture_management_collection")]
     pub cloud_security_posture_management_collection: Option<bool>,
-    /// 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`.
     #[serde(rename = "extended_collection")]
     pub extended_collection: Option<bool>,
     #[serde(flatten)]