datadog_api_client 2.43.0 → 2.44.0

data/lib/datadog_api_client/v2/api/security_monitoring_api.rb

@@ -584,7 +584,7 @@ module DatadogAPIClient::V2
     #
     # Create a new notification rule for security signals and return the created rule.
     #
-    # @param body [CreateNotificationRuleParameters] The body of the create notification rule request is composed of the rule type and the rule attributes: the rule name, the selectors, the notification targets, and the rule enabled status. 
+    # @param body [CreateNotificationRuleParameters] The body of the create notification rule request is composed of the rule type and the rule attributes: the rule name, the selectors, the notification targets, and the rule enabled status.
     # @param opts [Hash] the optional parameters
     # @return [Array<(NotificationRuleResponse, Integer, Hash)>] NotificationRuleResponse data, response status code and response headers
     def create_signal_notification_rule_with_http_info(body, opts = {})
@@ -651,7 +651,7 @@ module DatadogAPIClient::V2
     #
     # Create a new notification rule for security vulnerabilities and return the created rule.
     #
-    # @param body [CreateNotificationRuleParameters] The body of the create notification rule request is composed of the rule type and the rule attributes: the rule name, the selectors, the notification targets, and the rule enabled status. 
+    # @param body [CreateNotificationRuleParameters] The body of the create notification rule request is composed of the rule type and the rule attributes: the rule name, the selectors, the notification targets, and the rule enabled status.
     # @param opts [Hash] the optional parameters
     # @return [Array<(NotificationRuleResponse, Integer, Hash)>] NotificationRuleResponse data, response status code and response headers
     def create_vulnerability_notification_rule_with_http_info(body, opts = {})
@@ -1758,11 +1758,11 @@ module DatadogAPIClient::V2
     #
     # Get a single SBOM related to an asset by its type and name.
     #
-    #
     # @param asset_type [AssetType] The type of the asset for the SBOM request.
     # @param filter_asset_name [String] The name of the asset for the SBOM request.
     # @param opts [Hash] the optional parameters
     # @option opts [String] :filter_repo_digest The container image `repo_digest` for the SBOM request. When the requested asset type is 'Image', this filter is mandatory.
+    # @option opts [SBOMFormat] :ext_format The standard of the SBOM.
     # @return [Array<(GetSBOMResponse, Integer, Hash)>] GetSBOMResponse data, response status code and response headers
     def get_sbom_with_http_info(asset_type, filter_asset_name, opts = {})
       unstable_enabled = @api_client.config.unstable_operations["v2.get_sbom".to_sym]
@@ -1788,6 +1788,10 @@ module DatadogAPIClient::V2
       if @api_client.config.client_side_validation && filter_asset_name.nil?
         fail ArgumentError, "Missing the required parameter 'filter_asset_name' when calling SecurityMonitoringAPI.get_sbom"
       end
+      allowable_values = ['CycloneDX', 'SPDX']
+      if @api_client.config.client_side_validation && opts[:'ext_format'] && !allowable_values.include?(opts[:'ext_format'])
+        fail ArgumentError, "invalid value for \"ext_format\", must be one of #{allowable_values}"
+      end
       # resource path
       local_var_path = '/api/v2/security/sboms/{asset_type}'.sub('{asset_type}', CGI.escape(asset_type.to_s).gsub('%2F', '/'))
 
@@ -1795,6 +1799,7 @@ module DatadogAPIClient::V2
       query_params = opts[:query_params] || {}
       query_params[:'filter[asset_name]'] = filter_asset_name
       query_params[:'filter[repo_digest]'] = opts[:'filter_repo_digest'] if !opts[:'filter_repo_digest'].nil?
+      query_params[:'ext:format'] = opts[:'ext_format'] if !opts[:'ext_format'].nil?
 
       # header parameters
       header_params = opts[:header_params] || {}
@@ -2797,7 +2802,6 @@ module DatadogAPIClient::V2
     # - `evaluation_changed_at` and `resource_discovery_date` time stamps.
     # - An array of associated tags.
     #
-    #
     # @param opts [Hash] the optional parameters
     # @option opts [Integer] :page_limit Limit the number of findings returned. Must be <= 1000.
     # @option opts [Integer] :snapshot_timestamp Return findings for a given snapshot of time (Unix ms).
@@ -2995,6 +2999,134 @@ module DatadogAPIClient::V2
       return data, status_code, headers
     end
 
+    # List scanned assets metadata.
+    #
+    # @see #list_scanned_assets_metadata_with_http_info
+    def list_scanned_assets_metadata(opts = {})
+      data, _status_code, _headers = list_scanned_assets_metadata_with_http_info(opts)
+      data
+    end
+
+    # List scanned assets metadata.
+    #
+    # Get a list of security scanned assets metadata for an organization.
+    #
+    # ### Pagination
+    #
+    # For the "List Vulnerabilities" endpoint, see the [Pagination section](#pagination).
+    #
+    # ### Filtering
+    #
+    # For the "List Vulnerabilities" endpoint, see the [Filtering section](#filtering).
+    #
+    # ### Metadata
+    #
+    #  For the "List Vulnerabilities" endpoint, see the [Metadata section](#metadata).
+    #
+    # ### Related endpoints
+    #
+    # This endpoint returns additional metadata for cloud resources that is not available from the standard resource endpoints. To access a richer dataset, call this endpoint together with the relevant resource endpoint(s) and merge (join) their results using the resource identifier.
+    #
+    # **Hosts**
+    #
+    # To enrich host data, join the response from the [Hosts](https://docs.datadoghq.com/api/latest/hosts/) endpoint with the response from the scanned-assets-metadata endpoint on the following key fields:
+    #
+    # | ENDPOINT | JOIN KEY | TYPE |
+    # | --- | --- | --- |
+    # | [/api/v1/hosts](https://docs.datadoghq.com/api/latest/hosts/) | host_list.host_name | string |
+    # | /api/v2/security/scanned-assets-metadata | data.attributes.asset.name | string |
+    #
+    # **Host Images**
+    #
+    # To enrich host image data, join the response from the [Hosts](https://docs.datadoghq.com/api/latest/hosts/) endpoint with the response from the scanned-assets-metadata endpoint on the following key fields:
+    #
+    # | ENDPOINT | JOIN KEY | TYPE |
+    # | --- | --- | --- |
+    # | [/api/v1/hosts](https://docs.datadoghq.com/api/latest/hosts/) | host_list.tags_by_source["Amazon Web Services"]["image"] | string |
+    # | /api/v2/security/scanned-assets-metadata | data.attributes.asset.name | string |
+    #
+    # **Container Images**
+    #
+    # To enrich container image data, join the response from the [Container Images](https://docs.datadoghq.com/api/latest/container-images/) endpoint with the response from the scanned-assets-metadata endpoint on the following key fields:
+    #
+    # | ENDPOINT | JOIN KEY | TYPE |
+    # | --- | --- | --- |
+    # | [/api/v2/container_images](https://docs.datadoghq.com/api/latest/container-images/) | `data.attributes.name`@`data.attributes.repo_digest` | string |
+    # | /api/v2/security/scanned-assets-metadata | data.attributes.asset.name | string |
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [String] :page_token Its value must come from the `links` section of the response of the first request. Do not manually edit it.
+    # @option opts [Integer] :page_number The page number to be retrieved. It should be equal to or greater than 1.
+    # @option opts [CloudAssetType] :filter_asset_type The type of the scanned asset.
+    # @option opts [String] :filter_asset_name The name of the scanned asset.
+    # @option opts [String] :filter_last_success_origin The origin of last success scan.
+    # @option opts [String] :filter_last_success_env The environment of last success scan.
+    # @return [Array<(ScannedAssetsMetadata, Integer, Hash)>] ScannedAssetsMetadata data, response status code and response headers
+    def list_scanned_assets_metadata_with_http_info(opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.list_scanned_assets_metadata".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.list_scanned_assets_metadata")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.list_scanned_assets_metadata"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: SecurityMonitoringAPI.list_scanned_assets_metadata ...'
+      end
+      if @api_client.config.client_side_validation && !opts[:'page_number'].nil? && opts[:'page_number'] < 1
+        fail ArgumentError, 'invalid value for "opts[:"page_number"]" when calling SecurityMonitoringAPI.list_scanned_assets_metadata, must be greater than or equal to 1.'
+      end
+      allowable_values = ['Host', 'HostImage', 'Image']
+      if @api_client.config.client_side_validation && opts[:'filter_asset_type'] && !allowable_values.include?(opts[:'filter_asset_type'])
+        fail ArgumentError, "invalid value for \"filter_asset_type\", must be one of #{allowable_values}"
+      end
+      # resource path
+      local_var_path = '/api/v2/security/scanned-assets-metadata'
+
+      # query parameters
+      query_params = opts[:query_params] || {}
+      query_params[:'page[token]'] = opts[:'page_token'] if !opts[:'page_token'].nil?
+      query_params[:'page[number]'] = opts[:'page_number'] if !opts[:'page_number'].nil?
+      query_params[:'filter[asset.type]'] = opts[:'filter_asset_type'] if !opts[:'filter_asset_type'].nil?
+      query_params[:'filter[asset.name]'] = opts[:'filter_asset_name'] if !opts[:'filter_asset_name'].nil?
+      query_params[:'filter[last_success.origin]'] = opts[:'filter_last_success_origin'] if !opts[:'filter_last_success_origin'].nil?
+      query_params[:'filter[last_success.env]'] = opts[:'filter_last_success_env'] if !opts[:'filter_last_success_env'].nil?
+
+      # 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] || 'ScannedAssetsMetadata'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth]
+
+      new_options = opts.merge(
+        :operation => :list_scanned_assets_metadata,
+        :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: SecurityMonitoringAPI#list_scanned_assets_metadata\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
     # Get all security filters.
     #
     # @see #list_security_filters_with_http_info
@@ -3419,6 +3551,8 @@ module DatadogAPIClient::V2
     #
     # This token can then be used in the subsequent paginated requests.
     #
+    # *Note: The first request may take longer to complete than subsequent requests.*
+    #
     # #### Subsequent requests
     #
     # Any request containing valid `page[token]` and `page[number]` parameters will be considered a subsequent request.
@@ -3427,6 +3561,8 @@ module DatadogAPIClient::V2
     #
     # If the page `number` is invalid, a `400` response will be returned.
     #
+    # The returned `token` is valid for all requests in the pagination sequence. To send paginated requests in parallel, reuse the same `token` and change only the `page[number]` parameter.
+    #
     # ### Filtering
     #
     # The request can include some filter parameters to filter the data to be retrieved. The format of the filter parameters follows the [JSON:API format](https://jsonapi.org/format/#fetching-filtering): `filter[$prop_name]`, where `prop_name` is the property name in the entity being filtered by.
@@ -3458,7 +3594,11 @@ module DatadogAPIClient::V2
     #   "links": {...}
     # }
     # ```
+    # ### Extensions
     #
+    # Requests may include extensions to modify the behavior of the requested endpoint. The filter parameters follow the [JSON:API format](https://jsonapi.org/extensions/#extensions) format: `ext:$extension_name`, where `extension_name` is the name of the modifier that is being applied.
+    #
+    # Extensions can only include one value: `ext:modifier=value`.
     #
     # @param opts [Hash] the optional parameters
     # @option opts [String] :page_token Its value must come from the `links` section of the response of the first request. Do not manually edit it.
@@ -3488,7 +3628,7 @@ module DatadogAPIClient::V2
     # @option opts [Boolean] :filter_fix_available Filter by fix availability.
     # @option opts [String] :filter_repo_digests Filter by vulnerability `repo_digest` (when the vulnerability is related to `Image` asset).
     # @option opts [String] :filter_origin Filter by origin.
-    # @option opts [String] :filter_asset_name Filter by asset name.
+    # @option opts [String] :filter_asset_name Filter by asset name. This field supports the usage of wildcards (*).
     # @option opts [AssetType] :filter_asset_type Filter by asset type.
     # @option opts [String] :filter_asset_version_first Filter by the first version of the asset this vulnerability has been detected on.
     # @option opts [String] :filter_asset_version_last Filter by the last version of the asset this vulnerability has been detected on.
@@ -3586,7 +3726,7 @@ module DatadogAPIClient::V2
       query_params[:'filter[tool]'] = opts[:'filter_tool'] if !opts[:'filter_tool'].nil?
       query_params[:'filter[library.name]'] = opts[:'filter_library_name'] if !opts[:'filter_library_name'].nil?
       query_params[:'filter[library.version]'] = opts[:'filter_library_version'] if !opts[:'filter_library_version'].nil?
-      query_params[:'filter[advisory_id]'] = opts[:'filter_advisory_id'] if !opts[:'filter_advisory_id'].nil?
+      query_params[:'filter[advisory.id]'] = opts[:'filter_advisory_id'] if !opts[:'filter_advisory_id'].nil?
       query_params[:'filter[risks.exploitation_probability]'] = opts[:'filter_risks_exploitation_probability'] if !opts[:'filter_risks_exploitation_probability'].nil?
       query_params[:'filter[risks.poc_exploit_available]'] = opts[:'filter_risks_poc_exploit_available'] if !opts[:'filter_risks_poc_exploit_available'].nil?
       query_params[:'filter[risks.exploit_available]'] = opts[:'filter_risks_exploit_available'] if !opts[:'filter_risks_exploit_available'].nil?
@@ -3675,11 +3815,10 @@ module DatadogAPIClient::V2
     #
     # Please review the [Metadata section for the "List Vulnerabilities"](#metadata) endpoint.
     #
-    #
     # @param opts [Hash] the optional parameters
     # @option opts [String] :page_token Its value must come from the `links` section of the response of the first request. Do not manually edit it.
     # @option opts [Integer] :page_number The page number to be retrieved. It should be equal or greater than `1`
-    # @option opts [String] :filter_name Filter by name.
+    # @option opts [String] :filter_name Filter by name. This field supports the usage of wildcards (*).
     # @option opts [AssetType] :filter_type Filter by type.
     # @option opts [String] :filter_version_first Filter by the first version of the asset since it has been vulnerable.
     # @option opts [String] :filter_version_last Filter by the last detected version of the asset.
@@ -3714,7 +3853,7 @@ module DatadogAPIClient::V2
         fail ArgumentError, "invalid value for \"filter_type\", must be one of #{allowable_values}"
       end
       # resource path
-      local_var_path = '/api/v2/security/assets'
+      local_var_path = '/api/v2/security/vulnerable-assets'
 
       # query parameters
       query_params = opts[:query_params] || {}
@@ -3783,7 +3922,7 @@ module DatadogAPIClient::V2
     #
     # Mute or unmute findings.
     #
-    # @param body [BulkMuteFindingsRequest] ### Attributes  All findings are updated with the same attributes. The request body must include at least two attributes: `muted` and `reason`. The allowed reasons depend on whether the finding is being muted or unmuted:   - To mute a finding: `PENDING_FIX`, `FALSE_POSITIVE`, `ACCEPTED_RISK`, `OTHER`.   - To unmute a finding : `NO_PENDING_FIX`, `HUMAN_ERROR`, `NO_LONGER_ACCEPTED_RISK`, `OTHER`.  ### Meta  The request body must include a list of the finding IDs to be updated. 
+    # @param body [BulkMuteFindingsRequest] ### Attributes  All findings are updated with the same attributes. The request body must include at least two attributes: `muted` and `reason`. The allowed reasons depend on whether the finding is being muted or unmuted:   - To mute a finding: `PENDING_FIX`, `FALSE_POSITIVE`, `ACCEPTED_RISK`, `OTHER`.   - To unmute a finding : `NO_PENDING_FIX`, `HUMAN_ERROR`, `NO_LONGER_ACCEPTED_RISK`, `OTHER`.  ### Meta  The request body must include a list of the finding IDs to be updated.
     # @param opts [Hash] the optional parameters
     # @return [Array<(BulkMuteFindingsResponse, Integer, Hash)>] BulkMuteFindingsResponse data, response status code and response headers
     def mute_findings_with_http_info(body, opts = {})

data/lib/datadog_api_client/v2/api/static_analysis_api.rb

@@ -0,0 +1,166 @@
+=begin
+#Datadog API V2 Collection
+
+#Collection of all Datadog Public endpoints.
+
+The version of the OpenAPI document: 1.0
+Contact: support@datadoghq.com
+Generated by: https://github.com/DataDog/datadog-api-client-ruby/tree/master/.generator
+
+ Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+ This product includes software developed at Datadog (https://www.datadoghq.com/).
+ Copyright 2020-Present Datadog, Inc.
+
+=end
+
+require 'cgi'
+
+module DatadogAPIClient::V2
+  class StaticAnalysisAPI
+    attr_accessor :api_client
+
+    def initialize(api_client = DatadogAPIClient::APIClient.default)
+      @api_client = api_client
+    end
+
+    # POST request to resolve vulnerable symbols.
+    #
+    # @see #create_sca_resolve_vulnerable_symbols_with_http_info
+    def create_sca_resolve_vulnerable_symbols(body, opts = {})
+      data, _status_code, _headers = create_sca_resolve_vulnerable_symbols_with_http_info(body, opts)
+      data
+    end
+
+    # POST request to resolve vulnerable symbols.
+    # @param body [ResolveVulnerableSymbolsRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(ResolveVulnerableSymbolsResponse, Integer, Hash)>] ResolveVulnerableSymbolsResponse data, response status code and response headers
+    def create_sca_resolve_vulnerable_symbols_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.create_sca_resolve_vulnerable_symbols".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.create_sca_resolve_vulnerable_symbols")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.create_sca_resolve_vulnerable_symbols"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: StaticAnalysisAPI.create_sca_resolve_vulnerable_symbols ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling StaticAnalysisAPI.create_sca_resolve_vulnerable_symbols"
+      end
+      # resource path
+      local_var_path = '/api/v2/static-analysis-sca/vulnerabilities/resolve-vulnerable-symbols'
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'ResolveVulnerableSymbolsResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :create_sca_resolve_vulnerable_symbols,
+        :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::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: StaticAnalysisAPI#create_sca_resolve_vulnerable_symbols\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Post dependencies for analysis.
+    #
+    # @see #create_sca_result_with_http_info
+    def create_sca_result(body, opts = {})
+      create_sca_result_with_http_info(body, opts)
+      nil
+    end
+
+    # Post dependencies for analysis.
+    # @param body [ScaRequest] 
+    # @param opts [Hash] the optional parameters
+    # @return [Array<(nil, Integer, Hash)>] nil, response status code and response headers
+    def create_sca_result_with_http_info(body, opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.create_sca_result".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.create_sca_result")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.create_sca_result"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: StaticAnalysisAPI.create_sca_result ...'
+      end
+      # verify the required parameter 'body' is set
+      if @api_client.config.client_side_validation && body.nil?
+        fail ArgumentError, "Missing the required parameter 'body' when calling StaticAnalysisAPI.create_sca_result"
+      end
+      # resource path
+      local_var_path = '/api/v2/static-analysis-sca/dependencies'
+
+      # 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(['*/*'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(body)
+
+      # return_type
+      return_type = opts[:debug_return_type]
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :create_sca_result,
+        :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::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: StaticAnalysisAPI#create_sca_result\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+  end
+end

data/lib/datadog_api_client/v2/api/test_optimization_api.rb

@@ -0,0 +1,116 @@
+=begin
+#Datadog API V2 Collection
+
+#Collection of all Datadog Public endpoints.
+
+The version of the OpenAPI document: 1.0
+Contact: support@datadoghq.com
+Generated by: https://github.com/DataDog/datadog-api-client-ruby/tree/master/.generator
+
+ Unless explicitly stated otherwise all files in this repository are licensed under the Apache-2.0 License.
+ This product includes software developed at Datadog (https://www.datadoghq.com/).
+ Copyright 2020-Present Datadog, Inc.
+
+=end
+
+require 'cgi'
+
+module DatadogAPIClient::V2
+  class TestOptimizationAPI
+    attr_accessor :api_client
+
+    def initialize(api_client = DatadogAPIClient::APIClient.default)
+      @api_client = api_client
+    end
+
+    # Search flaky tests.
+    #
+    # @see #search_flaky_tests_with_http_info
+    def search_flaky_tests(opts = {})
+      data, _status_code, _headers = search_flaky_tests_with_http_info(opts)
+      data
+    end
+
+    # Search flaky tests.
+    #
+    # List endpoint returning flaky tests from Flaky Test Management. Results are paginated.
+    #
+    # @param opts [Hash] the optional parameters
+    # @option opts [FlakyTestsSearchRequest] :body 
+    # @return [Array<(FlakyTestsSearchResponse, Integer, Hash)>] FlakyTestsSearchResponse data, response status code and response headers
+    def search_flaky_tests_with_http_info(opts = {})
+      unstable_enabled = @api_client.config.unstable_operations["v2.search_flaky_tests".to_sym]
+      if unstable_enabled
+        @api_client.config.logger.warn format("Using unstable operation '%s'", "v2.search_flaky_tests")
+      else
+        raise DatadogAPIClient::APIError.new(message: format("Unstable operation '%s' is disabled", "v2.search_flaky_tests"))
+      end
+
+      if @api_client.config.debugging
+        @api_client.config.logger.debug 'Calling API: TestOptimizationAPI.search_flaky_tests ...'
+      end
+      # resource path
+      local_var_path = '/api/v2/test/flaky-test-management/tests'
+
+      # 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'])
+      # HTTP header 'Content-Type'
+      header_params['Content-Type'] = @api_client.select_header_content_type(['application/json'])
+
+      # form parameters
+      form_params = opts[:form_params] || {}
+
+      # http body (model)
+      post_body = opts[:debug_body] || @api_client.object_to_http_body(opts[:'body'])
+
+      # return_type
+      return_type = opts[:debug_return_type] || 'FlakyTestsSearchResponse'
+
+      # auth_names
+      auth_names = opts[:debug_auth_names] || [:apiKeyAuth, :appKeyAuth, :AuthZ]
+
+      new_options = opts.merge(
+        :operation => :search_flaky_tests,
+        :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::Post, local_var_path, new_options)
+      if @api_client.config.debugging
+        @api_client.config.logger.debug "API called: TestOptimizationAPI#search_flaky_tests\nData: #{data.inspect}\nStatus code: #{status_code}\nHeaders: #{headers}"
+      end
+      return data, status_code, headers
+    end
+
+    # Search flaky tests.
+    #
+    # Provide a paginated version of {#search_flaky_tests}, returning all items.
+    #
+    # To use it you need to use a block: search_flaky_tests_with_pagination { |item| p item }
+    #
+    # @yield [FlakyTest] Paginated items
+    def search_flaky_tests_with_pagination(opts = {})
+        api_version = "V2"
+        page_size = @api_client.get_attribute_from_path(opts, "body.data.attributes.page.limit", 10)
+        @api_client.set_attribute_from_path(api_version, opts, "body.data.attributes.page.limit", FlakyTestsSearchRequest, page_size)
+        while true do
+            response = search_flaky_tests(opts)
+            @api_client.get_attribute_from_path(response, "data").each { |item| yield(item) }
+            if @api_client.get_attribute_from_path(response, "data").length < page_size
+              break
+            end
+            @api_client.set_attribute_from_path(api_version, opts, "body.data.attributes.page.cursor", FlakyTestsSearchRequest, @api_client.get_attribute_from_path(response, "meta.pagination.next_page"))
+        end
+    end
+  end
+end

data/lib/datadog_api_client/v2/models/arbitrary_rule_response_array.rb

@@ -24,13 +24,17 @@ module DatadogAPIClient::V2
     # The `ArbitraryRuleResponseArray` `data`.
     attr_reader :data
 
+    # The `ArbitraryRuleResponseArray` `meta`.
+    attr_accessor :meta
+
     attr_accessor :additional_properties
 
     # Attribute mapping from ruby-style variable name to JSON key.
     # @!visibility private
     def self.attribute_map
       {
-        :'data' => :'data'
+        :'data' => :'data',
+        :'meta' => :'meta'
       }
     end
 
@@ -38,7 +42,8 @@ module DatadogAPIClient::V2
     # @!visibility private
     def self.openapi_types
       {
-        :'data' => :'Array<ArbitraryRuleResponseData>'
+        :'data' => :'Array<ArbitraryRuleResponseData>',
+        :'meta' => :'ArbitraryRuleResponseArrayMeta'
       }
     end
 
@@ -65,6 +70,10 @@ module DatadogAPIClient::V2
           self.data = value
         end
       end
+
+      if attributes.key?(:'meta')
+        self.meta = attributes[:'meta']
+      end
     end
 
     # Check to see if the all the properties in the model are valid
@@ -112,6 +121,7 @@ module DatadogAPIClient::V2
       return true if self.equal?(o)
       self.class == o.class &&
           data == o.data &&
+          meta == o.meta &&
           additional_properties == o.additional_properties
     end
 
@@ -119,7 +129,7 @@ module DatadogAPIClient::V2
     # @return [Integer] Hash code
     # @!visibility private
     def hash
-      [data, additional_properties].hash
+      [data, meta, additional_properties].hash
     end
   end
 end