Add API spec for AWS Integrations standard and resource collection IAM permissions (DataDog#2674)

api-clients-generation-pipeline[bot] · ci.datadog-api-spec · web-flow · commit aa275e4d0d9f · 2025-09-23T18:35:08.000Z
Co-authored-by: ci.datadog-api-spec &lt;packages@datadoghq.com&gt;
diff --git a/.generator/schemas/v2/openapi.yaml b/.generator/schemas/v2/openapi.yaml
@@ -59638,6 +59638,39 @@ paths:
       summary: Get AWS integration IAM permissions
       tags:
       - AWS Integration
+  /api/v2/integration/aws/iam_permissions/resource_collection:
+    get:
+      description: Get all resource collection AWS IAM permissions required for the
+        AWS integration.
+      operationId: GetAWSIntegrationIAMPermissionsResourceCollection
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AWSIntegrationIamPermissionsResponse'
+          description: AWS integration resource collection IAM permissions.
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Get resource collection IAM permissions
+      tags:
+      - AWS Integration
+  /api/v2/integration/aws/iam_permissions/standard:
+    get:
+      description: Get all standard AWS IAM permissions required for the AWS integration.
+      operationId: GetAWSIntegrationIAMPermissionsStandard
+      responses:
+        '200':
+          content:
+            application/json:
+              schema:
+                $ref: '#/components/schemas/AWSIntegrationIamPermissionsResponse'
+          description: AWS integration standard IAM permissions.
+        '429':
+          $ref: '#/components/responses/TooManyRequestsResponse'
+      summary: Get AWS integration standard IAM permissions
+      tags:
+      - AWS Integration
   /api/v2/integration/aws/logs/services:
     get:
       description: Get a list of AWS services that can send logs to Datadog.
diff --git a/cassettes/features/v2/aws_integration/Get-AWS-integration-standard-IAM-permissions-returns-AWS-IAM-Permissions-object-response.frozen b/cassettes/features/v2/aws_integration/Get-AWS-integration-standard-IAM-permissions-returns-AWS-IAM-Permissions-object-response.frozen
@@ -0,0 +1 @@
+2025-09-17T18:27:22.560Z
diff --git a/cassettes/features/v2/aws_integration/Get-AWS-integration-standard-IAM-permissions-returns-AWS-IAM-Permissions-object-response.yml b/cassettes/features/v2/aws_integration/Get-AWS-integration-standard-IAM-permissions-returns-AWS-IAM-Permissions-object-response.yml
diff --git a/cassettes/features/v2/aws_integration/Get-resource-collection-IAM-permissions-returns-AWS-IAM-Permissions-object-response.frozen b/cassettes/features/v2/aws_integration/Get-resource-collection-IAM-permissions-returns-AWS-IAM-Permissions-object-response.frozen
@@ -0,0 +1 @@
+2025-09-17T18:27:22.885Z
diff --git a/cassettes/features/v2/aws_integration/Get-resource-collection-IAM-permissions-returns-AWS-IAM-Permissions-object-response.yml b/cassettes/features/v2/aws_integration/Get-resource-collection-IAM-permissions-returns-AWS-IAM-Permissions-object-response.yml
diff --git a/examples/v2/aws-integration/GetAWSIntegrationIAMPermissionsResourceCollection.rb b/examples/v2/aws-integration/GetAWSIntegrationIAMPermissionsResourceCollection.rb
@@ -0,0 +1,5 @@
+# Get resource collection IAM permissions returns "AWS integration resource collection IAM permissions." response
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V2::AWSIntegrationAPI.new
+p api_instance.get_aws_integration_iam_permissions_resource_collection()
diff --git a/examples/v2/aws-integration/GetAWSIntegrationIAMPermissionsResourceCollection_1008672547.rb b/examples/v2/aws-integration/GetAWSIntegrationIAMPermissionsResourceCollection_1008672547.rb
@@ -0,0 +1,5 @@
+# Get resource collection IAM permissions returns "AWS IAM Permissions object" response
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V2::AWSIntegrationAPI.new
+p api_instance.get_aws_integration_iam_permissions_resource_collection()
diff --git a/examples/v2/aws-integration/GetAWSIntegrationIAMPermissionsStandard.rb b/examples/v2/aws-integration/GetAWSIntegrationIAMPermissionsStandard.rb
@@ -0,0 +1,5 @@
+# Get AWS integration standard IAM permissions returns "AWS integration standard IAM permissions." response
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V2::AWSIntegrationAPI.new
+p api_instance.get_aws_integration_iam_permissions_standard()
diff --git a/examples/v2/aws-integration/GetAWSIntegrationIAMPermissionsStandard_3136299151.rb b/examples/v2/aws-integration/GetAWSIntegrationIAMPermissionsStandard_3136299151.rb
@@ -0,0 +1,5 @@
+# Get AWS integration standard IAM permissions returns "AWS IAM Permissions object" response
+
+require "datadog_api_client"
+api_instance = DatadogAPIClient::V2::AWSIntegrationAPI.new
+p api_instance.get_aws_integration_iam_permissions_standard()
diff --git a/features/v2/aws_integration.feature b/features/v2/aws_integration.feature
@@ -79,6 +79,18 @@ Feature: AWS Integration
     When the request is sent
     Then the response status is 200 AWS IAM Permissions object
 
+  @team:DataDog/aws-integrations
+  Scenario: Get AWS integration standard IAM permissions returns "AWS IAM Permissions object" response
+    Given new "GetAWSIntegrationIAMPermissionsStandard" request
+    When the request is sent
+    Then the response status is 200 AWS IAM Permissions object
+
+  @generated @skip @team:DataDog/aws-integrations
+  Scenario: Get AWS integration standard IAM permissions returns "AWS integration standard IAM permissions." response
+    Given new "GetAWSIntegrationIAMPermissionsStandard" request
+    When the request is sent
+    Then the response status is 200 AWS integration standard IAM permissions.
+
   @team:DataDog/aws-integrations
   Scenario: Get an AWS integration by config ID returns "AWS Account object" response
     Given there is a valid "aws_account_v2" in the system
@@ -101,6 +113,18 @@ Feature: AWS Integration
     When the request is sent
     Then the response status is 404 Not Found
 
+  @team:DataDog/aws-integrations
+  Scenario: Get resource collection IAM permissions returns "AWS IAM Permissions object" response
+    Given new "GetAWSIntegrationIAMPermissionsResourceCollection" request
+    When the request is sent
+    Then the response status is 200 AWS IAM Permissions object
+
+  @generated @skip @team:DataDog/aws-integrations
+  Scenario: Get resource collection IAM permissions returns "AWS integration resource collection IAM permissions." response
+    Given new "GetAWSIntegrationIAMPermissionsResourceCollection" request
+    When the request is sent
+    Then the response status is 200 AWS integration resource collection IAM permissions.
+
   @team:DataDog/aws-integrations
   Scenario: List all AWS integrations returns "AWS Accounts List object" response
     Given new "ListAWSAccounts" request
diff --git a/features/v2/undo.json b/features/v2/undo.json
@@ -1529,6 +1529,18 @@
       "type": "safe"
     }
   },
+  "GetAWSIntegrationIAMPermissionsResourceCollection": {
+    "tag": "AWS Integration",
+    "undo": {
+      "type": "safe"
+    }
+  },
+  "GetAWSIntegrationIAMPermissionsStandard": {
+    "tag": "AWS Integration",
+    "undo": {
+      "type": "safe"
+    }
+  },
   "ListAWSLogsServices": {
     "tag": "AWS Logs Integration",
     "undo": {
diff --git a/lib/datadog_api_client/v2/api/aws_integration_api.rb b/lib/datadog_api_client/v2/api/aws_integration_api.rb
@@ -340,6 +340,126 @@ def get_aws_integration_iam_permissions_with_http_info(opts = {})
       return data, status_code, headers
     end
 
+    # Get resource collection IAM permissions.
+    #
+    # @see #get_aws_integration_iam_permissions_resource_collection_with_http_info
+    def get_aws_integration_iam_permissions_resource_collection(opts = {})
+      data, _status_code, _headers = get_aws_integration_iam_permissions_resource_collection_with_http_info(opts)
+      data
+    end
+
+    # Get resource collection IAM permissions.
+    #
+    # Get all resource collection AWS IAM permissions required for the AWS integration.
+    #
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(AWSIntegrationIamPermissionsResponse, Integer, Hash)>] AWSIntegrationIamPermissionsResponse data, response status code and response headers
+    def get_aws_integration_iam_permissions_resource_collection_with_http_info(opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AWSIntegrationAPI.get_aws_integration_iam_permissions_resource_collection ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/integration/aws/iam_permissions/resource_collection'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AWSIntegrationIamPermissionsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :get_aws_integration_iam_permissions_resource_collection,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AWSIntegrationAPI#get_aws_integration_iam_permissions_resource_collection\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Get AWS integration standard IAM permissions.
+    #
+    # @see #get_aws_integration_iam_permissions_standard_with_http_info
+    def get_aws_integration_iam_permissions_standard(opts = {})
+      data, _status_code, _headers = get_aws_integration_iam_permissions_standard_with_http_info(opts)
+      data
+    end
+
+    # Get AWS integration standard IAM permissions.
+    #
+    # Get all standard AWS IAM permissions required for the AWS integration.
+    #
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(AWSIntegrationIamPermissionsResponse, Integer, Hash)>] AWSIntegrationIamPermissionsResponse data, response status code and response headers
+    def get_aws_integration_iam_permissions_standard_with_http_info(opts = {})
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: AWSIntegrationAPI.get_aws_integration_iam_permissions_standard ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/integration/aws/iam_permissions/standard'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+
+      # header parameters
+      header_params = opts[:header_params] || {}
+      # HTTP header 'Accept' (if needed)
+      header_params['Accept'] = @api_client.select_header_accept(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body]
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'AWSIntegrationIamPermissionsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :get_aws_integration_iam_permissions_standard,
+        :header_params => header_params,
+        :query_params => query_params,
+        :form_params => form_params,
+        :body => post_body,
+        :auth_names => auth_names,
+        :return_type => return_type,
+        :api_version => "V2"
+      )
+
+      data, status_code, headers = @api_client.call_api(Net::HTTP::Get, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: AWSIntegrationAPI#get_aws_integration_iam_permissions_standard\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # List all AWS integrations.
     #
     # @see #list_aws_accounts_with_http_info
