oci 2.17.0 → 2.18.0

data/lib/oci/vulnerability_scanning/vulnerability_scanning_client.rb

@@ -6,7 +6,7 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Use the Vulnerability Scanning Service (VSS) APIs to manage scan recipes, targets, and reports.
+  # Use the Vulnerability Scanning Service (VSS) API to manage scan recipes, targets, and reports. For more information, see [the Vulnerability Scanning documentation](/iaas/scanning/home.htm).
   class VulnerabilityScanning::VulnerabilityScanningClient
     # Client used to make HTTP requests.
     # @return [OCI::ApiClient]
@@ -737,7 +737,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new ContainerScanRecipe
+    # Creates a new ContainerScanRecipe. A recipe determines the types of security issues that you want scanned.
     #
     # @param [OCI::VulnerabilityScanning::Models::CreateContainerScanRecipeDetails] create_container_scan_recipe_details Details for the new ContainerScanRecipe
     # @param [Hash] opts the optional parameters
@@ -799,7 +799,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new ContainerScanTarget
+    # Creates a new ContainerScanTarget. A container scan target specifies a group of one or more Docker image repositories in Oracle Cloud Infrastructure Registry (OCIR) that you want routinely scanned for security vulnerabilities.
     #
     # @param [OCI::VulnerabilityScanning::Models::CreateContainerScanTargetDetails] create_container_scan_target_details Details for the new ContainerScanTarget
     # @param [Hash] opts the optional parameters
@@ -985,7 +985,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the ContainerScanRecipe identified by the id
+    # Deletes the ContainerScanRecipe identified by the recipe ID.
     #
     # @param [String] container_scan_recipe_id unique ContainerScanRecipe identifier
     # @param [Hash] opts the optional parameters
@@ -1046,7 +1046,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the ContainerScanResult identified by the id
+    # Deletes the ContainerScanResult identified by the container scan ID.
     #
     # @param [String] container_scan_result_id unique container scan identifier
     # @param [Hash] opts the optional parameters
@@ -1107,7 +1107,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the ContainerScanTarget identified by the id
+    # Deletes the ContainerScanTarget identified by the target ID.
     #
     # @param [String] container_scan_target_id unique ContainerScanTarget identifier
     # @param [Hash] opts the optional parameters
@@ -1168,7 +1168,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Removes the HostAgentScanResult identified by the host agent scan ID.
+    # Deletes the HostAgentScanResult identified by the host agent scan ID.
     #
     # @param [String] host_agent_scan_result_id unique host agent scan identifier
     # @param [Hash] opts the optional parameters
@@ -1229,7 +1229,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the HostCisBenchmarkScanResult identified by the id
+    # Deletes the HostCisBenchmarkScanResult identified by the benchmark scan result ID.
     #
     # @param [String] host_cis_benchmark_scan_result_id unique host Cis benchmark scan identifier
     # @param [Hash] opts the optional parameters
@@ -1351,7 +1351,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Removes the HostPortScanResult identified by the host port scan ID.
+    # Deletes the HostPortScanResult identified by the host port scan ID.
     #
     # @param [String] host_port_scan_result_id unique host port scan identifier
     # @param [Hash] opts the optional parameters
@@ -1412,7 +1412,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Removes the HostScanRecipe identified by the recipe ID.
+    # Deletes the HostScanRecipe identified by the recipe ID.
     #
     # @param [String] host_scan_recipe_id unique HostScanRecipe identifier
     # @param [Hash] opts the optional parameters
@@ -1473,7 +1473,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Removes the HostScanTarget identified by the target ID.
+    # Deletes the HostScanTarget identified by the target ID.
     #
     # @param [String] host_scan_target_id unique HostScanTarget identifier
     # @param [Hash] opts the optional parameters
@@ -1734,7 +1734,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets a ContainerScanRecipe by identifier
+    # Retrieves a ContainerScanRecipe identified by the recipe ID. A recipe determines the types of security issues that you want scanned.
     #
     # @param [String] container_scan_recipe_id unique ContainerScanRecipe identifier
     # @param [Hash] opts the optional parameters
@@ -1789,7 +1789,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Returns a ContainerScanResult of the given container scan ID.
+    # Retrieves a ContainerScanResult identified by the container scan ID. The result includes a list of problems found in a specific image in a Docker repository.
     #
     # @param [String] container_scan_result_id unique container scan identifier
     # @param [Hash] opts the optional parameters
@@ -1844,7 +1844,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets a ContainerScanTarget by identifier
+    # Gets a ContainerScanTarget identified by the target ID. A container scan target specifies a group of one or more Docker image repositories in Oracle Cloud Infrastructure Registry (OCIR) that you want routinely scanned for security vulnerabilities.
     #
     # @param [String] container_scan_target_id unique ContainerScanTarget identifier
     # @param [Hash] opts the optional parameters
@@ -1899,7 +1899,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Retrieves a HostAgentScanResult identified by the host agent scan ID. The result includes a list of problems detected in a specific compute instance.
+    # Retrieves a HostAgentScanResult identified by the host agent scan ID. The result includes a list of CVEs detected in a specific compute instance.
     #
     # @param [String] host_agent_scan_result_id unique host agent scan identifier
     # @param [Hash] opts the optional parameters
@@ -1954,7 +1954,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Returns HostCisBenchmarkScanResults for the given host CIS (Center for Internet Security) benchmark scan result ID.
+    # Retrieves a HostCisBenchmarkScanResult identified by the benchmark scan result ID. A CIS (Center for Internet Security) benchmark scan result includes a list of benchmarks that were tested on a specific compute instance, and whether each test passed or failed.
     #
     # @param [String] host_cis_benchmark_scan_result_id unique host Cis benchmark scan identifier
     # @param [Hash] opts the optional parameters
@@ -2284,6 +2284,61 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Retrieves a Vulnerability identified by the vulnerability ID. A vulnerability describes a security issue that was detected in scans of one or more compute instances, container scan repositories. Common Vulnerabilities and Exposures (CVE) numbers identify security vulnerabilities for operating systems and other software, including Critical Patch Updates and Security Alert advisories.
+    #
+    # @param [String] vulnerability_id unique vulnerability identifier
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type {OCI::VulnerabilityScanning::Models::Vulnerability Vulnerability}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/vulnerabilityscanning/get_vulnerability.rb.html) to see an example of how to use get_vulnerability API.
+    def get_vulnerability(vulnerability_id, opts = {})
+      logger.debug 'Calling operation VulnerabilityScanningClient#get_vulnerability.' if logger
+
+      raise "Missing the required parameter 'vulnerability_id' when calling get_vulnerability." if vulnerability_id.nil?
+      raise "Parameter value for 'vulnerability_id' must not be blank" if OCI::Internal::Util.blank_string?(vulnerability_id)
+
+      path = '/vulnerabilities/{vulnerabilityId}'.sub('{vulnerabilityId}', vulnerability_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'VulnerabilityScanningClient#get_vulnerability') do
+        @api_client.call_api(
+          :GET,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::VulnerabilityScanning::Models::Vulnerability'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
     # Gets the status of the work request with the given ID.
     #
     # @param [String] work_request_id The ID of the asynchronous request.
@@ -2339,7 +2394,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Returns a list of ContainerScanRecipeSummaries
+    # Retrieves a list of ContainerScanRecipeSummary objects in a compartment. A recipe determines the types of security issues that you want scanned.
     #
     # @param [String] compartment_id The ID of the compartment in which to list resources.
     # @param [Hash] opts the optional parameters
@@ -2419,7 +2474,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Returns a collection of ContainerScanResultSummary objects
+    # Retrieves a list of ContainerScanResultSummary objects in a compartment. You can filter and sort the results by problem severity and time. A container scan result includes a list of problems detected in a specific image in a Docker repository.
     #
     # @param [String] compartment_id The ID of the compartment in which to list resources.
     # @param [Hash] opts the optional parameters
@@ -2432,8 +2487,8 @@ module OCI
     # @option opts [DateTime] :time_started_greater_than_or_equal_to Date and time on or after which scans were started, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339)
     # @option opts [DateTime] :time_started_less_than_or_equal_to Date and time on or before which scans were started, as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339)
     # @option opts [String] :sort_order The sort order to use, either 'ASC' or 'DESC'. (default to ASC)
-    # @option opts [String] :sort_by The field to sort by. Only one sort order may be provided. Default order is descending. If no value is specified timeFinished is default.
-    #    (default to timeFinished)
+    # @option opts [String] :sort_by The field to sort by. Only one sort order may be provided. Default order is descending. If no value is specified timeStarted is default.
+    #    (default to timeStarted)
     # @option opts [Integer] :limit The maximum number of items to return. (default to 10)
     # @option opts [String] :page The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.
     # @option opts [String] :opc_request_id The client request ID for tracing.
@@ -2507,7 +2562,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Returns a list of ContainerScanTargetSummaries
+    # Retrieves a list of ContainerScanTargetSummary objects in a compartment. A container scan target specifies a group of one or more Docker image repositories in Oracle Cloud Infrastructure Registry (OCIR) that you want routinely scanned for security vulnerabilities.
     #
     # @param [String] compartment_id The ID of the compartment in which to list resources.
     # @param [Hash] opts the optional parameters
@@ -2587,7 +2642,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Retrieves a list of HostAgentScanResultSummary objects in a compartment. You can filter and sort the results by problem severity and time. An agent scan result includes a list of problems detected in a specific compute instance.
+    # Retrieves a list of HostAgentScanResultSummary objects in a compartment. You can filter and sort the results by problem severity and time. An agent scan result includes a list of CVEs detected in a specific compute instance.
     #
     # @param [String] compartment_id The ID of the compartment in which to list resources.
     # @param [Hash] opts the optional parameters
@@ -2605,6 +2660,7 @@ module OCI
     # @option opts [String] :page The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @option opts [String] :display_name A filter to return only resources that match the entire display name given.
+    # @option opts [BOOLEAN] :is_latest_only A flag to return only the latest scan result of an instance. (default to false)
     # @return [Response] A Response object with data of type {OCI::VulnerabilityScanning::Models::HostAgentScanResultSummaryCollection HostAgentScanResultSummaryCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/vulnerabilityscanning/list_host_agent_scan_results.rb.html) to see an example of how to use list_host_agent_scan_results API.
     def list_host_agent_scan_results(compartment_id, opts = {})
@@ -2641,6 +2697,7 @@ module OCI
       query_params[:limit] = opts[:limit] if opts[:limit]
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:displayName] = opts[:display_name] if opts[:display_name]
+      query_params[:isLatestOnly] = opts[:is_latest_only] if !opts[:is_latest_only].nil?
 
       # Header Params
       header_params = {}
@@ -2675,7 +2732,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Returns a collection of HostCisBenchmarkScanResultSummary objects
+    # Retrieves a list of HostCisBenchmarkScanResultSummary objects in a compartment. You can filter and sort the results by problem severity and time. A CIS (Center for Internet Security) benchmark scan result includes the number of failed benchmark tests on a specific compute instance.
     #
     # @param [String] compartment_id The ID of the compartment in which to list resources.
     # @param [Hash] opts the optional parameters
@@ -2692,6 +2749,7 @@ module OCI
     # @option opts [String] :page The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @option opts [String] :display_name A filter to return only resources that match the entire display name given.
+    # @option opts [BOOLEAN] :is_latest_only A flag to return only the latest scan result of an instance. (default to false)
     # @return [Response] A Response object with data of type {OCI::VulnerabilityScanning::Models::HostCisBenchmarkScanResultSummaryCollection HostCisBenchmarkScanResultSummaryCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/vulnerabilityscanning/list_host_cis_benchmark_scan_results.rb.html) to see an example of how to use list_host_cis_benchmark_scan_results API.
     def list_host_cis_benchmark_scan_results(compartment_id, opts = {})
@@ -2727,6 +2785,7 @@ module OCI
       query_params[:limit] = opts[:limit] if opts[:limit]
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:displayName] = opts[:display_name] if opts[:display_name]
+      query_params[:isLatestOnly] = opts[:is_latest_only] if !opts[:is_latest_only].nil?
 
       # Header Params
       header_params = {}
@@ -2778,6 +2837,7 @@ module OCI
     # @option opts [String] :page The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @option opts [String] :display_name A filter to return only resources that match the entire display name given.
+    # @option opts [BOOLEAN] :is_latest_only A flag to return only the latest scan result of an instance. (default to false)
     # @return [Response] A Response object with data of type {OCI::VulnerabilityScanning::Models::HostEndpointProtectionScanResultSummaryCollection HostEndpointProtectionScanResultSummaryCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/vulnerabilityscanning/list_host_endpoint_protection_scan_results.rb.html) to see an example of how to use list_host_endpoint_protection_scan_results API.
     def list_host_endpoint_protection_scan_results(compartment_id, opts = {})
@@ -2813,6 +2873,7 @@ module OCI
       query_params[:limit] = opts[:limit] if opts[:limit]
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:displayName] = opts[:display_name] if opts[:display_name]
+      query_params[:isLatestOnly] = opts[:is_latest_only] if !opts[:is_latest_only].nil?
 
       # Header Params
       header_params = {}
@@ -2864,6 +2925,7 @@ module OCI
     # @option opts [String] :page The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @option opts [String] :display_name A filter to return only resources that match the entire display name given.
+    # @option opts [BOOLEAN] :is_latest_only A flag to return only the latest scan result of an instance. (default to false)
     # @return [Response] A Response object with data of type {OCI::VulnerabilityScanning::Models::HostPortScanResultSummaryCollection HostPortScanResultSummaryCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/vulnerabilityscanning/list_host_port_scan_results.rb.html) to see an example of how to use list_host_port_scan_results API.
     def list_host_port_scan_results(compartment_id, opts = {})
@@ -2899,6 +2961,7 @@ module OCI
       query_params[:limit] = opts[:limit] if opts[:limit]
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:displayName] = opts[:display_name] if opts[:display_name]
+      query_params[:isLatestOnly] = opts[:is_latest_only] if !opts[:is_latest_only].nil?
 
       # Header Params
       header_params = {}
@@ -3254,6 +3317,241 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Retrieves a list of VulnerabilitySummary objects in a compartment. You can filter and sort the vulnerabilities by problem severity and time and type. A vulnerability describes a security issue that was detected in scans of one or more compute instances, container images.
+    #
+    # @param [String] compartment_id The ID of the compartment in which to list resources.
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [Integer] :limit The maximum number of items to return. (default to 10)
+    # @option opts [String] :page The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.
+    # @option opts [String] :severity A filter to return only resources that have a severity that matches the given severity
+    # @option opts [String] :name A filter to return only resources that match the entire name given.
+    # @option opts [String] :vulnerability_reference Parameter to filter the vulnerability type's unique identifier. For CVE, this is the MITRE CVE ID
+    # @option opts [String] :vulnerability_type The field to filter vulnerabilities based on its type. Only one value can be provided.
+    #
+    # @option opts [String] :sort_order The sort order to use, either 'ASC' or 'DESC'. (default to ASC)
+    # @option opts [String] :sort_by The field to sort by. Only one sort order may be provided. Default order for 'name' is Ascending. Default order for other values is descending. If no value is specified name is default.
+    #    (default to lastDetected)
+    #   Allowed values are: name, severity, firstDetected, lastDetected, impactedHosts, impactedContainers, impactedResources
+    # @option opts [String] :opc_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type {OCI::VulnerabilityScanning::Models::VulnerabilitySummaryCollection VulnerabilitySummaryCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/vulnerabilityscanning/list_vulnerabilities.rb.html) to see an example of how to use list_vulnerabilities API.
+    def list_vulnerabilities(compartment_id, opts = {})
+      logger.debug 'Calling operation VulnerabilityScanningClient#list_vulnerabilities.' if logger
+
+      raise "Missing the required parameter 'compartment_id' when calling list_vulnerabilities." if compartment_id.nil?
+
+      if opts[:severity] && !OCI::VulnerabilityScanning::Models::SCAN_RESULT_PROBLEM_SEVERITY_ENUM.include?(opts[:severity])
+        raise 'Invalid value for "severity", must be one of the values in OCI::VulnerabilityScanning::Models::SCAN_RESULT_PROBLEM_SEVERITY_ENUM.'
+      end
+
+      if opts[:vulnerability_type] && !OCI::VulnerabilityScanning::Models::VULNERABILITY_TYPE_ENUM.include?(opts[:vulnerability_type])
+        raise 'Invalid value for "vulnerability_type", must be one of the values in OCI::VulnerabilityScanning::Models::VULNERABILITY_TYPE_ENUM.'
+      end
+
+      if opts[:sort_order] && !OCI::VulnerabilityScanning::Models::SORT_ORDER_ENUM.include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of the values in OCI::VulnerabilityScanning::Models::SORT_ORDER_ENUM.'
+      end
+
+      if opts[:sort_by] && !%w[name severity firstDetected lastDetected impactedHosts impactedContainers impactedResources].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of name, severity, firstDetected, lastDetected, impactedHosts, impactedContainers, impactedResources.'
+      end
+
+      path = '/vulnerabilities'
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:compartmentId] = compartment_id
+      query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:page] = opts[:page] if opts[:page]
+      query_params[:severity] = opts[:severity] if opts[:severity]
+      query_params[:name] = opts[:name] if opts[:name]
+      query_params[:vulnerabilityReference] = opts[:vulnerability_reference] if opts[:vulnerability_reference]
+      query_params[:vulnerabilityType] = opts[:vulnerability_type] if opts[:vulnerability_type]
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'VulnerabilityScanningClient#list_vulnerabilities') do
+        @api_client.call_api(
+          :GET,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::VulnerabilityScanning::Models::VulnerabilitySummaryCollection'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
+    # Retrieves a list of VulnerabilityImpactedContainerSummary objects for a specific vulnerability ID. An impacted container image summary identifies container images on which the specified vulnerability was detected.
+    #
+    # @param [String] vulnerability_id unique vulnerability identifier
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :sort_order The sort order to use, either 'ASC' or 'DESC'. (default to ASC)
+    # @option opts [Integer] :limit The maximum number of items to return. (default to 10)
+    # @option opts [String] :page The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.
+    # @option opts [String] :opc_request_id The client request ID for tracing.
+    # @option opts [String] :sort_by The field to sort by. Only one sort order may be provided. Default order is Ascending. If no value is specified image name is default.
+    #    (default to image)
+    #   Allowed values are: image, repository, registry
+    # @return [Response] A Response object with data of type {OCI::VulnerabilityScanning::Models::VulnerabilityImpactedContainerSummaryCollection VulnerabilityImpactedContainerSummaryCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/vulnerabilityscanning/list_vulnerability_impacted_containers.rb.html) to see an example of how to use list_vulnerability_impacted_containers API.
+    def list_vulnerability_impacted_containers(vulnerability_id, opts = {})
+      logger.debug 'Calling operation VulnerabilityScanningClient#list_vulnerability_impacted_containers.' if logger
+
+      raise "Missing the required parameter 'vulnerability_id' when calling list_vulnerability_impacted_containers." if vulnerability_id.nil?
+
+      if opts[:sort_order] && !OCI::VulnerabilityScanning::Models::SORT_ORDER_ENUM.include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of the values in OCI::VulnerabilityScanning::Models::SORT_ORDER_ENUM.'
+      end
+
+      if opts[:sort_by] && !%w[image repository registry].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of image, repository, registry.'
+      end
+      raise "Parameter value for 'vulnerability_id' must not be blank" if OCI::Internal::Util.blank_string?(vulnerability_id)
+
+      path = '/vulnerabilities/{vulnerabilityId}/impactedContainers'.sub('{vulnerabilityId}', vulnerability_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:page] = opts[:page] if opts[:page]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'VulnerabilityScanningClient#list_vulnerability_impacted_containers') do
+        @api_client.call_api(
+          :GET,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::VulnerabilityScanning::Models::VulnerabilityImpactedContainerSummaryCollection'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
+    # Retrieves a list of VulnerabilityImpactedHostSummary objects for a specific host vulnerability ID. An impacted host summary identifies a compute instance on which the specified vulnerability was detected.
+    #
+    # @param [String] vulnerability_id unique vulnerability identifier
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :sort_order The sort order to use, either 'ASC' or 'DESC'. (default to ASC)
+    # @option opts [String] :sort_by The field to sort by. Only one sort order may be provided. Default order is Ascending. If no value is specified instanceId is default.
+    #    (default to instanceId)
+    # @option opts [Integer] :limit The maximum number of items to return. (default to 10)
+    # @option opts [String] :page The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.
+    # @option opts [String] :opc_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type {OCI::VulnerabilityScanning::Models::VulnerabilityImpactedHostSummaryCollection VulnerabilityImpactedHostSummaryCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/vulnerabilityscanning/list_vulnerability_impacted_hosts.rb.html) to see an example of how to use list_vulnerability_impacted_hosts API.
+    def list_vulnerability_impacted_hosts(vulnerability_id, opts = {})
+      logger.debug 'Calling operation VulnerabilityScanningClient#list_vulnerability_impacted_hosts.' if logger
+
+      raise "Missing the required parameter 'vulnerability_id' when calling list_vulnerability_impacted_hosts." if vulnerability_id.nil?
+
+      if opts[:sort_order] && !OCI::VulnerabilityScanning::Models::SORT_ORDER_ENUM.include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of the values in OCI::VulnerabilityScanning::Models::SORT_ORDER_ENUM.'
+      end
+
+      if opts[:sort_by] && !OCI::VulnerabilityScanning::Models::IMPACTED_HOST_SORT_BY_ENUM.include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of the values in OCI::VulnerabilityScanning::Models::IMPACTED_HOST_SORT_BY_ENUM.'
+      end
+      raise "Parameter value for 'vulnerability_id' must not be blank" if OCI::Internal::Util.blank_string?(vulnerability_id)
+
+      path = '/vulnerabilities/{vulnerabilityId}/impactedHosts'.sub('{vulnerabilityId}', vulnerability_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+      query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:page] = opts[:page] if opts[:page]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'VulnerabilityScanningClient#list_vulnerability_impacted_hosts') do
+        @api_client.call_api(
+          :GET,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::VulnerabilityScanning::Models::VulnerabilityImpactedHostSummaryCollection'
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
     # Return a (paginated) list of errors for a given work request.
     #
     # @param [String] work_request_id The ID of the asynchronous request.
@@ -3431,7 +3729,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates the ContainerScanRecipe identified by the id
+    # Updates the ContainerScanRecipe identified by the recipe ID. A recipe determines the types of security issues that you want scanned.
     #
     # @param [String] container_scan_recipe_id unique ContainerScanRecipe identifier
     # @param [OCI::VulnerabilityScanning::Models::UpdateContainerScanRecipeDetails] update_container_scan_recipe_details The information to be updated.
@@ -3494,7 +3792,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates the ContainerScanTarget identified by the id
+    # Updates the ContainerScanTarget identified by the target ID. A container scan target specifies a group of one or more Docker image repositories in Oracle Cloud Infrastructure Registry (OCIR) that you want routinely scanned for security vulnerabilities.
     #
     # @param [String] container_scan_target_id unique ContainerScanTarget identifier
     # @param [OCI::VulnerabilityScanning::Models::UpdateContainerScanTargetDetails] update_container_scan_target_details The information to be updated.

data/lib/oci/waa/models/backend_type.rb

@@ -0,0 +1,10 @@
+# Copyright (c) 2016, 2022, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+module OCI
+  module Waa::Models
+    BACKEND_TYPE_ENUM = [
+      BACKEND_TYPE_LOAD_BALANCER = 'LOAD_BALANCER'.freeze
+    ].freeze
+  end
+end