oci 2.20.0 → 2.21.1

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 7dd93cf6123210a2de908c7f9a1059569df5dbe1b09b39c0914f69aa11b94b47
-  data.tar.gz: df18febb9cb65059834b73fd58068d25eb8e8a6c96387cc375202a677b82f1f0
+  metadata.gz: 173bfa47237f2a3f120836610c0fbd1ea62c3d2230225f341aca7d3abe13978d
+  data.tar.gz: 1a946bda4a02f57fe21601db039c64d790f1f0fbbaa8d09e20062f05223bdddb
 SHA512:
-  metadata.gz: e7c37bc4f3830c0a2520e62fb6c28ca8a06d7bca1290ba46fb117e66abb958effba9880821b77c0bbccf8d53e55aa4a23da1503db4ab477694f20149b497fc4d
-  data.tar.gz: 974c10a4d74d33e2738dd6be60a72d26a28e1f0bc93defa29e01e0d8036eef4309c98fd1a8e5e3c17097aecba8772b2169b0e1459253133337afb0b432e75cd9
+  metadata.gz: 2cb74db141ccee7091de0a6b0928a3713e8ecca50022dd232e398526bdb0671c6d5d68efda5ceab4be0f43f03075a7b169e15464ed76a4cae2ebb8d2490e761a
+  data.tar.gz: 47c850b2fd05be392c4b8c52f64d67224038b965a14ec9905f0614171af4e2c6ced1676cfaef422e18c124cbc103ccf7e935633291228c606aa5fde5ddcc73e8

data/NOTICE.txt

@@ -0,0 +1 @@
+Copyright (c) 2016, 2021, Oracle and/or its affiliates.

data/README.md

@@ -4,7 +4,7 @@ This is Oracle Cloud Infrastructure SDK for Ruby. This project is open source an
 
 This project is no longer being actively developed by Oracle. We will continue to address security vulnerabilities for the foreseeable future, and will respond to questions on github, but have no plans to introduce any new functionality, and may not be able to address any non-security related issues. We encourage developers to migrate to other OCI SDKs, and developers may fork this project and enhance it as they desire.
 
-**Version 2.20.0**
+**Version 2.21.1**
 
 This topic describes how to install, configure, and use the Oracle Cloud Infrastructure Ruby SDK.
 
@@ -23,7 +23,6 @@ The Ruby SDK supports the following services:
 * API Gateway
 * Application Dependency Management
 * Application Management service
-* Application Migration
 * Application Performance Monitoring
 * Audit
 * Autonomous recovery
@@ -36,6 +35,7 @@ The Ruby SDK supports the following services:
 * Caching
 * Certificates service
 * Classic Migration
+* Cluster Placement Groups service
 * Cloud Bridge
 * Cloud Guard
 * Cloud Migrations
@@ -71,7 +71,10 @@ The Ruby SDK supports the following services:
 * File Storage
 * Functions
 * Fusion Apps as a Service
+* Generative AI service 
+* Generative AI Inference service
 * Generic Artifacts service
+* Globally Distributed Database service
 * Golden Gate
 * Governance Rules service
 * Health Checks
@@ -101,6 +104,7 @@ The Ruby SDK supports the following services:
 * Networking Topology
 * Notification
 * OCI Control Center
+* OCI Control Center service
 * OCI Registry
 * OneSubscription service
 * Operations Insights
@@ -121,6 +125,7 @@ The Ruby SDK supports the following services:
 * Search
 * Service Catalog service
 * Secret Management (for the Vault service)
+* Secure Desktops service
 * Service Mesh
 * Service Connector Hub
 * Source Code Management service
@@ -713,9 +718,7 @@ See [CHANGELOG](https://github.com/oracle/oci-ruby-sdk/blob/master/CHANGELOG.md)
 
 ## Contributing
 
-oci-ruby-sdk is an open source project. See [CONTRIBUTING](https://github.com/oracle/oci-ruby-sdk/blob/master/CONTRIBUTING.md) for details.
-
-Oracle gratefully acknowledges the contributions to oci-ruby-sdk that have been made by the community.
+This project welcomes contributions from the community. Before submitting a pull request, please [review our contribution guide](./CONTRIBUTING.md)
 
 ## Notifications
 To be notified when a new version of the Ruby SDK is released, subscribe to the [Atom feed](https://rubygems.org/gems/oci/versions.atom).
@@ -724,6 +727,12 @@ To be notified when a new version of the Ruby SDK is released, subscribe to the
 
 You can find information on any known issues with the SDK [here](https://docs.cloud.oracle.com/Content/knownissues.htm) and under the [Issues](https://github.com/oracle/oci-ruby-sdk/issues) tab of this project's [GitHub repository](https://github.com/oracle/oci-ruby-sdk).
 
+## SSE Support
+
+For SSE response, Ruby SDK is having some performance issue where the response is not returning as a TRUE streaming mode. It's actually returning 
+in a chunked mode, which waits until it receive multiple lines of SSE response into one block and then return the result. This behavior is caused by the base HTTP
+client package(Net::HTTP) which is the only HTTP package we use in Ruby SDK Please refer genai_generate_text_example in examples-oci folder to use SSE support.
+
 ## Questions or Feedback?
 You can post an issue on the [Issues](https://github.com/oracle/oci-ruby-sdk/issues) tab of this project's [GitHub repository](https://github.com/oracle/oci-ruby-sdk).
 
@@ -733,9 +742,13 @@ Addtional ways to get in touch:
 * [Developer Tools section](https://community.oracle.com/community/cloud_computing/bare-metal/content?filterID=contentstatus%5Bpublished%5D~category%5Bdeveloper-tools%5D&filterID=contentstatus%5Bpublished%5D~objecttype~objecttype%5Bthread%5D) of the Oracle Cloud forums
 * [My Oracle Support](https://support.oracle.com)
 
+## Security
+
+Please consult the [security guide](./SECURITY.md) for our responsible security vulnerability disclosure process
+
 ## License
 
-Copyright (c) 2016, 2021, Oracle and/or its affiliates.  All rights reserved.
+Copyright (c) 2016, 2023 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.

data/lib/oci/access_governance_cp/access_governance_cp.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/access_governance_cp_client.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/access_governance_cp_client_composite_operations.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/change_governance_instance_compartment_details.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/create_governance_instance_details.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/governance_instance.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/governance_instance_collection.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/governance_instance_configuration.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/governance_instance_summary.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/instance_lifecycle_state.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/license_type.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/sender_config.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/sort_order.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/update_governance_instance_configuration_details.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/update_governance_instance_details.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/models/update_sender_config.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220518

data/lib/oci/access_governance_cp/util.rb

@@ -1,3 +1,3 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 

data/lib/oci/adm/adm.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220421
@@ -24,6 +24,7 @@ require 'oci/adm/models/change_knowledge_base_compartment_details'
 require 'oci/adm/models/change_remediation_recipe_compartment_details'
 require 'oci/adm/models/change_remediation_run_compartment_details'
 require 'oci/adm/models/change_vulnerability_audit_compartment_details'
+require 'oci/adm/models/config_severity'
 require 'oci/adm/models/create_knowledge_base_details'
 require 'oci/adm/models/create_remediation_recipe_details'
 require 'oci/adm/models/create_remediation_run_details'
@@ -76,6 +77,7 @@ require 'oci/adm/models/vulnerability_audit_collection'
 require 'oci/adm/models/vulnerability_audit_configuration'
 require 'oci/adm/models/vulnerability_audit_source'
 require 'oci/adm/models/vulnerability_audit_summary'
+require 'oci/adm/models/vulnerability_severity'
 require 'oci/adm/models/work_request'
 require 'oci/adm/models/work_request_error'
 require 'oci/adm/models/work_request_error_collection'

data/lib/oci/adm/application_dependency_management_client.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220421
@@ -1459,14 +1459,16 @@ module OCI
     # @option opts [String] :page A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
     # @option opts [String] :sort_order The sort order to use, either 'ASC' or 'DESC'.
     # @option opts [String] :gav A filter to return only resources that match the entire GAV (Group Artifact Version) identifier given.
+    # @option opts [String] :purl A filter to return only resources that match the entire PURL given (https://github.com/package-url/purl-spec/).
     # @option opts [String] :sort_by The field to sort by. Only one sort order may be provided.
     #   If sort order is dfs, the nodes are returned by going through the application dependency tree in a depth-first manner. Children are sorted based on their GAV property alphabetically (either ascending or descending, depending on the order parameter). Default order is ascending.
     #   If sort order is bfs, the nodes are returned by going through the application dependency tree in a breadth-first manner. Children are sorted based on their GAV property alphabetically (either ascending or descending, depending on the order parameter). Default order is ascending.
     #   Default order for gav is ascending where ascending corresponds to alphanumerical order.
+    #   Default order for purl is ascending where ascending corresponds to alphabetical order
     #   Default order for nodeId is ascending where ascending corresponds to alphanumerical order.
     #   Sorting by DFS or BFS cannot be used in conjunction with the following query parameters: \"gav\", \"cvssV2GreaterThanOrEqual\", \"cvssV3GreaterThanOrEqual\" and \"vulnerabilityId\".
     #    (default to gav)
-    #   Allowed values are: gav, nodeId, dfs, bfs
+    #   Allowed values are: gav, purl, nodeId, dfs, bfs
     # @return [Response] A Response object with data of type {OCI::Adm::Models::ApplicationDependencyRecommendationCollection ApplicationDependencyRecommendationCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/adm/list_application_dependency_recommendations.rb.html) to see an example of how to use list_application_dependency_recommendations API.
     def list_application_dependency_recommendations(remediation_run_id, opts = {})
@@ -1478,8 +1480,8 @@ module OCI
         raise 'Invalid value for "sort_order", must be one of the values in OCI::Adm::Models::SORT_ORDER_ENUM.'
       end
 
-      if opts[:sort_by] && !%w[gav nodeId dfs bfs].include?(opts[:sort_by])
-        raise 'Invalid value for "sort_by", must be one of gav, nodeId, dfs, bfs.'
+      if opts[:sort_by] && !%w[gav purl nodeId dfs bfs].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of gav, purl, nodeId, dfs, bfs.'
       end
       raise "Parameter value for 'remediation_run_id' must not be blank" if OCI::Internal::Util.blank_string?(remediation_run_id)
 
@@ -1493,6 +1495,7 @@ module OCI
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
       query_params[:gav] = opts[:gav] if opts[:gav]
+      query_params[:purl] = opts[:purl] if opts[:purl]
       query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
 
       # Header Params
@@ -1534,10 +1537,12 @@ module OCI
     # @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] :vulnerability_id A filter to return only Vulnerability Audits that match the specified id.
-    # @option opts [Float] :cvss_v3_greater_than_or_equal A filter that returns only Vulnerability Audits that have a Common Vulnerability Scoring System Version 3 (CVSS V3) greater or equal than the specified value.
+    # @option opts [Float] :cvss_v3_greater_than_or_equal A filter that returns only Vulnerabilities that have a Common Vulnerability Scoring System Version 3 (CVSS V3) greater than or equal to the specified value.
     #    (default to 0)
-    # @option opts [Float] :cvss_v2_greater_than_or_equal A filter that returns only Vulnerability Audits that have a Common Vulnerability Scoring System Version 2 (CVSS V2) greater or equal than the specified value.
+    # @option opts [Float] :cvss_v2_greater_than_or_equal A filter that returns only Vulnerabilities that have a Common Vulnerability Scoring System Version 2 (CVSS V2) greater than or equal to the specified value.
     #    (default to 0)
+    # @option opts [String] :severity_greater_than_or_equal A filter that returns only Vulnerabilities that have a severity greater than or equal to the specified value.
+    #    (default to NONE)
     # @option opts [Integer] :limit The maximum number of items to return. (default to 100)
     # @option opts [String] :page A token representing the position at which to start retrieving results. This must come from the `opc-next-page` header field of a previous response.
     # @option opts [String] :sort_order The sort order to use, either 'ASC' or 'DESC'.
@@ -1545,10 +1550,11 @@ module OCI
     #   If sort order is dfs, the nodes are returned by going through the application dependency tree in a depth-first manner. Children are sorted based on their GAV property alphabetically (either ascending or descending, depending on the order parameter). Default order is ascending.
     #   If sort order is bfs, the nodes are returned by going through the application dependency tree in a breadth-first manner. Children are sorted based on their GAV property alphabetically (either ascending or descending, depending on the order parameter). Default order is ascending.
     #   Default order for gav is ascending where ascending corresponds to alphanumerical order.
+    #   Default order for purl is ascending where ascending corresponds to alphabetical order
     #   Default order for nodeId is ascending where ascending corresponds to alphanumerical order.
     #   Sorting by DFS or BFS cannot be used in conjunction with the following query parameters: \"gav\", \"cvssV2GreaterThanOrEqual\", \"cvssV3GreaterThanOrEqual\" and \"vulnerabilityId\".
     #    (default to gav)
-    #   Allowed values are: gav, nodeId, dfs, bfs
+    #   Allowed values are: gav, purl, nodeId, dfs, bfs
     # @option opts [String] :root_node_id A filter to override the top level root identifier with the new given value. The application dependency tree will only be traversed from the given node.
     #   Query parameters \"cvssV2GreaterThanOrEqual\", \"cvssV3GreaterThanOrEqual\", \"gav\" and \"vulnerabilityId\" cannot be used in conjunction with this parameter.
     #    (default to null)
@@ -1556,6 +1562,7 @@ module OCI
     #   Additionally query parameters such as \"cvssV2GreaterThanOrEqual\", \"cvssV3GreaterThanOrEqual\", \"gav\" and \"vulnerabilityId\" can't be used in conjunction with this latter.
     #
     # @option opts [String] :gav A filter to return only resources that match the entire GAV (Group Artifact Version) identifier given.
+    # @option opts [String] :purl A filter to return only resources that match the entire PURL given (https://github.com/package-url/purl-spec/).
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type {OCI::Adm::Models::ApplicationDependencyVulnerabilityCollection ApplicationDependencyVulnerabilityCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/adm/list_application_dependency_vulnerabilities.rb.html) to see an example of how to use list_application_dependency_vulnerabilities API.
@@ -1564,12 +1571,16 @@ module OCI
 
       raise "Missing the required parameter 'vulnerability_audit_id' when calling list_application_dependency_vulnerabilities." if vulnerability_audit_id.nil?
 
+      if opts[:severity_greater_than_or_equal] && !OCI::Adm::Models::VULNERABILITY_SEVERITY_ENUM.include?(opts[:severity_greater_than_or_equal])
+        raise 'Invalid value for "severity_greater_than_or_equal", must be one of the values in OCI::Adm::Models::VULNERABILITY_SEVERITY_ENUM.'
+      end
+
       if opts[:sort_order] && !OCI::Adm::Models::SORT_ORDER_ENUM.include?(opts[:sort_order])
         raise 'Invalid value for "sort_order", must be one of the values in OCI::Adm::Models::SORT_ORDER_ENUM.'
       end
 
-      if opts[:sort_by] && !%w[gav nodeId dfs bfs].include?(opts[:sort_by])
-        raise 'Invalid value for "sort_by", must be one of gav, nodeId, dfs, bfs.'
+      if opts[:sort_by] && !%w[gav purl nodeId dfs bfs].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of gav, purl, nodeId, dfs, bfs.'
       end
       raise "Parameter value for 'vulnerability_audit_id' must not be blank" if OCI::Internal::Util.blank_string?(vulnerability_audit_id)
 
@@ -1582,6 +1593,7 @@ module OCI
       query_params[:vulnerabilityId] = opts[:vulnerability_id] if opts[:vulnerability_id]
       query_params[:cvssV3GreaterThanOrEqual] = opts[:cvss_v3_greater_than_or_equal] if opts[:cvss_v3_greater_than_or_equal]
       query_params[:cvssV2GreaterThanOrEqual] = opts[:cvss_v2_greater_than_or_equal] if opts[:cvss_v2_greater_than_or_equal]
+      query_params[:severityGreaterThanOrEqual] = opts[:severity_greater_than_or_equal] if opts[:severity_greater_than_or_equal]
       query_params[:limit] = opts[:limit] if opts[:limit]
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
@@ -1589,6 +1601,7 @@ module OCI
       query_params[:rootNodeId] = opts[:root_node_id] if opts[:root_node_id]
       query_params[:depth] = opts[:depth] if opts[:depth]
       query_params[:gav] = opts[:gav] if opts[:gav]
+      query_params[:purl] = opts[:purl] if opts[:purl]
 
       # Header Params
       header_params = {}
@@ -2016,9 +2029,16 @@ module OCI
     #   Default order for _timeCreated_ is **descending**.
     #   Default order for _vulnerableArtifactsCount_ is **ascending**.
     #   Default order for _vulnerableArtifactsCountWithIgnored_ is **ascending**.
+    #   Default order for _maxObservedSeverity_ is **ascending**.
+    #   Default order for _maxObservedSeverityWithIgnored_ is **ascending**.
+    #   Default order for _displayName_ is **ascending**.
     #    (default to timeCreated)
-    #   Allowed values are: maxObservedCvssV2Score, maxObservedCvssV3Score, timeCreated, vulnerableArtifactsCount, maxObservedCvssV2ScoreWithIgnored, maxObservedCvssV3ScoreWithIgnored, vulnerableArtifactsCountWithIgnored
+    #   Allowed values are: maxObservedCvssV2Score, maxObservedCvssV3Score, maxObservedSeverity, timeCreated, vulnerableArtifactsCount, maxObservedCvssV2ScoreWithIgnored, maxObservedCvssV3ScoreWithIgnored, maxObservedSeverityWithIgnored, vulnerableArtifactsCountWithIgnored, displayName
     # @option opts [String] :display_name A filter to return only resources that match the entire display name given.
+    # @option opts [DateTime] :time_created_greater_than_or_equal_to A filter to return only Vulnerability Audits with timeCreated greater or equal to the specified value.
+    # @option opts [DateTime] :time_created_less_than_or_equal_to A filter to return only Vulnerability Audits with timeCreated less or equal to the specified value.
+    # @option opts [String] :max_observed_severity_greater_than_or_equal_to A filter that returns only Vulnerability Audits that have a maximum observed Severity greater than or equal to the specified value.
+    #    (default to NONE)
     # @return [Response] A Response object with data of type {OCI::Adm::Models::VulnerabilityAuditCollection VulnerabilityAuditCollection}
     # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/adm/list_vulnerability_audits.rb.html) to see an example of how to use list_vulnerability_audits API.
     def list_vulnerability_audits(opts = {})
@@ -2033,8 +2053,12 @@ module OCI
         raise 'Invalid value for "sort_order", must be one of the values in OCI::Adm::Models::SORT_ORDER_ENUM.'
       end
 
-      if opts[:sort_by] && !%w[maxObservedCvssV2Score maxObservedCvssV3Score timeCreated vulnerableArtifactsCount maxObservedCvssV2ScoreWithIgnored maxObservedCvssV3ScoreWithIgnored vulnerableArtifactsCountWithIgnored].include?(opts[:sort_by])
-        raise 'Invalid value for "sort_by", must be one of maxObservedCvssV2Score, maxObservedCvssV3Score, timeCreated, vulnerableArtifactsCount, maxObservedCvssV2ScoreWithIgnored, maxObservedCvssV3ScoreWithIgnored, vulnerableArtifactsCountWithIgnored.'
+      if opts[:sort_by] && !%w[maxObservedCvssV2Score maxObservedCvssV3Score maxObservedSeverity timeCreated vulnerableArtifactsCount maxObservedCvssV2ScoreWithIgnored maxObservedCvssV3ScoreWithIgnored maxObservedSeverityWithIgnored vulnerableArtifactsCountWithIgnored displayName].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of maxObservedCvssV2Score, maxObservedCvssV3Score, maxObservedSeverity, timeCreated, vulnerableArtifactsCount, maxObservedCvssV2ScoreWithIgnored, maxObservedCvssV3ScoreWithIgnored, maxObservedSeverityWithIgnored, vulnerableArtifactsCountWithIgnored, displayName.'
+      end
+
+      if opts[:max_observed_severity_greater_than_or_equal_to] && !OCI::Adm::Models::VULNERABILITY_SEVERITY_ENUM.include?(opts[:max_observed_severity_greater_than_or_equal_to])
+        raise 'Invalid value for "max_observed_severity_greater_than_or_equal_to", must be one of the values in OCI::Adm::Models::VULNERABILITY_SEVERITY_ENUM.'
       end
 
       path = '/vulnerabilityAudits'
@@ -2053,6 +2077,9 @@ module OCI
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
       query_params[:displayName] = opts[:display_name] if opts[:display_name]
+      query_params[:timeCreatedGreaterThanOrEqualTo] = opts[:time_created_greater_than_or_equal_to] if opts[:time_created_greater_than_or_equal_to]
+      query_params[:timeCreatedLessThanOrEqualTo] = opts[:time_created_less_than_or_equal_to] if opts[:time_created_less_than_or_equal_to]
+      query_params[:maxObservedSeverityGreaterThanOrEqualTo] = opts[:max_observed_severity_greater_than_or_equal_to] if opts[:max_observed_severity_greater_than_or_equal_to]
 
       # Header Params
       header_params = {}

data/lib/oci/adm/application_dependency_management_client_composite_operations.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220421
@@ -46,6 +46,7 @@ module OCI
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
       wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      return operation_result if wait_for_resource_id.nil? || wait_for_resource_id.empty?
 
       begin
         if use_util
@@ -135,6 +136,7 @@ module OCI
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
       wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      return operation_result if wait_for_resource_id.nil? || wait_for_resource_id.empty?
 
       begin
         if use_util
@@ -185,6 +187,7 @@ module OCI
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
       wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      return operation_result if wait_for_resource_id.nil? || wait_for_resource_id.empty?
 
       begin
         if use_util
@@ -234,6 +237,7 @@ module OCI
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
       wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      return operation_result if wait_for_resource_id.nil? || wait_for_resource_id.empty?
 
       begin
         if use_util
@@ -283,6 +287,7 @@ module OCI
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
       wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      return operation_result if wait_for_resource_id.nil? || wait_for_resource_id.empty?
 
       begin
         if use_util
@@ -352,41 +357,31 @@ module OCI
     # rubocop:disable Layout/EmptyLines
 
 
-    # Calls {OCI::Adm::ApplicationDependencyManagementClient#create_vulnerability_audit} and then waits for the {OCI::Adm::Models::WorkRequest}
+    # Calls {OCI::Adm::ApplicationDependencyManagementClient#create_vulnerability_audit} and then waits for the {OCI::Adm::Models::VulnerabilityAudit} acted upon
     # to enter the given state(s).
     #
     # @param [OCI::Adm::Models::CreateVulnerabilityAuditDetails] create_vulnerability_audit_details The details to create a new Vulnerability Audit.
-    # @param [Array<String>] wait_for_states An array of states to wait on. These should be valid values for {OCI::Adm::Models::WorkRequest#status}
+    # @param [Array<String>] wait_for_states An array of states to wait on. These should be valid values for {OCI::Adm::Models::VulnerabilityAudit#lifecycle_state}
     # @param [Hash] base_operation_opts Any optional arguments accepted by {OCI::Adm::ApplicationDependencyManagementClient#create_vulnerability_audit}
     # @param [Hash] waiter_opts Optional arguments for the waiter. Keys should be symbols, and the following keys are supported:
     #   * max_interval_seconds: The maximum interval between queries, in seconds.
     #   * max_wait_seconds The maximum time to wait, in seconds
     #
-    # @return [OCI::Response] A {OCI::Response} object containing the completed {OCI::Adm::Models::WorkRequest}
+    # @return [OCI::Response] A {OCI::Response} object with data of type {OCI::Adm::Models::VulnerabilityAudit}
     def create_vulnerability_audit_and_wait_for_state(create_vulnerability_audit_details, wait_for_states = [], base_operation_opts = {}, waiter_opts = {})
       operation_result = @service_client.create_vulnerability_audit(create_vulnerability_audit_details, base_operation_opts)
-      use_util = OCI::Adm::Util.respond_to?(:wait_on_work_request)
 
-      return operation_result if wait_for_states.empty? && !use_util
+      return operation_result if wait_for_states.empty?
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
-      wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      wait_for_resource_id = operation_result.data.id
 
       begin
-        if use_util
-          waiter_result = OCI::Adm::Util.wait_on_work_request(
-            @service_client,
-            wait_for_resource_id,
-            max_interval_seconds: waiter_opts.key?(:max_interval_seconds) ? waiter_opts[:max_interval_seconds] : 30,
-            max_wait_seconds: waiter_opts.key?(:max_wait_seconds) ? waiter_opts[:max_wait_seconds] : 1200
-          )
-        else
-          waiter_result = @service_client.get_work_request(wait_for_resource_id).wait_until(
-            eval_proc: ->(response) { response.data.respond_to?(:status) && lowered_wait_for_states.include?(response.data.status.downcase) },
-            max_interval_seconds: waiter_opts.key?(:max_interval_seconds) ? waiter_opts[:max_interval_seconds] : 30,
-            max_wait_seconds: waiter_opts.key?(:max_wait_seconds) ? waiter_opts[:max_wait_seconds] : 1200
-          )
-        end
+        waiter_result = @service_client.get_vulnerability_audit(wait_for_resource_id).wait_until(
+          eval_proc: ->(response) { response.data.respond_to?(:lifecycle_state) && lowered_wait_for_states.include?(response.data.lifecycle_state.downcase) },
+          max_interval_seconds: waiter_opts.key?(:max_interval_seconds) ? waiter_opts[:max_interval_seconds] : 30,
+          max_wait_seconds: waiter_opts.key?(:max_wait_seconds) ? waiter_opts[:max_wait_seconds] : 1200
+        )
         result_to_return = waiter_result
 
         return result_to_return
@@ -420,6 +415,7 @@ module OCI
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
       wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      return operation_result if wait_for_resource_id.nil? || wait_for_resource_id.empty?
 
       begin
         if use_util
@@ -469,6 +465,7 @@ module OCI
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
       wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      return operation_result if wait_for_resource_id.nil? || wait_for_resource_id.empty?
 
       begin
         if use_util
@@ -518,6 +515,7 @@ module OCI
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
       wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      return operation_result if wait_for_resource_id.nil? || wait_for_resource_id.empty?
 
       begin
         if use_util
@@ -648,6 +646,7 @@ module OCI
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
       wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      return operation_result if wait_for_resource_id.nil? || wait_for_resource_id.empty?
 
       begin
         if use_util
@@ -698,6 +697,7 @@ module OCI
 
       lowered_wait_for_states = wait_for_states.map(&:downcase)
       wait_for_resource_id = operation_result.headers['opc-work-request-id']
+      return operation_result if wait_for_resource_id.nil? || wait_for_resource_id.empty?
 
       begin
         if use_util

data/lib/oci/adm/models/action_type.rb

@@ -1,4 +1,4 @@
-# Copyright (c) 2016, 2023, Oracle and/or its affiliates.  All rights reserved.
+# Copyright (c) 2016, 2024, 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.
 
 # NOTE: This class is auto generated by OracleSDKGenerator. DO NOT EDIT. API Version: 20220421