Add ValidateAWSCCMConfig operation to AWS integration v2 spec (#1628)

Co-authored-by: ci.datadog-api-spec <packages@datadoghq.com>

Author: api-clients-generation-pipeline[bot]

.generator/schemas/v2/openapi.yaml

@@ -2700,6 +2700,158 @@ components:
       type: string
       x-enum-varnames:
         - CCM_CONFIG
+    AWSCcmConfigValidationIssue:
+      description: A single validation issue found while validating an AWS Cost and Usage Report (CUR) 2.0 configuration.
+      properties:
+        code:
+          $ref: "#/components/schemas/AWSCcmConfigValidationIssueCode"
+        description:
+          description: Human-readable description of the validation issue.
+          example: 'no CUR 2.0 export named "cost-and-usage-report" found'
+          type: string
+      required:
+        - code
+        - description
+      type: object
+    AWSCcmConfigValidationIssueCode:
+      description: Identifies the specific reason a Cost and Usage Report (CUR) 2.0 configuration failed validation.
+      enum:
+        - ISSUE_CODE_UNSPECIFIED
+        - CREDENTIAL_ERROR
+        - BUCKET_NAME_INVALID_GOVCLOUD
+        - S3_LIST_PERMISSION_MISSING
+        - S3_GET_PERMISSION_MISSING
+        - S3_BUCKET_REGION_MISMATCH
+        - S3_BUCKET_NOT_ACCESSIBLE
+        - EXPORT_LIST_PERMISSION_MISSING
+        - EXPORT_GET_PERMISSION_MISSING
+        - EXPORT_NOT_FOUND
+        - EXPORT_STATUS_UNHEALTHY
+        - TIME_GRANULARITY_INVALID
+        - FILE_FORMAT_INVALID
+        - INCLUDE_RESOURCES_DISABLED
+        - REFRESH_CADENCE_INVALID
+        - OVERWRITE_MODE_INVALID
+        - QUERY_STATEMENT_INVALID
+      example: "EXPORT_NOT_FOUND"
+      type: string
+      x-enum-varnames:
+        - ISSUE_CODE_UNSPECIFIED
+        - CREDENTIAL_ERROR
+        - BUCKET_NAME_INVALID_GOVCLOUD
+        - S3_LIST_PERMISSION_MISSING
+        - S3_GET_PERMISSION_MISSING
+        - S3_BUCKET_REGION_MISMATCH
+        - S3_BUCKET_NOT_ACCESSIBLE
+        - EXPORT_LIST_PERMISSION_MISSING
+        - EXPORT_GET_PERMISSION_MISSING
+        - EXPORT_NOT_FOUND
+        - EXPORT_STATUS_UNHEALTHY
+        - TIME_GRANULARITY_INVALID
+        - FILE_FORMAT_INVALID
+        - INCLUDE_RESOURCES_DISABLED
+        - REFRESH_CADENCE_INVALID
+        - OVERWRITE_MODE_INVALID
+        - QUERY_STATEMENT_INVALID
+    AWSCcmConfigValidationIssues:
+      description: List of validation issues found for the Cost and Usage Report (CUR) 2.0 configuration. Empty when the configuration is valid.
+      items:
+        $ref: "#/components/schemas/AWSCcmConfigValidationIssue"
+      type: array
+    AWSCcmConfigValidationRequest:
+      description: AWS CCM config validation request body.
+      properties:
+        data:
+          $ref: "#/components/schemas/AWSCcmConfigValidationRequestData"
+      required:
+        - data
+      type: object
+    AWSCcmConfigValidationRequestAttributes:
+      description: Attributes for an AWS CCM config validation request.
+      properties:
+        account_id:
+          description: Your AWS Account ID without dashes.
+          example: "123456789012"
+          type: string
+        bucket_name:
+          description: Name of the S3 bucket where the Cost and Usage Report is stored.
+          example: "billing"
+          type: string
+        bucket_region:
+          description: AWS region of the S3 bucket.
+          example: "us-east-1"
+          type: string
+        report_name:
+          description: Name of the Cost and Usage Report.
+          example: "cost-and-usage-report"
+          type: string
+        report_prefix:
+          description: S3 prefix where the Cost and Usage Report is stored.
+          example: "reports"
+          type: string
+      required:
+        - account_id
+        - bucket_name
+        - bucket_region
+        - report_name
+      type: object
+    AWSCcmConfigValidationRequestData:
+      description: AWS CCM config validation request data.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/AWSCcmConfigValidationRequestAttributes"
+        type:
+          $ref: "#/components/schemas/AWSCcmConfigValidationType"
+      required:
+        - attributes
+        - type
+      type: object
+    AWSCcmConfigValidationResponse:
+      description: AWS CCM config validation response body.
+      properties:
+        data:
+          $ref: "#/components/schemas/AWSCcmConfigValidationResponseData"
+      required:
+        - data
+      type: object
+    AWSCcmConfigValidationResponseAttributes:
+      description: Attributes for an AWS CCM config validation response.
+      properties:
+        account_id:
+          description: Your AWS Account ID without dashes.
+          example: "123456789012"
+          type: string
+        issues:
+          $ref: "#/components/schemas/AWSCcmConfigValidationIssues"
+      required:
+        - account_id
+        - issues
+      type: object
+    AWSCcmConfigValidationResponseData:
+      description: AWS CCM config validation response data.
+      properties:
+        attributes:
+          $ref: "#/components/schemas/AWSCcmConfigValidationResponseAttributes"
+        id:
+          description: AWS CCM config validation resource identifier.
+          example: "ccm_config_validation"
+          type: string
+        type:
+          $ref: "#/components/schemas/AWSCcmConfigValidationType"
+      required:
+        - attributes
+        - id
+        - type
+      type: object
+    AWSCcmConfigValidationType:
+      default: "ccm_config_validation"
+      description: AWS CCM config validation resource type.
+      enum:
+        - ccm_config_validation
+      example: "ccm_config_validation"
+      type: string
+      x-enum-varnames:
+        - CCM_CONFIG_VALIDATION
     AWSCloudAuthPersonaMappingAttributesResponse:
       description: Attributes for AWS cloud authentication persona mapping response
       properties:
@@ -128868,6 +129020,76 @@ paths:
         operator: OR
         permissions:
           - aws_configuration_read
+  /api/v2/integration/aws/validate_ccm_config:
+    post:
+      description: |-
+        Validate a Cloud Cost Management config for an AWS account using Cost and Usage Report
+        (CUR) 2.0 against Datadog's ingest requirements without persisting it.
+      operationId: ValidateAWSCCMConfig
+      requestBody:
+        content:
+          application/json:
+            examples:
+              default:
+                value:
+                  data:
+                    attributes:
+                      account_id: "123456789012"
+                      bucket_name: billing
+                      bucket_region: us-east-1
+                      report_name: cost-and-usage-report
+                      report_prefix: reports
+                    type: ccm_config_validation
+            schema:
+              $ref: "#/components/schemas/AWSCcmConfigValidationRequest"
+        description: Validate a Cloud Cost Management config for an AWS account integration config.
+        required: true
+      responses:
+        "200":
+          content:
+            application/json:
+              examples:
+                default:
+                  value:
+                    data:
+                      attributes:
+                        account_id: "123456789012"
+                        issues:
+                          - code: EXPORT_NOT_FOUND
+                            description: 'no CUR 2.0 export named "cost-and-usage-report" found'
+                      id: ccm_config_validation
+                      type: ccm_config_validation
+              schema:
+                $ref: "#/components/schemas/AWSCcmConfigValidationResponse"
+          description: AWS CCM Config validation result
+        "400":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Bad Request
+        "403":
+          $ref: "#/components/responses/ForbiddenResponse"
+        "429":
+          $ref: "#/components/responses/TooManyRequestsResponse"
+        "503":
+          content:
+            application/json:
+              schema:
+                $ref: "#/components/schemas/JSONAPIErrorResponse"
+          description: Service Unavailable
+      summary: Validate AWS CCM config
+      tags:
+        - AWS Integration
+      x-codegen-request-body-name: body
+      "x-permission":
+        operator: OR
+        permissions:
+          - cloud_cost_management_read
+          - cloud_cost_management_write
+      x-unstable: |-
+        **Note**: This endpoint is in Preview and may be subject to change.
+        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 account.

examples/v2_aws-integration_ValidateAWSCCMConfig.rs

@@ -0,0 +1,30 @@
+// Validate AWS CCM config returns "AWS CCM Config validation result" response
+use datadog_api_client::datadog;
+use datadog_api_client::datadogV2::api_aws_integration::AWSIntegrationAPI;
+use datadog_api_client::datadogV2::model::AWSCcmConfigValidationRequest;
+use datadog_api_client::datadogV2::model::AWSCcmConfigValidationRequestAttributes;
+use datadog_api_client::datadogV2::model::AWSCcmConfigValidationRequestData;
+use datadog_api_client::datadogV2::model::AWSCcmConfigValidationType;
+
+#[tokio::main]
+async fn main() {
+    let body = AWSCcmConfigValidationRequest::new(AWSCcmConfigValidationRequestData::new(
+        AWSCcmConfigValidationRequestAttributes::new(
+            "123456789012".to_string(),
+            "billing".to_string(),
+            "us-east-1".to_string(),
+            "cost-and-usage-report".to_string(),
+        )
+        .report_prefix("reports".to_string()),
+        AWSCcmConfigValidationType::CCM_CONFIG_VALIDATION,
+    ));
+    let mut configuration = datadog::Configuration::new();
+    configuration.set_unstable_operation_enabled("v2.ValidateAWSCCMConfig", true);
+    let api = AWSIntegrationAPI::with_config(configuration);
+    let resp = api.validate_awsccm_config(body).await;
+    if let Ok(value) = resp {
+        println!("{:#?}", value);
+    } else {
+        println!("{:#?}", resp.unwrap_err());
+    }
+}

src/datadog/configuration.rs

@@ -511,6 +511,7 @@ impl Default for Configuration {
             ("v2.delete_aws_account_ccm_config".to_owned(), false),
             ("v2.get_aws_account_ccm_config".to_owned(), false),
             ("v2.update_aws_account_ccm_config".to_owned(), false),
+            ("v2.validate_awsccm_config".to_owned(), false),
             ("v2.create_jira_issue_template".to_owned(), false),
             ("v2.delete_jira_account".to_owned(), false),
             ("v2.delete_jira_issue_template".to_owned(), false),