oci 2.7.0 → 2.12.0

data/lib/oci/object_storage/models/update_namespace_metadata_details.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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.
 
 require 'date'
 

data/lib/oci/object_storage/models/update_retention_rule_details.rb

@@ -0,0 +1,178 @@
+# Copyright (c) 2016, 2020, 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.
+
+require 'date'
+
+# rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
+module OCI
+  # The details to update a retention rule.
+  class ObjectStorage::Models::UpdateRetentionRuleDetails
+    # A user-specified name for the retention rule. Names can be helpful in identifying retention rules.
+    # @return [String]
+    attr_accessor :display_name
+
+    # @return [OCI::ObjectStorage::Models::Duration]
+    attr_accessor :duration
+
+    # The date and time as per [RFC 3339](https://tools.ietf.org/html/rfc3339) after which this rule is locked
+    # and can only be deleted by deleting the bucket. Once a rule is locked, only increases in the duration are
+    # allowed and no other properties can be changed. This property cannot be updated for rules that are in a
+    # locked state. Specifying it when a duration is not specified is considered an error.
+    #
+    # @return [DateTime]
+    attr_accessor :time_rule_locked
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'display_name': :'displayName',
+        'duration': :'duration',
+        'time_rule_locked': :'timeRuleLocked'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'display_name': :'String',
+        'duration': :'OCI::ObjectStorage::Models::Duration',
+        'time_rule_locked': :'DateTime'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :display_name The value to assign to the {#display_name} property
+    # @option attributes [OCI::ObjectStorage::Models::Duration] :duration The value to assign to the {#duration} property
+    # @option attributes [DateTime] :time_rule_locked The value to assign to the {#time_rule_locked} property
+    def initialize(attributes = {})
+      return unless attributes.is_a?(Hash)
+
+      self.display_name = attributes[:'displayName'] if attributes[:'displayName']
+
+      raise 'You cannot provide both :displayName and :display_name' if attributes.key?(:'displayName') && attributes.key?(:'display_name')
+
+      self.display_name = attributes[:'display_name'] if attributes[:'display_name']
+
+      self.duration = attributes[:'duration'] if attributes[:'duration']
+
+      self.time_rule_locked = attributes[:'timeRuleLocked'] if attributes[:'timeRuleLocked']
+
+      raise 'You cannot provide both :timeRuleLocked and :time_rule_locked' if attributes.key?(:'timeRuleLocked') && attributes.key?(:'time_rule_locked')
+
+      self.time_rule_locked = attributes[:'time_rule_locked'] if attributes[:'time_rule_locked']
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] other the other object to be compared
+    def ==(other)
+      return true if equal?(other)
+
+      self.class == other.class &&
+        display_name == other.display_name &&
+        duration == other.duration &&
+        time_rule_locked == other.time_rule_locked
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+    # @see the `==` method
+    # @param [Object] other the other object to be compared
+    def eql?(other)
+      self == other
+    end
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # Calculates hash code according to all attributes.
+    # @return [Fixnum] Hash code
+    def hash
+      [display_name, duration, time_rule_locked].hash
+    end
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+
+      self.class.swagger_types.each_pair do |key, type|
+        if type =~ /^Array<(.*)>/i
+          # check to ensure the input is an array given that the the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            public_method("#{key}=").call(
+              attributes[self.class.attribute_map[key]]
+                .map { |v| OCI::Internal::Util.convert_to_type(Regexp.last_match(1), v) }
+            )
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          public_method("#{key}=").call(
+            OCI::Internal::Util.convert_to_type(type, attributes[self.class.attribute_map[key]])
+          )
+        end
+        # or else data not found in attributes(hash), not an issue as the data can be optional
+      end
+
+      self
+    end
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = public_method(attr).call
+        next if value.nil? && !instance_variable_defined?("@#{attr}")
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    private
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+  end
+end
+# rubocop:enable Lint/UnneededCopDisableDirective, Metrics/LineLength

data/lib/oci/object_storage/models/work_request.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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.
 
 require 'date'
 require 'logger'
@@ -35,8 +36,8 @@ module OCI
     # @return [String]
     attr_accessor :id
 
-    # The OCID of the compartment that contains the work request. Work requests are scoped to the same compartment
-    # as the resource the work request affects.
+    # The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the compartment that contains the work request. Work
+    # requests are scoped to the same compartment as the resource the work request affects.
     #
     # If the work request affects multiple resources and those resources are not in the same compartment, the OCID of
     # the primary resource is used. For example, you can copy an object in a bucket in one compartment to a bucket in
@@ -53,19 +54,19 @@ module OCI
     attr_accessor :percent_complete
 
     # The date and time the work request was created, as described in
-    # [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
+    # [RFC 3339](https://tools.ietf.org/html/rfc3339).
     #
     # @return [DateTime]
     attr_accessor :time_accepted
 
     # The date and time the work request was started, as described in
-    # [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
+    # [RFC 3339](https://tools.ietf.org/html/rfc3339).
     #
     # @return [DateTime]
     attr_accessor :time_started
 
     # The date and time the work request was finished, as described in
-    # [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
+    # [RFC 3339](https://tools.ietf.org/html/rfc3339).
     #
     # @return [DateTime]
     attr_accessor :time_finished

data/lib/oci/object_storage/models/work_request_error.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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.
 
 require 'date'
 require 'logger'

data/lib/oci/object_storage/models/work_request_log_entry.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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.
 
 require 'date'
 
@@ -11,7 +12,7 @@ module OCI
     attr_accessor :message
 
     # The date and time the log message was written, as described in
-    # [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
+    # [RFC 3339](https://tools.ietf.org/html/rfc3339).
     #
     # @return [DateTime]
     attr_accessor :timestamp

data/lib/oci/object_storage/models/work_request_resource.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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.
 
 require 'date'
 require 'logger'

data/lib/oci/object_storage/models/work_request_resource_metadata_key.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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 ObjectStorage::Models

data/lib/oci/object_storage/models/work_request_summary.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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.
 
 require 'date'
 require 'logger'
@@ -35,8 +36,8 @@ module OCI
     # @return [String]
     attr_accessor :id
 
-    # The OCID of the compartment that contains the work request. Work requests are scoped to the same compartment
-    # as the resource the work request affects.
+    # The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the compartment that contains the work request. Work
+    # requests are scoped to the same compartment as the resource the work request affects.
     #
     # If the work request affects multiple resources and those resources are not in the same compartment, the OCID of
     # the primary resource is used. For example, you can copy an object in a bucket in one compartment to a bucket in
@@ -53,19 +54,19 @@ module OCI
     attr_accessor :percent_complete
 
     # The date and time the work request was created, as described in
-    # [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
+    # [RFC 3339](https://tools.ietf.org/html/rfc3339).
     #
     # @return [DateTime]
     attr_accessor :time_accepted
 
     # The date and time the work request was started, as described in
-    # [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
+    # [RFC 3339](https://tools.ietf.org/html/rfc3339).
     #
     # @return [DateTime]
     attr_accessor :time_started
 
     # The date and time the work request was finished, as described in
-    # [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
+    # [RFC 3339](https://tools.ietf.org/html/rfc3339).
     #
     # @return [DateTime]
     attr_accessor :time_finished

data/lib/oci/object_storage/object_storage.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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 ObjectStorage
@@ -18,6 +19,9 @@ require 'oci/object_storage/models/copy_object_details'
 require 'oci/object_storage/models/create_bucket_details'
 require 'oci/object_storage/models/create_multipart_upload_details'
 require 'oci/object_storage/models/create_preauthenticated_request_details'
+require 'oci/object_storage/models/create_replication_policy_details'
+require 'oci/object_storage/models/create_retention_rule_details'
+require 'oci/object_storage/models/duration'
 require 'oci/object_storage/models/list_objects'
 require 'oci/object_storage/models/multipart_upload'
 require 'oci/object_storage/models/multipart_upload_part_summary'
@@ -26,14 +30,26 @@ require 'oci/object_storage/models/object_lifecycle_policy'
 require 'oci/object_storage/models/object_lifecycle_rule'
 require 'oci/object_storage/models/object_name_filter'
 require 'oci/object_storage/models/object_summary'
+require 'oci/object_storage/models/object_version_collection'
+require 'oci/object_storage/models/object_version_summary'
 require 'oci/object_storage/models/pattern_details'
 require 'oci/object_storage/models/preauthenticated_request'
 require 'oci/object_storage/models/preauthenticated_request_summary'
 require 'oci/object_storage/models/put_object_lifecycle_policy_details'
+require 'oci/object_storage/models/reencrypt_object_details'
 require 'oci/object_storage/models/rename_object_details'
+require 'oci/object_storage/models/replication_policy'
+require 'oci/object_storage/models/replication_policy_summary'
+require 'oci/object_storage/models/replication_source'
 require 'oci/object_storage/models/restore_objects_details'
+require 'oci/object_storage/models/retention_rule'
+require 'oci/object_storage/models/retention_rule_collection'
+require 'oci/object_storage/models/retention_rule_details'
+require 'oci/object_storage/models/retention_rule_summary'
+require 'oci/object_storage/models/sse_customer_key_details'
 require 'oci/object_storage/models/update_bucket_details'
 require 'oci/object_storage/models/update_namespace_metadata_details'
+require 'oci/object_storage/models/update_retention_rule_details'
 require 'oci/object_storage/models/work_request'
 require 'oci/object_storage/models/work_request_error'
 require 'oci/object_storage/models/work_request_log_entry'

data/lib/oci/object_storage/object_storage_client.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, 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.
 
 require 'uri'
 require 'logger'
@@ -6,6 +7,8 @@ require 'logger'
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
   # Common set of Object Storage and Archive Storage APIs for managing buckets, objects, and related resources.
+  # For more information, see [Overview of Object Storage](/Content/Object/Concepts/objectstorageoverview.htm) and
+  # [Overview of Archive Storage](/Content/Archive/Concepts/archivestorageoverview.htm).
   class ObjectStorage::ObjectStorageClient
     # Client used to make HTTP requests.
     # @return [OCI::ApiClient]
@@ -50,27 +53,16 @@ module OCI
     #   apply across all operations. This can be overridden on a per-operation basis. The default retry configuration value is `nil`, which means that an operation
     #   will not perform any retries
     def initialize(config: nil, region: nil, endpoint: nil, signer: nil, proxy_settings: nil, retry_config: nil)
-      # If the signer is an InstancePrincipalsSecurityTokenSigner and no config was supplied (which is valid for instance principals)
+      # If the signer is an InstancePrincipalsSecurityTokenSigner or SecurityTokenSigner and no config was supplied (they are self-sufficient signers)
       # then create a dummy config to pass to the ApiClient constructor. If customers wish to create a client which uses instance principals
       # and has config (either populated programmatically or loaded from a file), they must construct that config themselves and then
       # pass it to this constructor.
       #
       # If there is no signer (or the signer is not an instance principals signer) and no config was supplied, this is not valid
       # so try and load the config from the default file.
-      config ||= OCI.config unless signer.is_a?(OCI::Auth::Signers::InstancePrincipalsSecurityTokenSigner)
-      config ||= OCI::Config.new if signer.is_a?(OCI::Auth::Signers::InstancePrincipalsSecurityTokenSigner)
-      config.validate unless signer.is_a?(OCI::Auth::Signers::InstancePrincipalsSecurityTokenSigner)
-
-      if signer.nil?
-        signer = OCI::Signer.new(
-          config.user,
-          config.fingerprint,
-          config.tenancy,
-          config.key_file,
-          pass_phrase: config.pass_phrase,
-          private_key_content: config.key_content
-        )
-      end
+      config = OCI::Config.validate_and_build_config_with_signer(config, signer)
+
+      signer = OCI::Signer.config_file_auth_builder(config) if signer.nil?
 
       @api_client = OCI::ApiClient.new(config, signer, proxy_settings: proxy_settings)
       @retry_config = retry_config
@@ -123,6 +115,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/abort_multipart_upload.rb.html) to see an example of how to use abort_multipart_upload API.
     def abort_multipart_upload(namespace_name, bucket_name, object_name, upload_id, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#abort_multipart_upload.' if logger
 
@@ -182,6 +175,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/cancel_work_request.rb.html) to see an example of how to use cancel_work_request API.
     def cancel_work_request(work_request_id, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#cancel_work_request.' if logger
 
@@ -250,6 +244,7 @@ module OCI
     #
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/commit_multipart_upload.rb.html) to see an example of how to use commit_multipart_upload API.
     def commit_multipart_upload(namespace_name, bucket_name, object_name, upload_id, commit_multipart_upload_details, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#commit_multipart_upload.' if logger
 
@@ -315,7 +310,32 @@ 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] :opc_client_request_id The client request ID for tracing.
+    # @option opts [String] :opc_sse_customer_algorithm The optional header that specifies \"AES256\" as the encryption algorithm. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or
+    #   decrypt the data. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key_sha256 The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This
+    #   value is used to check the integrity of the encryption key. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_source_sse_customer_algorithm The optional header that specifies \"AES256\" as the encryption algorithm to use to decrypt the source
+    #   object. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_source_sse_customer_key The optional header that specifies the base64-encoded 256-bit encryption key to use to decrypt
+    #   the source object. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_source_sse_customer_key_sha256 The optional header that specifies the base64-encoded SHA256 hash of the encryption key used to
+    #   decrypt the source object. This value is used to check the integrity of the encryption key. For
+    #   more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/copy_object.rb.html) to see an example of how to use copy_object API.
     def copy_object(namespace_name, bucket_name, copy_object_details, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#copy_object.' if logger
 
@@ -337,6 +357,12 @@ module OCI
       header_params[:accept] = 'application/json'
       header_params[:'content-type'] = 'application/json'
       header_params[:'opc-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      header_params[:'opc-sse-customer-algorithm'] = opts[:opc_sse_customer_algorithm] if opts[:opc_sse_customer_algorithm]
+      header_params[:'opc-sse-customer-key'] = opts[:opc_sse_customer_key] if opts[:opc_sse_customer_key]
+      header_params[:'opc-sse-customer-key-sha256'] = opts[:opc_sse_customer_key_sha256] if opts[:opc_sse_customer_key_sha256]
+      header_params[:'opc-source-sse-customer-algorithm'] = opts[:opc_source_sse_customer_algorithm] if opts[:opc_source_sse_customer_algorithm]
+      header_params[:'opc-source-sse-customer-key'] = opts[:opc_source_sse_customer_key] if opts[:opc_source_sse_customer_key]
+      header_params[:'opc-source-sse-customer-key-sha256'] = opts[:opc_source_sse_customer_key_sha256] if opts[:opc_source_sse_customer_key_sha256]
       # rubocop:enable Style/NegatedIf
 
       post_body = @api_client.object_to_http_body(copy_object_details)
@@ -374,6 +400,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::Bucket Bucket}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/create_bucket.rb.html) to see an example of how to use create_bucket API.
     def create_bucket(namespace_name, create_bucket_details, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#create_bucket.' if logger
 
@@ -427,7 +454,7 @@ module OCI
     # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
     #   Example: `my-new-bucket1`
     #
-    # @param [OCI::ObjectStorage::Models::CreateMultipartUploadDetails] create_multipart_upload_details Request object for creating a multi-part upload.
+    # @param [OCI::ObjectStorage::Models::CreateMultipartUploadDetails] create_multipart_upload_details Request object for creating a multipart upload.
     # @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
@@ -439,7 +466,19 @@ module OCI
     #   part, this is the entity tag of the target part.
     #
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @option opts [String] :opc_sse_customer_algorithm The optional header that specifies \"AES256\" as the encryption algorithm. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or
+    #   decrypt the data. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key_sha256 The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This
+    #   value is used to check the integrity of the encryption key. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
     # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::MultipartUpload MultipartUpload}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/create_multipart_upload.rb.html) to see an example of how to use create_multipart_upload API.
     def create_multipart_upload(namespace_name, bucket_name, create_multipart_upload_details, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#create_multipart_upload.' if logger
 
@@ -463,6 +502,9 @@ module OCI
       header_params[:'if-match'] = opts[:if_match] if opts[:if_match]
       header_params[:'if-none-match'] = opts[:if_none_match] if opts[:if_none_match]
       header_params[:'opc-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      header_params[:'opc-sse-customer-algorithm'] = opts[:opc_sse_customer_algorithm] if opts[:opc_sse_customer_algorithm]
+      header_params[:'opc-sse-customer-key'] = opts[:opc_sse_customer_key] if opts[:opc_sse_customer_key]
+      header_params[:'opc-sse-customer-key-sha256'] = opts[:opc_sse_customer_key_sha256] if opts[:opc_sse_customer_key_sha256]
       # rubocop:enable Style/NegatedIf
 
       post_body = @api_client.object_to_http_body(create_multipart_upload_details)
@@ -503,6 +545,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::PreauthenticatedRequest PreauthenticatedRequest}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/create_preauthenticated_request.rb.html) to see an example of how to use create_preauthenticated_request API.
     def create_preauthenticated_request(namespace_name, bucket_name, create_preauthenticated_request_details, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#create_preauthenticated_request.' if logger
 
@@ -552,6 +595,131 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Creates a replication policy for the specified bucket.
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @param [OCI::ObjectStorage::Models::CreateReplicationPolicyDetails] create_replication_policy_details The replication policy.
+    # @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_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::ReplicationPolicy ReplicationPolicy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/create_replication_policy.rb.html) to see an example of how to use create_replication_policy API.
+    def create_replication_policy(namespace_name, bucket_name, create_replication_policy_details, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#create_replication_policy.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling create_replication_policy." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling create_replication_policy." if bucket_name.nil?
+      raise "Missing the required parameter 'create_replication_policy_details' when calling create_replication_policy." if create_replication_policy_details.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+
+      path = '/n/{namespaceName}/b/{bucketName}/replicationPolicies'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.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-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = @api_client.object_to_http_body(create_replication_policy_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#create_replication_policy') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::ObjectStorage::Models::ReplicationPolicy'
+        )
+      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
+
+
+    # Creates a new retention rule in the specified bucket. The new rule will take effect typically within 30 seconds.
+    # Note that a maximum of 100 rules are supported on a bucket.
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @param [OCI::ObjectStorage::Models::CreateRetentionRuleDetails] create_retention_rule_details The retention rule to create for the bucket.
+    # @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_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::RetentionRule RetentionRule}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/create_retention_rule.rb.html) to see an example of how to use create_retention_rule API.
+    def create_retention_rule(namespace_name, bucket_name, create_retention_rule_details, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#create_retention_rule.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling create_retention_rule." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling create_retention_rule." if bucket_name.nil?
+      raise "Missing the required parameter 'create_retention_rule_details' when calling create_retention_rule." if create_retention_rule_details.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+
+      path = '/n/{namespaceName}/b/{bucketName}/retentionRules'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.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-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = @api_client.object_to_http_body(create_retention_rule_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#create_retention_rule') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::ObjectStorage::Models::RetentionRule'
+        )
+      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
+
+
     # Deletes a bucket if the bucket is already empty. If the bucket is not empty, use
     # {#delete_object delete_object} first. In addition,
     # you cannot delete a bucket that has a multipart upload in progress or a pre-authenticated
@@ -569,6 +737,7 @@ module OCI
     #
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/delete_bucket.rb.html) to see an example of how to use delete_bucket API.
     def delete_bucket(namespace_name, bucket_name, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#delete_bucket.' if logger
 
@@ -633,7 +802,9 @@ module OCI
     #   For uploading a part, this is the entity tag of the target part.
     #
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @option opts [String] :version_id VersionId used to identify a particular version of the object
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/delete_object.rb.html) to see an example of how to use delete_object API.
     def delete_object(namespace_name, bucket_name, object_name, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#delete_object.' if logger
 
@@ -650,6 +821,7 @@ module OCI
       # rubocop:disable Style/NegatedIf
       # Query Params
       query_params = {}
+      query_params[:versionId] = opts[:version_id] if opts[:version_id]
 
       # Header Params
       header_params = {}
@@ -698,6 +870,7 @@ module OCI
     #   For uploading a part, this is the entity tag of the target part.
     #
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/delete_object_lifecycle_policy.rb.html) to see an example of how to use delete_object_lifecycle_policy API.
     def delete_object_lifecycle_policy(namespace_name, bucket_name, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#delete_object_lifecycle_policy.' if logger
 
@@ -759,6 +932,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/delete_preauthenticated_request.rb.html) to see an example of how to use delete_preauthenticated_request API.
     def delete_preauthenticated_request(namespace_name, bucket_name, par_id, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#delete_preauthenticated_request.' if logger
 
@@ -808,6 +982,133 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Deletes the replication policy associated with the source bucket.
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @param [String] replication_id The ID of the replication policy.
+    # @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_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/delete_replication_policy.rb.html) to see an example of how to use delete_replication_policy API.
+    def delete_replication_policy(namespace_name, bucket_name, replication_id, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#delete_replication_policy.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling delete_replication_policy." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling delete_replication_policy." if bucket_name.nil?
+      raise "Missing the required parameter 'replication_id' when calling delete_replication_policy." if replication_id.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+      raise "Parameter value for 'replication_id' must not be blank" if OCI::Internal::Util.blank_string?(replication_id)
+
+      path = '/n/{namespaceName}/b/{bucketName}/replicationPolicies/{replicationId}'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s).sub('{replicationId}', replication_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-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#delete_replication_policy') do
+        @api_client.call_api(
+          :DELETE,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body
+        )
+      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
+
+
+    # Deletes the specified rule. The deletion takes effect typically within 30 seconds.
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @param [String] retention_rule_id The ID of the retention rule.
+    # @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] :if_match The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object.
+    #   For uploading a part, this is the entity tag of the target part.
+    #
+    # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/delete_retention_rule.rb.html) to see an example of how to use delete_retention_rule API.
+    def delete_retention_rule(namespace_name, bucket_name, retention_rule_id, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#delete_retention_rule.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling delete_retention_rule." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling delete_retention_rule." if bucket_name.nil?
+      raise "Missing the required parameter 'retention_rule_id' when calling delete_retention_rule." if retention_rule_id.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+      raise "Parameter value for 'retention_rule_id' must not be blank" if OCI::Internal::Util.blank_string?(retention_rule_id)
+
+      path = '/n/{namespaceName}/b/{bucketName}/retentionRules/{retentionRuleId}'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s).sub('{retentionRuleId}', retention_rule_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[:'if-match'] = opts[:if_match] if opts[:if_match]
+      header_params[:'opc-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#delete_retention_rule') do
+        @api_client.call_api(
+          :DELETE,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body
+        )
+      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 current representation of the given bucket in the given Object Storage namespace.
     #
     # @param [String] namespace_name The Object Storage namespace used for the request.
@@ -831,6 +1132,7 @@ module OCI
     #
     #   Allowed values are: approximateCount, approximateSize
     # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::Bucket Bucket}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/get_bucket.rb.html) to see an example of how to use get_bucket API.
     def get_bucket(namespace_name, bucket_name, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#get_bucket.' if logger
 
@@ -904,10 +1206,11 @@ 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] :opc_client_request_id The client request ID for tracing.
-    # @option opts [String] :compartment_id This is an optional field representing the tenancy OCID or the compartment OCID within the tenancy whose Object Storage namespace
-    #   name has to be retrieved.
+    # @option opts [String] :compartment_id This is an optional field representing either the tenancy [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) or the compartment
+    #   [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) within the tenancy whose Object Storage namespace is to be retrieved.
     #
     # @return [Response] A Response object with data of type String
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/get_namespace.rb.html) to see an example of how to use get_namespace API.
     def get_namespace(opts = {})
       logger.debug 'Calling operation ObjectStorageClient#get_namespace.' if logger
 
@@ -967,6 +1270,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::NamespaceMetadata NamespaceMetadata}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/get_namespace_metadata.rb.html) to see an example of how to use get_namespace_metadata API.
     def get_namespace_metadata(namespace_name, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#get_namespace_metadata.' if logger
 
@@ -1025,6 +1329,7 @@ module OCI
     # @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] :version_id VersionId used to identify a particular version of the object
     # @option opts [String] :if_match The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object.
     #   For uploading a part, this is the entity tag of the target part.
     #
@@ -1033,12 +1338,30 @@ module OCI
     #   part, this is the entity tag of the target part.
     #
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
-    # @option opts [String] :range Optional byte range to fetch, as described in [RFC 7233](https://tools.ietf.org/rfc/rfc7233), section 2.1.
+    # @option opts [String] :range Optional byte range to fetch, as described in [RFC 7233](https://tools.ietf.org/html/rfc7233#section-2.1).
     #   Note that only a single range of bytes is supported.
     #
+    # @option opts [String] :opc_sse_customer_algorithm The optional header that specifies \"AES256\" as the encryption algorithm. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or
+    #   decrypt the data. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key_sha256 The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This
+    #   value is used to check the integrity of the encryption key. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :http_response_content_disposition Specify this query parameter to override the value of the Content-Disposition response header in the GetObject response.
+    # @option opts [String] :http_response_cache_control Specify this query parameter to override the Cache-Control response header in the GetObject response.
+    # @option opts [String] :http_response_content_type Specify this query parameter to override the Content-Type response header in the GetObject response.
+    # @option opts [String] :http_response_content_language Specify this query parameter to override the Content-Language response header in the GetObject response.
+    # @option opts [String] :http_response_content_encoding Specify this query parameter to override the Content-Encoding response header in the GetObject response.
+    # @option opts [String] :http_response_expires Specify this query parameter to override the Expires response header in the GetObject response.
     # @option opts [String, IO] :response_target Streaming http body into a file (specified by file name or File object) or IO object if the block is not given
     # @option [Block] &block Streaming http body to the block
     # @return [Response] A Response object with data of type String if response_target and block are not given, otherwise with nil data
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/get_object.rb.html) to see an example of how to use get_object API.
     def get_object(namespace_name, bucket_name, object_name, opts = {}, &block)
       logger.debug 'Calling operation ObjectStorageClient#get_object.' if logger
 
@@ -1055,6 +1378,13 @@ module OCI
       # rubocop:disable Style/NegatedIf
       # Query Params
       query_params = {}
+      query_params[:versionId] = opts[:version_id] if opts[:version_id]
+      query_params[:httpResponseContentDisposition] = opts[:http_response_content_disposition] if opts[:http_response_content_disposition]
+      query_params[:httpResponseCacheControl] = opts[:http_response_cache_control] if opts[:http_response_cache_control]
+      query_params[:httpResponseContentType] = opts[:http_response_content_type] if opts[:http_response_content_type]
+      query_params[:httpResponseContentLanguage] = opts[:http_response_content_language] if opts[:http_response_content_language]
+      query_params[:httpResponseContentEncoding] = opts[:http_response_content_encoding] if opts[:http_response_content_encoding]
+      query_params[:httpResponseExpires] = opts[:http_response_expires] if opts[:http_response_expires]
 
       # Header Params
       header_params = {}
@@ -1066,6 +1396,9 @@ module OCI
       header_params[:'if-none-match'] = opts[:if_none_match] if opts[:if_none_match]
       header_params[:'opc-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
       header_params[:range] = opts[:range] if opts[:range]
+      header_params[:'opc-sse-customer-algorithm'] = opts[:opc_sse_customer_algorithm] if opts[:opc_sse_customer_algorithm]
+      header_params[:'opc-sse-customer-key'] = opts[:opc_sse_customer_key] if opts[:opc_sse_customer_key]
+      header_params[:'opc-sse-customer-key-sha256'] = opts[:opc_sse_customer_key_sha256] if opts[:opc_sse_customer_key_sha256]
       # rubocop:enable Style/NegatedIf
 
       post_body = nil
@@ -1147,6 +1480,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::ObjectLifecyclePolicy ObjectLifecyclePolicy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/get_object_lifecycle_policy.rb.html) to see an example of how to use get_object_lifecycle_policy API.
     def get_object_lifecycle_policy(namespace_name, bucket_name, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#get_object_lifecycle_policy.' if logger
 
@@ -1208,6 +1542,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::PreauthenticatedRequestSummary PreauthenticatedRequestSummary}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/get_preauthenticated_request.rb.html) to see an example of how to use get_preauthenticated_request API.
     def get_preauthenticated_request(namespace_name, bucket_name, par_id, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#get_preauthenticated_request.' if logger
 
@@ -1258,20 +1593,30 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets the status of the work request for the given ID.
-    # @param [String] work_request_id The ID of the asynchronous request.
+    # Get the replication policy.
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @param [String] replication_id The ID of the replication policy.
     # @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_client_request_id The client request ID for tracing.
-    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::WorkRequest WorkRequest}
-    def get_work_request(work_request_id, opts = {})
-      logger.debug 'Calling operation ObjectStorageClient#get_work_request.' if logger
-
-      raise "Missing the required parameter 'work_request_id' when calling get_work_request." if work_request_id.nil?
-      raise "Parameter value for 'work_request_id' must not be blank" if OCI::Internal::Util.blank_string?(work_request_id)
+    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::ReplicationPolicy ReplicationPolicy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/get_replication_policy.rb.html) to see an example of how to use get_replication_policy API.
+    def get_replication_policy(namespace_name, bucket_name, replication_id, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#get_replication_policy.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling get_replication_policy." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling get_replication_policy." if bucket_name.nil?
+      raise "Missing the required parameter 'replication_id' when calling get_replication_policy." if replication_id.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+      raise "Parameter value for 'replication_id' must not be blank" if OCI::Internal::Util.blank_string?(replication_id)
 
-      path = '/workRequests/{workRequestId}'.sub('{workRequestId}', work_request_id.to_s)
+      path = '/n/{namespaceName}/b/{bucketName}/replicationPolicies/{replicationId}'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s).sub('{replicationId}', replication_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -1288,7 +1633,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#get_work_request') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#get_replication_policy') do
         @api_client.call_api(
           :GET,
           path,
@@ -1297,7 +1642,7 @@ module OCI
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
           body: post_body,
-          return_type: 'OCI::ObjectStorage::Models::WorkRequest'
+          return_type: 'OCI::ObjectStorage::Models::ReplicationPolicy'
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -1311,33 +1656,29 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Efficiently checks to see if a bucket exists and gets the current entity tag (ETag) for the bucket.
-    #
+    # Get the specified retention rule.
     # @param [String] namespace_name The Object Storage namespace used for the request.
     # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
     #   Example: `my-new-bucket1`
     #
+    # @param [String] retention_rule_id The ID of the retention rule.
     # @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] :if_match The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object.
-    #   For uploading a part, this is the entity tag of the target part.
-    #
-    # @option opts [String] :if_none_match The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object
-    #   already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a
-    #   part, this is the entity tag of the target part.
-    #
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
-    # @return [Response] A Response object with data of type nil
-    def head_bucket(namespace_name, bucket_name, opts = {})
-      logger.debug 'Calling operation ObjectStorageClient#head_bucket.' if logger
-
-      raise "Missing the required parameter 'namespace_name' when calling head_bucket." if namespace_name.nil?
-      raise "Missing the required parameter 'bucket_name' when calling head_bucket." if bucket_name.nil?
+    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::RetentionRule RetentionRule}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/get_retention_rule.rb.html) to see an example of how to use get_retention_rule API.
+    def get_retention_rule(namespace_name, bucket_name, retention_rule_id, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#get_retention_rule.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling get_retention_rule." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling get_retention_rule." if bucket_name.nil?
+      raise "Missing the required parameter 'retention_rule_id' when calling get_retention_rule." if retention_rule_id.nil?
       raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
       raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+      raise "Parameter value for 'retention_rule_id' must not be blank" if OCI::Internal::Util.blank_string?(retention_rule_id)
 
-      path = '/n/{namespaceName}/b/{bucketName}/'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
+      path = '/n/{namespaceName}/b/{bucketName}/retentionRules/{retentionRuleId}'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s).sub('{retentionRuleId}', retention_rule_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -1348,23 +1689,144 @@ module OCI
       header_params = {}
       header_params[:accept] = 'application/json'
       header_params[:'content-type'] = 'application/json'
-      header_params[:'if-match'] = opts[:if_match] if opts[:if_match]
-      header_params[:'if-none-match'] = opts[:if_none_match] if opts[:if_none_match]
       header_params[:'opc-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
       # rubocop:enable Style/NegatedIf
 
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#head_bucket') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#get_retention_rule') do
         @api_client.call_api(
-          :HEAD,
+          :GET,
           path,
           endpoint,
           header_params: header_params,
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
-          body: post_body
+          body: post_body,
+          return_type: 'OCI::ObjectStorage::Models::RetentionRule'
+        )
+      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 for the given ID.
+    # @param [String] work_request_id The ID of the asynchronous request.
+    # @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_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::WorkRequest WorkRequest}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/get_work_request.rb.html) to see an example of how to use get_work_request API.
+    def get_work_request(work_request_id, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#get_work_request.' if logger
+
+      raise "Missing the required parameter 'work_request_id' when calling get_work_request." if work_request_id.nil?
+      raise "Parameter value for 'work_request_id' must not be blank" if OCI::Internal::Util.blank_string?(work_request_id)
+
+      path = '/workRequests/{workRequestId}'.sub('{workRequestId}', work_request_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-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#get_work_request') 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::ObjectStorage::Models::WorkRequest'
+        )
+      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
+
+
+    # Efficiently checks to see if a bucket exists and gets the current entity tag (ETag) for the bucket.
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @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] :if_match The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object.
+    #   For uploading a part, this is the entity tag of the target part.
+    #
+    # @option opts [String] :if_none_match The entity tag (ETag) to avoid matching. The only valid value is '*', which indicates that the request should fail if the object
+    #   already exists. For creating and committing a multipart upload, this is the entity tag of the target object. For uploading a
+    #   part, this is the entity tag of the target part.
+    #
+    # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/head_bucket.rb.html) to see an example of how to use head_bucket API.
+    def head_bucket(namespace_name, bucket_name, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#head_bucket.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling head_bucket." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling head_bucket." if bucket_name.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+
+      path = '/n/{namespaceName}/b/{bucketName}/'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.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[:'if-match'] = opts[:if_match] if opts[:if_match]
+      header_params[:'if-none-match'] = opts[:if_none_match] if opts[:if_none_match]
+      header_params[:'opc-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#head_bucket') do
+        @api_client.call_api(
+          :HEAD,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -1390,6 +1852,7 @@ module OCI
     # @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] :version_id VersionId used to identify a particular version of the object
     # @option opts [String] :if_match The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object.
     #   For uploading a part, this is the entity tag of the target part.
     #
@@ -1398,7 +1861,19 @@ module OCI
     #   part, this is the entity tag of the target part.
     #
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @option opts [String] :opc_sse_customer_algorithm The optional header that specifies \"AES256\" as the encryption algorithm. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or
+    #   decrypt the data. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key_sha256 The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This
+    #   value is used to check the integrity of the encryption key. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/head_object.rb.html) to see an example of how to use head_object API.
     def head_object(namespace_name, bucket_name, object_name, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#head_object.' if logger
 
@@ -1415,6 +1890,7 @@ module OCI
       # rubocop:disable Style/NegatedIf
       # Query Params
       query_params = {}
+      query_params[:versionId] = opts[:version_id] if opts[:version_id]
 
       # Header Params
       header_params = {}
@@ -1423,6 +1899,9 @@ module OCI
       header_params[:'if-match'] = opts[:if_match] if opts[:if_match]
       header_params[:'if-none-match'] = opts[:if_none_match] if opts[:if_none_match]
       header_params[:'opc-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      header_params[:'opc-sse-customer-algorithm'] = opts[:opc_sse_customer_algorithm] if opts[:opc_sse_customer_algorithm]
+      header_params[:'opc-sse-customer-key'] = opts[:opc_sse_customer_key] if opts[:opc_sse_customer_key]
+      header_params[:'opc-sse-customer-key-sha256'] = opts[:opc_sse_customer_key_sha256] if opts[:opc_sse_customer_key_sha256]
       # rubocop:enable Style/NegatedIf
 
       post_body = nil
@@ -1471,6 +1950,7 @@ module OCI
     #   Allowed values are: tags
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::BucketSummary BucketSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_buckets.rb.html) to see an example of how to use list_buckets API.
     def list_buckets(namespace_name, compartment_id, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#list_buckets.' if logger
 
@@ -1549,24 +2029,338 @@ module OCI
     # @option opts [String] :page The page at which to start retrieving results.
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::MultipartUploadPartSummary MultipartUploadPartSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_multipart_upload_parts.rb.html) to see an example of how to use list_multipart_upload_parts API.
     def list_multipart_upload_parts(namespace_name, bucket_name, object_name, upload_id, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#list_multipart_upload_parts.' if logger
 
-      raise "Missing the required parameter 'namespace_name' when calling list_multipart_upload_parts." if namespace_name.nil?
-      raise "Missing the required parameter 'bucket_name' when calling list_multipart_upload_parts." if bucket_name.nil?
-      raise "Missing the required parameter 'object_name' when calling list_multipart_upload_parts." if object_name.nil?
-      raise "Missing the required parameter 'upload_id' when calling list_multipart_upload_parts." if upload_id.nil?
+      raise "Missing the required parameter 'namespace_name' when calling list_multipart_upload_parts." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling list_multipart_upload_parts." if bucket_name.nil?
+      raise "Missing the required parameter 'object_name' when calling list_multipart_upload_parts." if object_name.nil?
+      raise "Missing the required parameter 'upload_id' when calling list_multipart_upload_parts." if upload_id.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+      raise "Parameter value for 'object_name' must not be blank" if OCI::Internal::Util.blank_string?(object_name)
+
+      path = '/n/{namespaceName}/b/{bucketName}/u/{objectName}'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s).sub('{objectName}', object_name.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:uploadId] = upload_id
+      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-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_multipart_upload_parts') 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: 'Array<OCI::ObjectStorage::Models::MultipartUploadPartSummary>'
+        )
+      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
+
+
+    # Lists all of the in-progress multipart uploads for the given bucket in the given Object Storage namespace.
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @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.
+    # @option opts [String] :page The page at which to start retrieving results.
+    # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::MultipartUpload MultipartUpload}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_multipart_uploads.rb.html) to see an example of how to use list_multipart_uploads API.
+    def list_multipart_uploads(namespace_name, bucket_name, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#list_multipart_uploads.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling list_multipart_uploads." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling list_multipart_uploads." if bucket_name.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+
+      path = '/n/{namespaceName}/b/{bucketName}/u'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      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-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_multipart_uploads') 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: 'Array<OCI::ObjectStorage::Models::MultipartUpload>'
+        )
+      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
+
+
+    # Lists the object versions in a bucket.
+    #
+    # To use this and other API operations, you must be authorized in an IAM policy. If you are not authorized,
+    # talk to an administrator. If you are an administrator who needs to write policies to give users access, see
+    # [Getting Started with Policies](https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm).
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @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] :prefix The string to use for matching against the start of object names in a list query.
+    # @option opts [String] :start Object names returned by a list query must be greater or equal to this parameter.
+    # @option opts [String] :_end Object names returned by a list query must be strictly less than this parameter.
+    # @option opts [Integer] :limit The maximum number of items to return.
+    # @option opts [String] :delimiter When this parameter is set, only objects whose names do not contain the delimiter character
+    #   (after an optionally specified prefix) are returned in the objects key of the response body.
+    #   Scanned objects whose names contain the delimiter have the part of their name up to the first
+    #   occurrence of the delimiter (including the optional prefix) returned as a set of prefixes.
+    #   Note that only '/' is a supported delimiter character at this time.
+    #
+    # @option opts [String] :fields Object summary in list of objects includes the 'name' field. This parameter can also include 'size'
+    #   (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time) and 'timeModified'
+    #   (object modification date and time).
+    #   Value of this parameter should be a comma-separated, case-insensitive list of those field names.
+    #   For example 'name,etag,timeCreated,md5,timeModified'
+    #
+    #   Allowed values are: name, size, etag, timeCreated, md5, timeModified
+    # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @option opts [String] :start_after Object names returned by a list query must be greater than this parameter.
+    # @option opts [String] :page The page at which to start retrieving results.
+    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::ObjectVersionCollection ObjectVersionCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_object_versions.rb.html) to see an example of how to use list_object_versions API.
+    def list_object_versions(namespace_name, bucket_name, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#list_object_versions.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling list_object_versions." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling list_object_versions." if bucket_name.nil?
+
+      if opts[:fields] && !%w[name size etag timeCreated md5 timeModified].include?(opts[:fields])
+        raise 'Invalid value for "fields", must be one of name, size, etag, timeCreated, md5, timeModified.'
+      end
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+
+      path = '/n/{namespaceName}/b/{bucketName}/objectversions'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:prefix] = opts[:prefix] if opts[:prefix]
+      query_params[:start] = opts[:start] if opts[:start]
+      query_params[:end] = opts[:_end] if opts[:_end]
+      query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:delimiter] = opts[:delimiter] if opts[:delimiter]
+      query_params[:fields] = opts[:fields] if opts[:fields]
+      query_params[:startAfter] = opts[:start_after] if opts[:start_after]
+      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-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_object_versions') 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::ObjectStorage::Models::ObjectVersionCollection'
+        )
+      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
+
+
+    # Lists the objects in a bucket.
+    #
+    # To use this and other API operations, you must be authorized in an IAM policy. If you are not authorized,
+    # talk to an administrator. If you are an administrator who needs to write policies to give users access, see
+    # [Getting Started with Policies](https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm).
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @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] :prefix The string to use for matching against the start of object names in a list query.
+    # @option opts [String] :start Object names returned by a list query must be greater or equal to this parameter.
+    # @option opts [String] :_end Object names returned by a list query must be strictly less than this parameter.
+    # @option opts [Integer] :limit The maximum number of items to return.
+    # @option opts [String] :delimiter When this parameter is set, only objects whose names do not contain the delimiter character
+    #   (after an optionally specified prefix) are returned in the objects key of the response body.
+    #   Scanned objects whose names contain the delimiter have the part of their name up to the first
+    #   occurrence of the delimiter (including the optional prefix) returned as a set of prefixes.
+    #   Note that only '/' is a supported delimiter character at this time.
+    #
+    # @option opts [String] :fields Object summary in list of objects includes the 'name' field. This parameter can also include 'size'
+    #   (object size in bytes), 'etag', 'md5', 'timeCreated' (object creation date and time) and 'timeModified'
+    #   (object modification date and time).
+    #   Value of this parameter should be a comma-separated, case-insensitive list of those field names.
+    #   For example 'name,etag,timeCreated,md5,timeModified'
+    #
+    # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @option opts [String] :start_after Object names returned by a list query must be greater than this parameter.
+    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::ListObjects ListObjects}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_objects.rb.html) to see an example of how to use list_objects API.
+    def list_objects(namespace_name, bucket_name, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#list_objects.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling list_objects." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling list_objects." if bucket_name.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+
+      path = '/n/{namespaceName}/b/{bucketName}/o'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:prefix] = opts[:prefix] if opts[:prefix]
+      query_params[:start] = opts[:start] if opts[:start]
+      query_params[:end] = opts[:_end] if opts[:_end]
+      query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:delimiter] = opts[:delimiter] if opts[:delimiter]
+      query_params[:fields] = opts[:fields] if opts[:fields]
+      query_params[:startAfter] = opts[:start_after] if opts[:start_after]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_objects') 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::ObjectStorage::Models::ListObjects'
+        )
+      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
+
+
+    # Lists pre-authenticated requests for the bucket.
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @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] :object_name_prefix User-specified object name prefixes can be used to query and return a list of pre-authenticated requests.
+    # @option opts [Integer] :limit The maximum number of items to return.
+    # @option opts [String] :page The page at which to start retrieving results.
+    # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::PreauthenticatedRequestSummary PreauthenticatedRequestSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_preauthenticated_requests.rb.html) to see an example of how to use list_preauthenticated_requests API.
+    def list_preauthenticated_requests(namespace_name, bucket_name, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#list_preauthenticated_requests.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling list_preauthenticated_requests." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling list_preauthenticated_requests." if bucket_name.nil?
       raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
       raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
-      raise "Parameter value for 'object_name' must not be blank" if OCI::Internal::Util.blank_string?(object_name)
 
-      path = '/n/{namespaceName}/b/{bucketName}/u/{objectName}'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s).sub('{objectName}', object_name.to_s)
+      path = '/n/{namespaceName}/b/{bucketName}/p/'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
       # Query Params
       query_params = {}
-      query_params[:uploadId] = upload_id
+      query_params[:objectNamePrefix] = opts[:object_name_prefix] if opts[:object_name_prefix]
       query_params[:limit] = opts[:limit] if opts[:limit]
       query_params[:page] = opts[:page] if opts[:page]
 
@@ -1580,7 +2374,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_multipart_upload_parts') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_preauthenticated_requests') do
         @api_client.call_api(
           :GET,
           path,
@@ -1589,7 +2383,7 @@ module OCI
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
           body: post_body,
-          return_type: 'Array<OCI::ObjectStorage::Models::MultipartUploadPartSummary>'
+          return_type: 'Array<OCI::ObjectStorage::Models::PreauthenticatedRequestSummary>'
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -1603,7 +2397,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Lists all of the in-progress multipart uploads for the given bucket in the given Object Storage namespace.
+    # List the replication policies associated with a bucket.
     #
     # @param [String] namespace_name The Object Storage namespace used for the request.
     # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
@@ -1612,26 +2406,27 @@ module OCI
     # @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.
-    # @option opts [String] :page The page at which to start retrieving results.
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
-    # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::MultipartUpload MultipartUpload}>
-    def list_multipart_uploads(namespace_name, bucket_name, opts = {})
-      logger.debug 'Calling operation ObjectStorageClient#list_multipart_uploads.' if logger
-
-      raise "Missing the required parameter 'namespace_name' when calling list_multipart_uploads." if namespace_name.nil?
-      raise "Missing the required parameter 'bucket_name' when calling list_multipart_uploads." if bucket_name.nil?
+    # @option opts [String] :page The page at which to start retrieving results.
+    # @option opts [Integer] :limit The maximum number of items to return. (default to 100)
+    # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::ReplicationPolicySummary ReplicationPolicySummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_replication_policies.rb.html) to see an example of how to use list_replication_policies API.
+    def list_replication_policies(namespace_name, bucket_name, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#list_replication_policies.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling list_replication_policies." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling list_replication_policies." if bucket_name.nil?
       raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
       raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
 
-      path = '/n/{namespaceName}/b/{bucketName}/u'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
+      path = '/n/{namespaceName}/b/{bucketName}/replicationPolicies'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
       # Query Params
       query_params = {}
-      query_params[:limit] = opts[:limit] if opts[:limit]
       query_params[:page] = opts[:page] if opts[:page]
+      query_params[:limit] = opts[:limit] if opts[:limit]
 
       # Header Params
       header_params = {}
@@ -1643,7 +2438,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_multipart_uploads') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_replication_policies') do
         @api_client.call_api(
           :GET,
           path,
@@ -1652,7 +2447,7 @@ module OCI
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
           body: post_body,
-          return_type: 'Array<OCI::ObjectStorage::Models::MultipartUpload>'
+          return_type: 'Array<OCI::ObjectStorage::Models::ReplicationPolicySummary>'
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -1666,11 +2461,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Lists the objects in a bucket.
-    #
-    # To use this and other API operations, you must be authorized in an IAM policy. If you are not authorized,
-    # talk to an administrator. If you are an administrator who needs to write policies to give users access, see
-    # [Getting Started with Policies](https://docs.cloud.oracle.com/Content/Identity/Concepts/policygetstarted.htm).
+    # List the replication sources of a destination bucket.
     #
     # @param [String] namespace_name The Object Storage namespace used for the request.
     # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
@@ -1679,43 +2470,27 @@ module OCI
     # @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] :prefix The string to use for matching against the start of object names in a list query.
-    # @option opts [String] :start Object names returned by a list query must be greater or equal to this parameter.
-    # @option opts [String] :_end Object names returned by a list query must be strictly less than this parameter.
-    # @option opts [Integer] :limit The maximum number of items to return.
-    # @option opts [String] :delimiter When this parameter is set, only objects whose names do not contain the delimiter character
-    #   (after an optionally specified prefix) are returned in the objects key of the response body.
-    #   Scanned objects whose names contain the delimiter have the part of their name up to the first
-    #   occurrence of the delimiter (including the optional prefix) returned as a set of prefixes.
-    #   Note that only '/' is a supported delimiter character at this time.
-    #
-    # @option opts [String] :fields Object summary in list of objects includes the 'name' field. This parameter can also include 'size'
-    #   (object size in bytes), 'md5', and 'timeCreated' (object creation date and time) fields.
-    #   Value of this parameter should be a comma-separated, case-insensitive list of those field names.
-    #   For example 'name,timeCreated,md5'.
-    #
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
-    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::ListObjects ListObjects}
-    def list_objects(namespace_name, bucket_name, opts = {})
-      logger.debug 'Calling operation ObjectStorageClient#list_objects.' if logger
-
-      raise "Missing the required parameter 'namespace_name' when calling list_objects." if namespace_name.nil?
-      raise "Missing the required parameter 'bucket_name' when calling list_objects." if bucket_name.nil?
+    # @option opts [String] :page The page at which to start retrieving results.
+    # @option opts [Integer] :limit The maximum number of items to return. (default to 100)
+    # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::ReplicationSource ReplicationSource}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_replication_sources.rb.html) to see an example of how to use list_replication_sources API.
+    def list_replication_sources(namespace_name, bucket_name, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#list_replication_sources.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling list_replication_sources." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling list_replication_sources." if bucket_name.nil?
       raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
       raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
 
-      path = '/n/{namespaceName}/b/{bucketName}/o'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
+      path = '/n/{namespaceName}/b/{bucketName}/replicationSources'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
       # Query Params
       query_params = {}
-      query_params[:prefix] = opts[:prefix] if opts[:prefix]
-      query_params[:start] = opts[:start] if opts[:start]
-      query_params[:end] = opts[:_end] if opts[:_end]
+      query_params[:page] = opts[:page] if opts[:page]
       query_params[:limit] = opts[:limit] if opts[:limit]
-      query_params[:delimiter] = opts[:delimiter] if opts[:delimiter]
-      query_params[:fields] = opts[:fields] if opts[:fields]
 
       # Header Params
       header_params = {}
@@ -1727,7 +2502,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_objects') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_replication_sources') do
         @api_client.call_api(
           :GET,
           path,
@@ -1736,7 +2511,7 @@ module OCI
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
           body: post_body,
-          return_type: 'OCI::ObjectStorage::Models::ListObjects'
+          return_type: 'Array<OCI::ObjectStorage::Models::ReplicationSource>'
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -1750,7 +2525,8 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Lists pre-authenticated requests for the bucket.
+    # List the retention rules for a bucket. The retention rules are sorted based on creation time,
+    # with the most recently created retention rule returned first.
     #
     # @param [String] namespace_name The Object Storage namespace used for the request.
     # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
@@ -1759,40 +2535,35 @@ module OCI
     # @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] :object_name_prefix User-specified object name prefixes can be used to query and return a list of pre-authenticated requests.
-    # @option opts [Integer] :limit The maximum number of items to return.
     # @option opts [String] :page The page at which to start retrieving results.
-    # @option opts [String] :opc_client_request_id The client request ID for tracing.
-    # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::PreauthenticatedRequestSummary PreauthenticatedRequestSummary}>
-    def list_preauthenticated_requests(namespace_name, bucket_name, opts = {})
-      logger.debug 'Calling operation ObjectStorageClient#list_preauthenticated_requests.' if logger
+    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::RetentionRuleCollection RetentionRuleCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_retention_rules.rb.html) to see an example of how to use list_retention_rules API.
+    def list_retention_rules(namespace_name, bucket_name, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#list_retention_rules.' if logger
 
-      raise "Missing the required parameter 'namespace_name' when calling list_preauthenticated_requests." if namespace_name.nil?
-      raise "Missing the required parameter 'bucket_name' when calling list_preauthenticated_requests." if bucket_name.nil?
+      raise "Missing the required parameter 'namespace_name' when calling list_retention_rules." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling list_retention_rules." if bucket_name.nil?
       raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
       raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
 
-      path = '/n/{namespaceName}/b/{bucketName}/p/'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
+      path = '/n/{namespaceName}/b/{bucketName}/retentionRules'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
       # Query Params
       query_params = {}
-      query_params[:objectNamePrefix] = opts[:object_name_prefix] if opts[:object_name_prefix]
-      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-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
       # rubocop:enable Style/NegatedIf
 
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_preauthenticated_requests') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#list_retention_rules') do
         @api_client.call_api(
           :GET,
           path,
@@ -1801,7 +2572,7 @@ module OCI
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
           body: post_body,
-          return_type: 'Array<OCI::ObjectStorage::Models::PreauthenticatedRequestSummary>'
+          return_type: 'OCI::ObjectStorage::Models::RetentionRuleCollection'
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -1824,6 +2595,7 @@ module OCI
     # @option opts [Integer] :limit The maximum number of items to return.
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::WorkRequestError WorkRequestError}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_work_request_errors.rb.html) to see an example of how to use list_work_request_errors API.
     def list_work_request_errors(work_request_id, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#list_work_request_errors.' if logger
 
@@ -1881,6 +2653,7 @@ module OCI
     # @option opts [Integer] :limit The maximum number of items to return.
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::WorkRequestLogEntry WorkRequestLogEntry}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_work_request_logs.rb.html) to see an example of how to use list_work_request_logs API.
     def list_work_request_logs(work_request_id, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#list_work_request_logs.' if logger
 
@@ -1939,6 +2712,7 @@ module OCI
     # @option opts [String] :page The page at which to start retrieving results.
     # @option opts [Integer] :limit The maximum number of items to return.
     # @return [Response] A Response object with data of type Array<{OCI::ObjectStorage::Models::WorkRequestSummary WorkRequestSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/list_work_requests.rb.html) to see an example of how to use list_work_requests API.
     def list_work_requests(compartment_id, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#list_work_requests.' if logger
 
@@ -1987,8 +2761,76 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new object or overwrites an existing one. See [Special Instructions for Object Storage
-    # PUT](https://docs.cloud.oracle.com/Content/API/Concepts/signingrequests.htm#ObjectStoragePut) for request signature requirements.
+    # Stops replication to the destination bucket and removes the replication policy. When the replication
+    # policy was created, this destination bucket became read-only except for new and changed objects replicated
+    # automatically from the source bucket. MakeBucketWritable removes the replication policy. This bucket is no
+    # longer the target for replication and is now writable, allowing users to make changes to bucket contents.
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @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_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/make_bucket_writable.rb.html) to see an example of how to use make_bucket_writable API.
+    def make_bucket_writable(namespace_name, bucket_name, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#make_bucket_writable.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling make_bucket_writable." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling make_bucket_writable." if bucket_name.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+
+      path = '/n/{namespaceName}/b/{bucketName}/actions/makeBucketWritable'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.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-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#make_bucket_writable') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body
+        )
+      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
+
+
+    # Creates a new object or overwrites an existing object with the same name. The maximum object size allowed by
+    # PutObject is 50 GiB.
+    #
+    # See [Object Names](https://docs.cloud.oracle.com/Content/Object/Tasks/managingobjects.htm#namerequirements)
+    # for object naming requirements.
+    #
+    # See [Special Instructions for Object Storage PUT](https://docs.cloud.oracle.com/Content/API/Concepts/signingrequests.htm#ObjectStoragePut)
+    # for request signature requirements.
     #
     # @param [String] namespace_name The Object Storage namespace used for the request.
     # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
@@ -2011,18 +2853,54 @@ module OCI
     #
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
     # @option opts [String] :expect 100-continue (default to 100-continue)
-    # @option opts [String] :content_md5 The base-64 encoded MD5 hash of the body. If the Content-MD5 header is present, Object Storage performs an integrity check
-    #   on the body of the HTTP request by computing the MD5 hash for the body and comparing it to the MD5 hash supplied in the header.
-    #   If the two hashes do not match, the object is rejected and an HTTP-400 Unmatched Content MD5 error is returned with the message:
+    # @option opts [String] :content_md5 The optional base-64 header that defines the encoded MD5 hash of the body. If the optional Content-MD5 header is present, Object
+    #   Storage performs an integrity check on the body of the HTTP request by computing the MD5 hash for the body and comparing it to the
+    #   MD5 hash supplied in the header. If the two hashes do not match, the object is rejected and an HTTP-400 Unmatched Content MD5 error
+    #   is returned with the message:
     #
     #   \"The computed MD5 of the request body (ACTUAL_MD5) does not match the Content-MD5 header (HEADER_MD5)\"
     #
-    # @option opts [String] :content_type The content type of the object.  Defaults to 'application/octet-stream' if not overridden during the PutObject call.
-    # @option opts [String] :content_language The content language of the object.
-    # @option opts [String] :content_encoding The content encoding of the object.
+    # @option opts [String] :content_type The optional Content-Type header that defines the standard MIME type format of the object. Content type defaults to
+    #   'application/octet-stream' if not specified in the PutObject call. Specifying values for this header has no effect
+    #   on Object Storage behavior. Programs that read the object determine what to do based on the value provided. For example,
+    #   you could use this header to identify and perform special operations on text only objects.
+    #
+    # @option opts [String] :content_language The optional Content-Language header that defines the content language of the object to upload. Specifying
+    #   values for this header has no effect on Object Storage behavior. Programs that read the object determine what
+    #   to do based on the value provided. For example, you could use this header to identify and differentiate objects
+    #   based on a particular language.
+    #
+    # @option opts [String] :content_encoding The optional Content-Encoding header that defines the content encodings that were applied to the object to
+    #   upload. Specifying values for this header has no effect on Object Storage behavior. Programs that read the
+    #   object determine what to do based on the value provided. For example, you could use this header to determine
+    #   what decoding mechanisms need to be applied to obtain the media-type specified by the Content-Type header of
+    #   the object.
+    #
+    # @option opts [String] :content_disposition The optional Content-Disposition header that defines presentational information for the object to be
+    #   returned in GetObject and HeadObject responses. Specifying values for this header has no effect on Object
+    #   Storage behavior. Programs that read the object determine what to do based on the value provided.
+    #   For example, you could use this header to let users download objects with custom filenames in a browser.
+    #
+    # @option opts [String] :cache_control The optional Cache-Control header that defines the caching behavior value to be returned in GetObject and
+    #   HeadObject responses. Specifying values for this header has no effect on Object Storage behavior. Programs
+    #   that read the object determine what to do based on the value provided.
+    #   For example, you could use this header to identify objects that require caching restrictions.
+    #
+    # @option opts [String] :opc_sse_customer_algorithm The optional header that specifies \"AES256\" as the encryption algorithm. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or
+    #   decrypt the data. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key_sha256 The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This
+    #   value is used to check the integrity of the encryption key. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
     # @option opts [Hash<String, String>] :opc_meta Optional user-defined metadata key and value.
     #   "opc-meta-" will be appended to each Hash key before it is sent to the server.
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/put_object.rb.html) to see an example of how to use put_object API.
     def put_object(namespace_name, bucket_name, object_name, put_object_body, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#put_object.' if logger
 
@@ -2053,6 +2931,11 @@ module OCI
       header_params[:'content-type'] = opts[:content_type] if opts[:content_type]
       header_params[:'content-language'] = opts[:content_language] if opts[:content_language]
       header_params[:'content-encoding'] = opts[:content_encoding] if opts[:content_encoding]
+      header_params[:'content-disposition'] = opts[:content_disposition] if opts[:content_disposition]
+      header_params[:'cache-control'] = opts[:cache_control] if opts[:cache_control]
+      header_params[:'opc-sse-customer-algorithm'] = opts[:opc_sse_customer_algorithm] if opts[:opc_sse_customer_algorithm]
+      header_params[:'opc-sse-customer-key'] = opts[:opc_sse_customer_key] if opts[:opc_sse_customer_key]
+      header_params[:'opc-sse-customer-key-sha256'] = opts[:opc_sse_customer_key_sha256] if opts[:opc_sse_customer_key_sha256]
       # rubocop:enable Style/NegatedIf
 
       if opts[:opc_meta]
@@ -2106,6 +2989,7 @@ module OCI
     #   part, this is the entity tag of the target part.
     #
     # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::ObjectLifecyclePolicy ObjectLifecyclePolicy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/put_object_lifecycle_policy.rb.html) to see an example of how to use put_object_lifecycle_policy API.
     def put_object_lifecycle_policy(namespace_name, bucket_name, put_object_lifecycle_policy_details, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#put_object_lifecycle_policy.' if logger
 
@@ -2157,15 +3041,21 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Reencrypts the data encryption key of the bucket and objects in the bucket. This is an asynchronous call, the
-    # system will start a work request task to reencrypt the data encryption key of the objects and chunks in the bucket.
-    # Only the objects created before the time the API call will be reencrypted. The call can take long time depending
-    # on how many objects in the bucket and how big the objects are. This API will return a work request id, so the user
-    # can use this id to retrieve the status of the work request task.
+    # Re-encrypts the unique data encryption key that encrypts each object written to the bucket by using the most recent
+    # version of the master encryption key assigned to the bucket. (All data encryption keys are encrypted by a master
+    # encryption key. Master encryption keys are assigned to buckets and managed by Oracle by default, but you can assign
+    # a key that you created and control through the Oracle Cloud Infrastructure Key Management service.) The kmsKeyId property
+    # of the bucket determines which master encryption key is assigned to the bucket. If you assigned a different Key Management
+    # master encryption key to the bucket, you can call this API to re-encrypt all data encryption keys with the newly
+    # assigned key. Similarly, you might want to re-encrypt all data encryption keys if the assigned key has been rotated to
+    # a new key version since objects were last added to the bucket. If you call this API and there is no kmsKeyId associated
+    # with the bucket, the call will fail.
     #
-    # A user can update kmsKeyId of the bucket, and then call this API, so the data encryption key of the bucket and
-    # objects in the bucket will be reencryped by the new kmsKeyId. Note that the system doesn't maintain what
-    # ksmKeyId is used to encrypt the object, the user has to maintain the mapping if they want.
+    # Calling this API starts a work request task to re-encrypt the data encryption key of all objects in the bucket. Only
+    # objects created before the time of the API call will be re-encrypted. The call can take a long time, depending on how many
+    # objects are in the bucket and how big they are. This API returns a work request ID that you can use to retrieve the status
+    # of the work request task.
+    # All the versions of objects will be re-encrypted whether versioning is enabled or suspended at the bucket.
     #
     # @param [String] namespace_name The Object Storage namespace used for the request.
     # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
@@ -2176,6 +3066,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/reencrypt_bucket.rb.html) to see an example of how to use reencrypt_bucket API.
     def reencrypt_bucket(namespace_name, bucket_name, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#reencrypt_bucket.' if logger
 
@@ -2223,8 +3114,87 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Re-encrypts the data encryption keys that encrypt the object and its chunks. By default, when you create a bucket, the Object Storage
+    # service manages the master encryption key used to encrypt each object's data encryption keys. The encryption mechanism that you specify for
+    # the bucket applies to the objects it contains.
+    #
+    # You can alternatively employ one of these encryption strategies for an object:
+    #
+    # - You can assign a key that you created and control through the Oracle Cloud Infrastructure Vault service.
+    #
+    # - You can encrypt an object using your own encryption key. The key you supply is known as a customer-provided encryption key (SSE-C).
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @param [String] object_name The name of the object. Avoid entering confidential information.
+    #   Example: `test/object1.log`
+    #
+    # @param [OCI::ObjectStorage::Models::ReencryptObjectDetails] reencrypt_object_details Request object for re-encrypting the data encryption key associated with an object.
+    # @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] :version_id VersionId used to identify a particular version of the object
+    # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/reencrypt_object.rb.html) to see an example of how to use reencrypt_object API.
+    def reencrypt_object(namespace_name, bucket_name, object_name, reencrypt_object_details, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#reencrypt_object.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling reencrypt_object." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling reencrypt_object." if bucket_name.nil?
+      raise "Missing the required parameter 'object_name' when calling reencrypt_object." if object_name.nil?
+      raise "Missing the required parameter 'reencrypt_object_details' when calling reencrypt_object." if reencrypt_object_details.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+      raise "Parameter value for 'object_name' must not be blank" if OCI::Internal::Util.blank_string?(object_name)
+
+      path = '/n/{namespaceName}/b/{bucketName}/actions/reencrypt/{objectName}'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s).sub('{objectName}', object_name.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:versionId] = opts[:version_id] if opts[:version_id]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = @api_client.object_to_http_body(reencrypt_object_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#reencrypt_object') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body
+        )
+      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
+
+
     # Rename an object in the given Object Storage namespace.
     #
+    # See [Object Names](https://docs.cloud.oracle.com/Content/Object/Tasks/managingobjects.htm#namerequirements)
+    # for object naming requirements.
+    #
     # @param [String] namespace_name The Object Storage namespace used for the request.
     # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
     #   Example: `my-new-bucket1`
@@ -2235,6 +3205,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/rename_object.rb.html) to see an example of how to use rename_object API.
     def rename_object(namespace_name, bucket_name, rename_object_details, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#rename_object.' if logger
 
@@ -2296,6 +3267,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/restore_objects.rb.html) to see an example of how to use restore_objects API.
     def restore_objects(namespace_name, bucket_name, restore_objects_details, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#restore_objects.' if logger
 
@@ -2363,6 +3335,7 @@ module OCI
     #
     # @option opts [String] :opc_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::Bucket Bucket}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/update_bucket.rb.html) to see an example of how to use update_bucket API.
     def update_bucket(namespace_name, bucket_name, update_bucket_details, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#update_bucket.' if logger
 
@@ -2428,6 +3401,7 @@ module OCI
     #   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_client_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::NamespaceMetadata NamespaceMetadata}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/update_namespace_metadata.rb.html) to see an example of how to use update_namespace_metadata API.
     def update_namespace_metadata(namespace_name, update_namespace_metadata_details, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#update_namespace_metadata.' if logger
 
@@ -2475,6 +3449,75 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Updates the specified retention rule. Rule changes take effect typically within 30 seconds.
+    #
+    # @param [String] namespace_name The Object Storage namespace used for the request.
+    # @param [String] bucket_name The name of the bucket. Avoid entering confidential information.
+    #   Example: `my-new-bucket1`
+    #
+    # @param [String] retention_rule_id The ID of the retention rule.
+    # @param [OCI::ObjectStorage::Models::UpdateRetentionRuleDetails] update_retention_rule_details Request object for updating the retention rule.
+    # @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] :if_match The entity tag (ETag) to match. For creating and committing a multipart upload to an object, this is the entity tag of the target object.
+    #   For uploading a part, this is the entity tag of the target part.
+    #
+    # @option opts [String] :opc_client_request_id The client request ID for tracing.
+    # @return [Response] A Response object with data of type {OCI::ObjectStorage::Models::RetentionRule RetentionRule}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/update_retention_rule.rb.html) to see an example of how to use update_retention_rule API.
+    def update_retention_rule(namespace_name, bucket_name, retention_rule_id, update_retention_rule_details, opts = {})
+      logger.debug 'Calling operation ObjectStorageClient#update_retention_rule.' if logger
+
+      raise "Missing the required parameter 'namespace_name' when calling update_retention_rule." if namespace_name.nil?
+      raise "Missing the required parameter 'bucket_name' when calling update_retention_rule." if bucket_name.nil?
+      raise "Missing the required parameter 'retention_rule_id' when calling update_retention_rule." if retention_rule_id.nil?
+      raise "Missing the required parameter 'update_retention_rule_details' when calling update_retention_rule." if update_retention_rule_details.nil?
+      raise "Parameter value for 'namespace_name' must not be blank" if OCI::Internal::Util.blank_string?(namespace_name)
+      raise "Parameter value for 'bucket_name' must not be blank" if OCI::Internal::Util.blank_string?(bucket_name)
+      raise "Parameter value for 'retention_rule_id' must not be blank" if OCI::Internal::Util.blank_string?(retention_rule_id)
+
+      path = '/n/{namespaceName}/b/{bucketName}/retentionRules/{retentionRuleId}'.sub('{namespaceName}', namespace_name.to_s).sub('{bucketName}', bucket_name.to_s).sub('{retentionRuleId}', retention_rule_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[:'if-match'] = opts[:if_match] if opts[:if_match]
+      header_params[:'opc-client-request-id'] = opts[:opc_client_request_id] if opts[:opc_client_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = @api_client.object_to_http_body(update_retention_rule_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ObjectStorageClient#update_retention_rule') do
+        @api_client.call_api(
+          :PUT,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'OCI::ObjectStorage::Models::RetentionRule'
+        )
+      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
+
+
     # Uploads a single part of a multipart upload.
     #
     # @param [String] namespace_name The Object Storage namespace used for the request.
@@ -2500,13 +3543,26 @@ module OCI
     #   part, this is the entity tag of the target part.
     #
     # @option opts [String] :expect 100-continue (default to 100-continue)
-    # @option opts [String] :content_md5 The base-64 encoded MD5 hash of the body. If the Content-MD5 header is present, Object Storage performs an integrity check
-    #   on the body of the HTTP request by computing the MD5 hash for the body and comparing it to the MD5 hash supplied in the header.
-    #   If the two hashes do not match, the object is rejected and an HTTP-400 Unmatched Content MD5 error is returned with the message:
+    # @option opts [String] :content_md5 The optional base-64 header that defines the encoded MD5 hash of the body. If the optional Content-MD5 header is present, Object
+    #   Storage performs an integrity check on the body of the HTTP request by computing the MD5 hash for the body and comparing it to the
+    #   MD5 hash supplied in the header. If the two hashes do not match, the object is rejected and an HTTP-400 Unmatched Content MD5 error
+    #   is returned with the message:
     #
     #   \"The computed MD5 of the request body (ACTUAL_MD5) does not match the Content-MD5 header (HEADER_MD5)\"
     #
+    # @option opts [String] :opc_sse_customer_algorithm The optional header that specifies \"AES256\" as the encryption algorithm. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key The optional header that specifies the base64-encoded 256-bit encryption key to use to encrypt or
+    #   decrypt the data. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
+    # @option opts [String] :opc_sse_customer_key_sha256 The optional header that specifies the base64-encoded SHA256 hash of the encryption key. This
+    #   value is used to check the integrity of the encryption key. For more information, see
+    #   [Using Your Own Keys for Server-Side Encryption](https://docs.cloud.oracle.com/Content/Object/Tasks/usingyourencryptionkeys.htm).
+    #
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/objectstorage/upload_part.rb.html) to see an example of how to use upload_part API.
     def upload_part(namespace_name, bucket_name, object_name, upload_id, upload_part_num, upload_part_body, opts = {})
       logger.debug 'Calling operation ObjectStorageClient#upload_part.' if logger
 
@@ -2538,6 +3594,9 @@ module OCI
       header_params[:expect] = opts[:expect] if opts[:expect]
       header_params[:'content-length'] = opts[:content_length] if opts[:content_length]
       header_params[:'content-md5'] = opts[:content_md5] if opts[:content_md5]
+      header_params[:'opc-sse-customer-algorithm'] = opts[:opc_sse_customer_algorithm] if opts[:opc_sse_customer_algorithm]
+      header_params[:'opc-sse-customer-key'] = opts[:opc_sse_customer_key] if opts[:opc_sse_customer_key]
+      header_params[:'opc-sse-customer-key-sha256'] = opts[:opc_sse_customer_key_sha256] if opts[:opc_sse_customer_key_sha256]
       # rubocop:enable Style/NegatedIf
       header_params[:'content-type'] ||= 'application/octet-stream'