oci 2.7.0 → 2.12.0

data/lib/oci/identity/identity_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'
@@ -50,27 +51,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
@@ -127,6 +117,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::MfaTotpDeviceSummary MfaTotpDeviceSummary}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/activate_mfa_totp_device.rb.html) to see an example of how to use activate_mfa_totp_device API.
     def activate_mfa_totp_device(user_id, mfa_totp_device_id, mfa_totp_token, opts = {})
       logger.debug 'Calling operation IdentityClient#activate_mfa_totp_device.' if logger
 
@@ -194,6 +185,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::UserGroupMembership UserGroupMembership}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/add_user_to_group.rb.html) to see an example of how to use add_user_to_group API.
     def add_user_to_group(add_user_to_group_details, opts = {})
       logger.debug 'Calling operation IdentityClient#add_user_to_group.' if logger
 
@@ -253,6 +245,7 @@ module OCI
     # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::TagDefaultSummary TagDefaultSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/assemble_effective_tag_set.rb.html) to see an example of how to use assemble_effective_tag_set API.
     def assemble_effective_tag_set(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#assemble_effective_tag_set.' if logger
 
@@ -303,19 +296,20 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Moves the specified tag namespace to the specified compartment within the same tenancy.
-    #
-    # To move the tag namespace, you must have the manage tag-namespaces permission on both compartments.
-    # For more information about IAM policies, see [Details for IAM](https://docs.cloud.oracle.com/Content/Identity/Reference/iampolicyreference.htm).
-    #
-    # Moving a tag namespace moves all the tag key definitions contained in the tag namespace.
-    #
-    # @param [String] tag_namespace_id The OCID of the tag namespace.
+    # Deletes multiple resources in the compartment. All resources must be in the same compartment. You must have the appropriate
+    # permissions to delete the resources in the request. This API can only be invoked from the tenancy's
+    # [home region](https://docs.cloud.oracle.com/Content/Identity/Tasks/managingregions.htm#Home). This operation creates a
+    # {WorkRequest}. Use the {#get_work_request get_work_request}
+    # API to monitor the status of the bulk action.
     #
-    # @param [OCI::Identity::Models::ChangeTagNamespaceCompartmentDetail] change_tag_namespace_compartment_detail Request object for changing the compartment of a tag namespace.
+    # @param [String] compartment_id The OCID of the compartment.
+    # @param [OCI::Identity::Models::BulkDeleteResourcesDetails] bulk_delete_resources_details Request object for bulk delete resources in a compartment.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #
     # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
     #   server error without risk of executing that same action again. Retry tokens expire after 24
     #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
@@ -323,14 +317,15 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type nil
-    def change_tag_namespace_compartment(tag_namespace_id, change_tag_namespace_compartment_detail, opts = {})
-      logger.debug 'Calling operation IdentityClient#change_tag_namespace_compartment.' if logger
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/bulk_delete_resources.rb.html) to see an example of how to use bulk_delete_resources API.
+    def bulk_delete_resources(compartment_id, bulk_delete_resources_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#bulk_delete_resources.' if logger
 
-      raise "Missing the required parameter 'tag_namespace_id' when calling change_tag_namespace_compartment." if tag_namespace_id.nil?
-      raise "Missing the required parameter 'change_tag_namespace_compartment_detail' when calling change_tag_namespace_compartment." if change_tag_namespace_compartment_detail.nil?
-      raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI::Internal::Util.blank_string?(tag_namespace_id)
+      raise "Missing the required parameter 'compartment_id' when calling bulk_delete_resources." if compartment_id.nil?
+      raise "Missing the required parameter 'bulk_delete_resources_details' when calling bulk_delete_resources." if bulk_delete_resources_details.nil?
+      raise "Parameter value for 'compartment_id' must not be blank" if OCI::Internal::Util.blank_string?(compartment_id)
 
-      path = '/tagNamespaces/{tagNamespaceId}/actions/changeCompartment'.sub('{tagNamespaceId}', tag_namespace_id.to_s)
+      path = '/compartments/{compartmentId}/actions/bulkDeleteResources'.sub('{compartmentId}', compartment_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -341,14 +336,15 @@ module OCI
       header_params = {}
       header_params[:accept] = 'application/json'
       header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
       header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
       # rubocop:enable Style/NegatedIf
       header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
 
-      post_body = @api_client.object_to_http_body(change_tag_namespace_compartment_detail)
+      post_body = @api_client.object_to_http_body(bulk_delete_resources_details)
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#change_tag_namespace_compartment') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#bulk_delete_resources') do
         @api_client.call_api(
           :POST,
           path,
@@ -370,37 +366,49 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new auth token for the specified user. For information about what auth tokens are for, see
-    # [Managing User Credentials](https://docs.cloud.oracle.com/Content/Identity/Tasks/managingcredentials.htm).
+    # Deletes the specified tag key definitions. This operation triggers a process that removes the
+    # tags from all resources in your tenancy. The tag key definitions must be within the same tag namespace.
     #
-    # You must specify a *description* for the auth token (although it can be an empty string). It does not
-    # have to be unique, and you can change it anytime with
-    # {#update_auth_token update_auth_token}.
+    # The following actions happen immediately:
+    # \u00A0
+    #   * If the tag is a cost-tracking tag, the tag no longer counts against your
+    #   10 cost-tracking tags limit, even if you do not disable the tag before running this operation.
+    #   * If the tag is used with dynamic groups, the rules that contain the tag are no longer
+    #   evaluated against the tag.
     #
-    # Every user has permission to create an auth token for *their own user ID*. An administrator in your organization
-    # does not need to write a policy to give users this ability. To compare, administrators who have permission to the
-    # tenancy can use this operation to create an auth token for any user, including themselves.
+    # After you start this operation, the state of the tag changes to DELETING, and tag removal
+    # from resources begins. This process can take up to 48 hours depending on the number of resources that
+    # are tagged and the regions in which those resources reside.
     #
-    # @param [OCI::Identity::Models::CreateAuthTokenDetails] create_auth_token_details Request object for creating a new auth token.
-    # @param [String] user_id The OCID of the user.
+    # When all tags have been removed, the state changes to DELETED. You cannot restore a deleted tag. After the tag state
+    # changes to DELETED, you can use the same tag name again.
+    #
+    # After you start this operation, you cannot start either the {#delete_tag delete_tag} or the {#cascade_delete_tag_namespace cascade_delete_tag_namespace} operation until this process completes.
+    #
+    # In order to delete tags, you must first retire the tags. Use {#update_tag update_tag}
+    # to retire a tag.
+    #
+    # @param [OCI::Identity::Models::BulkDeleteTagsDetails] bulk_delete_tags_details Request object for deleting tags in bulk.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #
     # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
     #   server error without risk of executing that same action again. Retry tokens expire after 24
     #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
     #   has been deleted and purged from the system, then a retry of the original creation request
     #   may be rejected).
     #
-    # @return [Response] A Response object with data of type {OCI::Identity::Models::AuthToken AuthToken}
-    def create_auth_token(create_auth_token_details, user_id, opts = {})
-      logger.debug 'Calling operation IdentityClient#create_auth_token.' if logger
+    # @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/identity/bulk_delete_tags.rb.html) to see an example of how to use bulk_delete_tags API.
+    def bulk_delete_tags(bulk_delete_tags_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#bulk_delete_tags.' if logger
 
-      raise "Missing the required parameter 'create_auth_token_details' when calling create_auth_token." if create_auth_token_details.nil?
-      raise "Missing the required parameter 'user_id' when calling create_auth_token." if user_id.nil?
-      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
+      raise "Missing the required parameter 'bulk_delete_tags_details' when calling bulk_delete_tags." if bulk_delete_tags_details.nil?
 
-      path = '/users/{userId}/authTokens/'.sub('{userId}', user_id.to_s)
+      path = '/tags/actions/bulkDelete'
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -411,14 +419,15 @@ module OCI
       header_params = {}
       header_params[:accept] = 'application/json'
       header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
       header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
       # rubocop:enable Style/NegatedIf
       header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
 
-      post_body = @api_client.object_to_http_body(create_auth_token_details)
+      post_body = @api_client.object_to_http_body(bulk_delete_tags_details)
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_auth_token') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#bulk_delete_tags') do
         @api_client.call_api(
           :POST,
           path,
@@ -426,8 +435,7 @@ module OCI
           header_params: header_params,
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
-          body: post_body,
-          return_type: 'OCI::Identity::Models::AuthToken'
+          body: post_body
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -441,43 +449,41 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new compartment in the specified compartment.
-    #
-    # **Important:** Compartments cannot be deleted.
-    #
-    # Specify the parent compartment's OCID as the compartment ID in the request object. Remember that the tenancy
-    # is simply the root compartment. For information about OCIDs, see
-    # [Resource Identifiers](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    # Edits the specified list of tag key definitions for the selected resources.
+    # This operation triggers a process that edits the tags on all selected resources. The possible actions are:
     #
-    # You must also specify a *name* for the compartment, which must be unique across all compartments in
-    # your tenancy. You can use this name or the OCID when writing policies that apply
-    # to the compartment. For more information about policies, see
-    # [How Policies Work](https://docs.cloud.oracle.com/Content/Identity/Concepts/policies.htm).
+    #   * Add a defined tag when the tag does not already exist on the resource.
+    #   * Update the value for a defined tag when the tag is present on the resource.
+    #   * Add a defined tag when it does not already exist on the resource or update the value for a defined tag when the tag is present on the resource.
+    #   * Remove a defined tag from a resource. The tag is removed from the resource regardless of the tag value.
     #
-    # You must also specify a *description* for the compartment (although it can be an empty string). It does
-    # not have to be unique, and you can change it anytime with
-    # {#update_compartment update_compartment}.
+    # See {#bulk_edit_operation_details bulk_edit_operation_details} for more information.
     #
-    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
-    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    # The edits can include a combination of operations and tag sets.
+    # However, multiple operations cannot apply to one key definition in the same request.
+    # For example, if one request adds `tag set-1` to a resource and sets a tag value to `tag set-2`,
+    # `tag set-1` and `tag set-2` cannot have any common tag definitions.
     #
-    # @param [OCI::Identity::Models::CreateCompartmentDetails] create_compartment_details Request object for creating a new compartment.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #
     # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
     #   server error without risk of executing that same action again. Retry tokens expire after 24
     #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
     #   has been deleted and purged from the system, then a retry of the original creation request
     #   may be rejected).
     #
-    # @return [Response] A Response object with data of type {OCI::Identity::Models::Compartment Compartment}
-    def create_compartment(create_compartment_details, opts = {})
-      logger.debug 'Calling operation IdentityClient#create_compartment.' if logger
+    # @option opts [OCI::Identity::Models::BulkEditTagsDetails] :bulk_edit_tags_details The request object for bulk editing tags on resources in the compartment.
+    # @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/identity/bulk_edit_tags.rb.html) to see an example of how to use bulk_edit_tags API.
+    def bulk_edit_tags(opts = {})
+      logger.debug 'Calling operation IdentityClient#bulk_edit_tags.' if logger
 
-      raise "Missing the required parameter 'create_compartment_details' when calling create_compartment." if create_compartment_details.nil?
 
-      path = '/compartments/'
+      path = '/tags/actions/bulkEdit'
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -488,14 +494,15 @@ module OCI
       header_params = {}
       header_params[:accept] = 'application/json'
       header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
       header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
       # rubocop:enable Style/NegatedIf
       header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
 
-      post_body = @api_client.object_to_http_body(create_compartment_details)
+      post_body = @api_client.object_to_http_body(opts[:bulk_edit_tags_details])
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_compartment') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#bulk_edit_tags') do
         @api_client.call_api(
           :POST,
           path,
@@ -503,8 +510,7 @@ module OCI
           header_params: header_params,
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
-          body: post_body,
-          return_type: 'OCI::Identity::Models::Compartment'
+          body: post_body
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -518,38 +524,36 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new secret key for the specified user. Secret keys are used for authentication with the Object Storage Service's Amazon S3
-    # compatible API. For information, see
-    # [Managing User Credentials](https://docs.cloud.oracle.com/Content/Identity/Tasks/managingcredentials.htm).
-    #
-    # You must specify a *description* for the secret key (although it can be an empty string). It does not
-    # have to be unique, and you can change it anytime with
-    # {#update_customer_secret_key update_customer_secret_key}.
+    # Moves multiple resources from one compartment to another. All resources must be in the same compartment.
+    # This API can only be invoked from the tenancy's [home region](https://docs.cloud.oracle.com/Content/Identity/Tasks/managingregions.htm#Home).
+    # To move resources, you must have the appropriate permissions to move the resource in both the source and target
+    # compartments. This operation creates a {WorkRequest}.
+    # Use the {#get_work_request get_work_request} API to monitor the status of the bulk action.
     #
-    # Every user has permission to create a secret key for *their own user ID*. An administrator in your organization
-    # does not need to write a policy to give users this ability. To compare, administrators who have permission to the
-    # tenancy can use this operation to create a secret key for any user, including themselves.
-    #
-    # @param [OCI::Identity::Models::CreateCustomerSecretKeyDetails] create_customer_secret_key_details Request object for creating a new secret key.
-    # @param [String] user_id The OCID of the user.
+    # @param [String] compartment_id The OCID of the compartment.
+    # @param [OCI::Identity::Models::BulkMoveResourcesDetails] bulk_move_resources_details Request object for bulk move resources in the compartment.
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #
     # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
     #   server error without risk of executing that same action again. Retry tokens expire after 24
     #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
     #   has been deleted and purged from the system, then a retry of the original creation request
     #   may be rejected).
     #
-    # @return [Response] A Response object with data of type {OCI::Identity::Models::CustomerSecretKey CustomerSecretKey}
-    def create_customer_secret_key(create_customer_secret_key_details, user_id, opts = {})
-      logger.debug 'Calling operation IdentityClient#create_customer_secret_key.' if logger
+    # @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/identity/bulk_move_resources.rb.html) to see an example of how to use bulk_move_resources API.
+    def bulk_move_resources(compartment_id, bulk_move_resources_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#bulk_move_resources.' if logger
 
-      raise "Missing the required parameter 'create_customer_secret_key_details' when calling create_customer_secret_key." if create_customer_secret_key_details.nil?
-      raise "Missing the required parameter 'user_id' when calling create_customer_secret_key." if user_id.nil?
-      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
+      raise "Missing the required parameter 'compartment_id' when calling bulk_move_resources." if compartment_id.nil?
+      raise "Missing the required parameter 'bulk_move_resources_details' when calling bulk_move_resources." if bulk_move_resources_details.nil?
+      raise "Parameter value for 'compartment_id' must not be blank" if OCI::Internal::Util.blank_string?(compartment_id)
 
-      path = '/users/{userId}/customerSecretKeys/'.sub('{userId}', user_id.to_s)
+      path = '/compartments/{compartmentId}/actions/bulkMoveResources'.sub('{compartmentId}', compartment_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -560,14 +564,15 @@ module OCI
       header_params = {}
       header_params[:accept] = 'application/json'
       header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
       header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
       # rubocop:enable Style/NegatedIf
       header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
 
-      post_body = @api_client.object_to_http_body(create_customer_secret_key_details)
+      post_body = @api_client.object_to_http_body(bulk_move_resources_details)
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_customer_secret_key') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#bulk_move_resources') do
         @api_client.call_api(
           :POST,
           path,
@@ -575,8 +580,7 @@ module OCI
           header_params: header_params,
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
-          body: post_body,
-          return_type: 'OCI::Identity::Models::CustomerSecretKey'
+          body: post_body
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -590,42 +594,53 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new dynamic group in your tenancy.
+    # Deletes the specified tag namespace. This operation triggers a process that removes all of the tags
+    # defined in the specified tag namespace from all resources in your tenancy and then deletes the tag namespace.
     #
-    # You must specify your tenancy's OCID as the compartment ID in the request object (remember that the tenancy
-    # is simply the root compartment). Notice that IAM resources (users, groups, compartments, and some policies)
-    # reside within the tenancy itself, unlike cloud resources such as compute instances, which typically
-    # reside within compartments inside the tenancy. For information about OCIDs, see
-    # [Resource Identifiers](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    # After you start the delete operation:
     #
-    # You must also specify a *name* for the dynamic group, which must be unique across all dynamic groups in your
-    # tenancy, and cannot be changed. Note that this name has to be also unique across all groups in your tenancy.
-    # You can use this name or the OCID when writing policies that apply to the dynamic group. For more information
-    # about policies, see [How Policies Work](https://docs.cloud.oracle.com/Content/Identity/Concepts/policies.htm).
+    #   * New tag key definitions cannot be created under the namespace.
+    #   * The state of the tag namespace changes to DELETING.
+    #   * Tag removal from the resources begins.
     #
-    # You must also specify a *description* for the dynamic group (although it can be an empty string). It does not
-    # have to be unique, and you can change it anytime with {#update_dynamic_group update_dynamic_group}.
+    # This process can take up to 48 hours depending on the number of tag definitions in the namespace, the number of resources
+    # that are tagged, and the locations of the regions in which those resources reside.
     #
-    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
-    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    # After all tags are removed, the state changes to DELETED. You cannot restore a deleted tag namespace. After the deleted tag namespace
+    # changes its state to DELETED, you can use the name of the deleted tag namespace again.
+    #
+    # After you start this operation, you cannot start either the {#delete_tag delete_tag} or the {#bulk_delete_tags bulk_delete_tags} operation until this process completes.
+    #
+    # To delete a tag namespace, you must first retire it. Use {#update_tag_namespace update_tag_namespace}
+    # to retire a tag namespace.
+    #
+    # @param [String] tag_namespace_id The OCID of the tag namespace.
     #
-    # @param [OCI::Identity::Models::CreateDynamicGroupDetails] create_dynamic_group_details Request object for creating a new dynamic group.
     # @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 For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #
+    # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #
     # @option opts [String] :opc_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
     #   server error without risk of executing that same action again. Retry tokens expire after 24
     #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
     #   has been deleted and purged from the system, then a retry of the original creation request
     #   may be rejected).
     #
-    # @return [Response] A Response object with data of type {OCI::Identity::Models::DynamicGroup DynamicGroup}
-    def create_dynamic_group(create_dynamic_group_details, opts = {})
-      logger.debug 'Calling operation IdentityClient#create_dynamic_group.' if logger
+    # @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/identity/cascade_delete_tag_namespace.rb.html) to see an example of how to use cascade_delete_tag_namespace API.
+    def cascade_delete_tag_namespace(tag_namespace_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#cascade_delete_tag_namespace.' if logger
 
-      raise "Missing the required parameter 'create_dynamic_group_details' when calling create_dynamic_group." if create_dynamic_group_details.nil?
+      raise "Missing the required parameter 'tag_namespace_id' when calling cascade_delete_tag_namespace." if tag_namespace_id.nil?
+      raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI::Internal::Util.blank_string?(tag_namespace_id)
 
-      path = '/dynamicGroups/'
+      path = '/tagNamespaces/{tagNamespaceId}/actions/cascadeDelete'.sub('{tagNamespaceId}', tag_namespace_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -636,14 +651,16 @@ 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[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
       header_params[:'opc-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
       # rubocop:enable Style/NegatedIf
       header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
 
-      post_body = @api_client.object_to_http_body(create_dynamic_group_details)
+      post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_dynamic_group') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#cascade_delete_tag_namespace') do
         @api_client.call_api(
           :POST,
           path,
@@ -651,8 +668,7 @@ module OCI
           header_params: header_params,
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
-          body: post_body,
-          return_type: 'OCI::Identity::Models::DynamicGroup'
+          body: post_body
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -666,29 +682,16 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new group in your tenancy.
-    #
-    # You must specify your tenancy's OCID as the compartment ID in the request object (remember that the tenancy
-    # is simply the root compartment). Notice that IAM resources (users, groups, compartments, and some policies)
-    # reside within the tenancy itself, unlike cloud resources such as compute instances, which typically
-    # reside within compartments inside the tenancy. For information about OCIDs, see
-    # [Resource Identifiers](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
-    #
-    # You must also specify a *name* for the group, which must be unique across all groups in your tenancy and
-    # cannot be changed. You can use this name or the OCID when writing policies that apply to the group. For more
-    # information about policies, see [How Policies Work](https://docs.cloud.oracle.com/Content/Identity/Concepts/policies.htm).
+    # Moves the specified tag namespace to the specified compartment within the same tenancy.
     #
-    # You must also specify a *description* for the group (although it can be an empty string). It does not
-    # have to be unique, and you can change it anytime with {#update_group update_group}.
+    # To move the tag namespace, you must have the manage tag-namespaces permission on both compartments.
+    # For more information about IAM policies, see [Details for IAM](https://docs.cloud.oracle.com/Content/Identity/Reference/iampolicyreference.htm).
     #
-    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
-    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    # Moving a tag namespace moves all the tag key definitions contained in the tag namespace.
     #
-    # After creating the group, you need to put users in it and write policies for it.
-    # See {#add_user_to_group add_user_to_group} and
-    # {#create_policy create_policy}.
+    # @param [String] tag_namespace_id The OCID of the tag namespace.
     #
-    # @param [OCI::Identity::Models::CreateGroupDetails] create_group_details Request object for creating a new group.
+    # @param [OCI::Identity::Models::ChangeTagNamespaceCompartmentDetail] change_tag_namespace_compartment_detail Request object for changing the compartment of a tag namespace.
     # @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
@@ -698,13 +701,16 @@ module OCI
     #   has been deleted and purged from the system, then a retry of the original creation request
     #   may be rejected).
     #
-    # @return [Response] A Response object with data of type {OCI::Identity::Models::Group Group}
-    def create_group(create_group_details, opts = {})
-      logger.debug 'Calling operation IdentityClient#create_group.' if logger
+    # @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/identity/change_tag_namespace_compartment.rb.html) to see an example of how to use change_tag_namespace_compartment API.
+    def change_tag_namespace_compartment(tag_namespace_id, change_tag_namespace_compartment_detail, opts = {})
+      logger.debug 'Calling operation IdentityClient#change_tag_namespace_compartment.' if logger
 
-      raise "Missing the required parameter 'create_group_details' when calling create_group." if create_group_details.nil?
+      raise "Missing the required parameter 'tag_namespace_id' when calling change_tag_namespace_compartment." if tag_namespace_id.nil?
+      raise "Missing the required parameter 'change_tag_namespace_compartment_detail' when calling change_tag_namespace_compartment." if change_tag_namespace_compartment_detail.nil?
+      raise "Parameter value for 'tag_namespace_id' must not be blank" if OCI::Internal::Util.blank_string?(tag_namespace_id)
 
-      path = '/groups/'
+      path = '/tagNamespaces/{tagNamespaceId}/actions/changeCompartment'.sub('{tagNamespaceId}', tag_namespace_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -719,10 +725,10 @@ module OCI
       # rubocop:enable Style/NegatedIf
       header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
 
-      post_body = @api_client.object_to_http_body(create_group_details)
+      post_body = @api_client.object_to_http_body(change_tag_namespace_compartment_detail)
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_group') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#change_tag_namespace_compartment') do
         @api_client.call_api(
           :POST,
           path,
@@ -730,8 +736,7 @@ module OCI
           header_params: header_params,
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
-          body: post_body,
-          return_type: 'OCI::Identity::Models::Group'
+          body: post_body
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -745,26 +750,19 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new identity provider in your tenancy. For more information, see
-    # [Identity Providers and Federation](https://docs.cloud.oracle.com/Content/Identity/Concepts/federation.htm).
-    #
-    # You must specify your tenancy's OCID as the compartment ID in the request object.
-    # Remember that the tenancy is simply the root compartment. For information about
-    # OCIDs, see [Resource Identifiers](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
-    #
-    # You must also specify a *name* for the `IdentityProvider`, which must be unique
-    # across all `IdentityProvider` objects in your tenancy and cannot be changed.
+    # Creates a new auth token for the specified user. For information about what auth tokens are for, see
+    # [Managing User Credentials](https://docs.cloud.oracle.com/Content/Identity/Tasks/managingcredentials.htm).
     #
-    # You must also specify a *description* for the `IdentityProvider` (although
-    # it can be an empty string). It does not have to be unique, and you can change
-    # it anytime with
-    # {#update_identity_provider update_identity_provider}.
+    # You must specify a *description* for the auth token (although it can be an empty string). It does not
+    # have to be unique, and you can change it anytime with
+    # {#update_auth_token update_auth_token}.
     #
-    # After you send your request, the new object's `lifecycleState` will temporarily
-    # be CREATING. Before using the object, first make sure its `lifecycleState` has
-    # changed to ACTIVE.
+    # Every user has permission to create an auth token for *their own user ID*. An administrator in your organization
+    # does not need to write a policy to give users this ability. To compare, administrators who have permission to the
+    # tenancy can use this operation to create an auth token for any user, including themselves.
     #
-    # @param [OCI::Identity::Models::CreateIdentityProviderDetails] create_identity_provider_details Request object for creating a new SAML2 identity provider.
+    # @param [OCI::Identity::Models::CreateAuthTokenDetails] create_auth_token_details Request object for creating a new auth token.
+    # @param [String] user_id The OCID of the user.
     # @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
@@ -774,13 +772,16 @@ module OCI
     #   has been deleted and purged from the system, then a retry of the original creation request
     #   may be rejected).
     #
-    # @return [Response] A Response object with data of type {OCI::Identity::Models::IdentityProvider IdentityProvider}
-    def create_identity_provider(create_identity_provider_details, opts = {})
-      logger.debug 'Calling operation IdentityClient#create_identity_provider.' if logger
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::AuthToken AuthToken}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_auth_token.rb.html) to see an example of how to use create_auth_token API.
+    def create_auth_token(create_auth_token_details, user_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#create_auth_token.' if logger
 
-      raise "Missing the required parameter 'create_identity_provider_details' when calling create_identity_provider." if create_identity_provider_details.nil?
+      raise "Missing the required parameter 'create_auth_token_details' when calling create_auth_token." if create_auth_token_details.nil?
+      raise "Missing the required parameter 'user_id' when calling create_auth_token." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
 
-      path = '/identityProviders/'
+      path = '/users/{userId}/authTokens/'.sub('{userId}', user_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -795,10 +796,10 @@ module OCI
       # rubocop:enable Style/NegatedIf
       header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
 
-      post_body = @api_client.object_to_http_body(create_identity_provider_details)
+      post_body = @api_client.object_to_http_body(create_auth_token_details)
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_identity_provider') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_auth_token') do
         @api_client.call_api(
           :POST,
           path,
@@ -807,7 +808,7 @@ module OCI
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
           body: post_body,
-          return_type: 'OCI::Identity::Models::IdentityProvider'
+          return_type: 'OCI::Identity::Models::AuthToken'
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -821,11 +822,396 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a single mapping between an IdP group and an IAM Service
-    # {Group}.
+    # Creates a new compartment in the specified compartment.
     #
-    # @param [OCI::Identity::Models::CreateIdpGroupMappingDetails] create_idp_group_mapping_details Add a mapping from an SAML2.0 identity provider group to a BMC group.
-    # @param [String] identity_provider_id The OCID of the identity provider.
+    # **Important:** Compartments cannot be deleted.
+    #
+    # Specify the parent compartment's OCID as the compartment ID in the request object. Remember that the tenancy
+    # is simply the root compartment. For information about OCIDs, see
+    # [Resource Identifiers](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    #
+    # You must also specify a *name* for the compartment, which must be unique across all compartments in
+    # your tenancy. You can use this name or the OCID when writing policies that apply
+    # to the compartment. For more information about policies, see
+    # [How Policies Work](https://docs.cloud.oracle.com/Content/Identity/Concepts/policies.htm).
+    #
+    # You must also specify a *description* for the compartment (although it can be an empty string). It does
+    # not have to be unique, and you can change it anytime with
+    # {#update_compartment update_compartment}.
+    #
+    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
+    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    #
+    # @param [OCI::Identity::Models::CreateCompartmentDetails] create_compartment_details Request object for creating a new compartment.
+    # @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_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::Compartment Compartment}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_compartment.rb.html) to see an example of how to use create_compartment API.
+    def create_compartment(create_compartment_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#create_compartment.' if logger
+
+      raise "Missing the required parameter 'create_compartment_details' when calling create_compartment." if create_compartment_details.nil?
+
+      path = '/compartments/'
+      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-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(create_compartment_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_compartment') 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::Identity::Models::Compartment'
+        )
+      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 secret key for the specified user. Secret keys are used for authentication with the Object Storage Service's Amazon S3
+    # compatible API. The secret key consists of an Access Key/Secret Key pair. For information, see
+    # [Managing User Credentials](https://docs.cloud.oracle.com/Content/Identity/Tasks/managingcredentials.htm).
+    #
+    # You must specify a *description* for the secret key (although it can be an empty string). It does not
+    # have to be unique, and you can change it anytime with
+    # {#update_customer_secret_key update_customer_secret_key}.
+    #
+    # Every user has permission to create a secret key for *their own user ID*. An administrator in your organization
+    # does not need to write a policy to give users this ability. To compare, administrators who have permission to the
+    # tenancy can use this operation to create a secret key for any user, including themselves.
+    #
+    # @param [OCI::Identity::Models::CreateCustomerSecretKeyDetails] create_customer_secret_key_details Request object for creating a new secret key.
+    # @param [String] user_id The OCID of the user.
+    # @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_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::CustomerSecretKey CustomerSecretKey}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_customer_secret_key.rb.html) to see an example of how to use create_customer_secret_key API.
+    def create_customer_secret_key(create_customer_secret_key_details, user_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#create_customer_secret_key.' if logger
+
+      raise "Missing the required parameter 'create_customer_secret_key_details' when calling create_customer_secret_key." if create_customer_secret_key_details.nil?
+      raise "Missing the required parameter 'user_id' when calling create_customer_secret_key." if user_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
+
+      path = '/users/{userId}/customerSecretKeys/'.sub('{userId}', user_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-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(create_customer_secret_key_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_customer_secret_key') 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::Identity::Models::CustomerSecretKey'
+        )
+      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 dynamic group in your tenancy.
+    #
+    # You must specify your tenancy's OCID as the compartment ID in the request object (remember that the tenancy
+    # is simply the root compartment). Notice that IAM resources (users, groups, compartments, and some policies)
+    # reside within the tenancy itself, unlike cloud resources such as compute instances, which typically
+    # reside within compartments inside the tenancy. For information about OCIDs, see
+    # [Resource Identifiers](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    #
+    # You must also specify a *name* for the dynamic group, which must be unique across all dynamic groups in your
+    # tenancy, and cannot be changed. Note that this name has to be also unique across all groups in your tenancy.
+    # You can use this name or the OCID when writing policies that apply to the dynamic group. For more information
+    # about policies, see [How Policies Work](https://docs.cloud.oracle.com/Content/Identity/Concepts/policies.htm).
+    #
+    # You must also specify a *description* for the dynamic group (although it can be an empty string). It does not
+    # have to be unique, and you can change it anytime with {#update_dynamic_group update_dynamic_group}.
+    #
+    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
+    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    #
+    # @param [OCI::Identity::Models::CreateDynamicGroupDetails] create_dynamic_group_details Request object for creating a new dynamic group.
+    # @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_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::DynamicGroup DynamicGroup}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_dynamic_group.rb.html) to see an example of how to use create_dynamic_group API.
+    def create_dynamic_group(create_dynamic_group_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#create_dynamic_group.' if logger
+
+      raise "Missing the required parameter 'create_dynamic_group_details' when calling create_dynamic_group." if create_dynamic_group_details.nil?
+
+      path = '/dynamicGroups/'
+      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-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(create_dynamic_group_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_dynamic_group') 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::Identity::Models::DynamicGroup'
+        )
+      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 group in your tenancy.
+    #
+    # You must specify your tenancy's OCID as the compartment ID in the request object (remember that the tenancy
+    # is simply the root compartment). Notice that IAM resources (users, groups, compartments, and some policies)
+    # reside within the tenancy itself, unlike cloud resources such as compute instances, which typically
+    # reside within compartments inside the tenancy. For information about OCIDs, see
+    # [Resource Identifiers](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    #
+    # You must also specify a *name* for the group, which must be unique across all groups in your tenancy and
+    # cannot be changed. You can use this name or the OCID when writing policies that apply to the group. For more
+    # information about policies, see [How Policies Work](https://docs.cloud.oracle.com/Content/Identity/Concepts/policies.htm).
+    #
+    # You must also specify a *description* for the group (although it can be an empty string). It does not
+    # have to be unique, and you can change it anytime with {#update_group update_group}.
+    #
+    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
+    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    #
+    # After creating the group, you need to put users in it and write policies for it.
+    # See {#add_user_to_group add_user_to_group} and
+    # {#create_policy create_policy}.
+    #
+    # @param [OCI::Identity::Models::CreateGroupDetails] create_group_details Request object for creating a new group.
+    # @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_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::Group Group}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_group.rb.html) to see an example of how to use create_group API.
+    def create_group(create_group_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#create_group.' if logger
+
+      raise "Missing the required parameter 'create_group_details' when calling create_group." if create_group_details.nil?
+
+      path = '/groups/'
+      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-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(create_group_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_group') 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::Identity::Models::Group'
+        )
+      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 identity provider in your tenancy. For more information, see
+    # [Identity Providers and Federation](https://docs.cloud.oracle.com/Content/Identity/Concepts/federation.htm).
+    #
+    # You must specify your tenancy's OCID as the compartment ID in the request object.
+    # Remember that the tenancy is simply the root compartment. For information about
+    # OCIDs, see [Resource Identifiers](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    #
+    # You must also specify a *name* for the `IdentityProvider`, which must be unique
+    # across all `IdentityProvider` objects in your tenancy and cannot be changed.
+    #
+    # You must also specify a *description* for the `IdentityProvider` (although
+    # it can be an empty string). It does not have to be unique, and you can change
+    # it anytime with
+    # {#update_identity_provider update_identity_provider}.
+    #
+    # After you send your request, the new object's `lifecycleState` will temporarily
+    # be CREATING. Before using the object, first make sure its `lifecycleState` has
+    # changed to ACTIVE.
+    #
+    # @param [OCI::Identity::Models::CreateIdentityProviderDetails] create_identity_provider_details Request object for creating a new SAML2 identity provider.
+    # @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_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::IdentityProvider IdentityProvider}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_identity_provider.rb.html) to see an example of how to use create_identity_provider API.
+    def create_identity_provider(create_identity_provider_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#create_identity_provider.' if logger
+
+      raise "Missing the required parameter 'create_identity_provider_details' when calling create_identity_provider." if create_identity_provider_details.nil?
+
+      path = '/identityProviders/'
+      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-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(create_identity_provider_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_identity_provider') 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::Identity::Models::IdentityProvider'
+        )
+      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 single mapping between an IdP group and an IAM Service
+    # {Group}.
+    #
+    # @param [OCI::Identity::Models::CreateIdpGroupMappingDetails] create_idp_group_mapping_details Add a mapping from an SAML2.0 identity provider group to a BMC group.
+    # @param [String] identity_provider_id The OCID of the identity provider.
     # @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
@@ -836,6 +1222,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::IdpGroupMapping IdpGroupMapping}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_idp_group_mapping.rb.html) to see an example of how to use create_idp_group_mapping API.
     def create_idp_group_mapping(create_idp_group_mapping_details, identity_provider_id, opts = {})
       logger.debug 'Calling operation IdentityClient#create_idp_group_mapping.' if logger
 
@@ -897,6 +1284,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::MfaTotpDevice MfaTotpDevice}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_mfa_totp_device.rb.html) to see an example of how to use create_mfa_totp_device API.
     def create_mfa_totp_device(user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#create_mfa_totp_device.' if logger
 
@@ -944,6 +1332,149 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Creates a new network source in your tenancy.
+    #
+    # You must specify your tenancy's OCID as the compartment ID in the request object (remember that the tenancy
+    # is simply the root compartment). Notice that IAM resources (users, groups, compartments, and some policies)
+    # reside within the tenancy itself, unlike cloud resources such as compute instances, which typically
+    # reside within compartments inside the tenancy. For information about OCIDs, see
+    # [Resource Identifiers](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    #
+    # You must also specify a *name* for the network source, which must be unique across all network sources in your
+    # tenancy, and cannot be changed.
+    # You can use this name or the OCID when writing policies that apply to the network source. For more information
+    # about policies, see [How Policies Work](https://docs.cloud.oracle.com/Content/Identity/Concepts/policies.htm).
+    #
+    # You must also specify a *description* for the network source (although it can be an empty string). It does not
+    # have to be unique, and you can change it anytime with {#update_network_source update_network_source}.
+    #
+    # After you send your request, the new object's `lifecycleState` will temporarily be CREATING. Before using the
+    # object, first make sure its `lifecycleState` has changed to ACTIVE.
+    #
+    # After your network resource is created, you can use it in policy to restrict access to only requests made from an allowed
+    # IP address specified in your network source. For more information, see [Managing Network Sources](https://docs.cloud.oracle.com/Content/Identity/Tasks/managingnetworksources.htm).
+    #
+    # @param [OCI::Identity::Models::CreateNetworkSourceDetails] create_network_source_details Request object for creating a new network source.
+    # @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_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::NetworkSources NetworkSources}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_network_source.rb.html) to see an example of how to use create_network_source API.
+    def create_network_source(create_network_source_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#create_network_source.' if logger
+
+      raise "Missing the required parameter 'create_network_source_details' when calling create_network_source." if create_network_source_details.nil?
+
+      path = '/networkSources'
+      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-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(create_network_source_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_network_source') 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::Identity::Models::NetworkSources'
+        )
+      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 Oauth token for the user
+    #
+    # @param [String] user_id The OCID of the user.
+    # @param [OCI::Identity::Models::CreateOAuth2ClientCredentialDetails] create_o_auth2_client_credential_details Request object containing the information required to generate an Oauth token.
+    # @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_retry_token A token that uniquely identifies a request so it can be retried in case of a timeout or
+    #   server error without risk of executing that same action again. Retry tokens expire after 24
+    #   hours, but can be invalidated before then due to conflicting operations (e.g., if a resource
+    #   has been deleted and purged from the system, then a retry of the original creation request
+    #   may be rejected).
+    #
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::OAuth2ClientCredential OAuth2ClientCredential}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_o_auth_client_credential.rb.html) to see an example of how to use create_o_auth_client_credential API.
+    def create_o_auth_client_credential(user_id, create_o_auth2_client_credential_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#create_o_auth_client_credential.' if logger
+
+      raise "Missing the required parameter 'user_id' when calling create_o_auth_client_credential." if user_id.nil?
+      raise "Missing the required parameter 'create_o_auth2_client_credential_details' when calling create_o_auth_client_credential." if create_o_auth2_client_credential_details.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
+
+      path = '/users/{userId}/oauth2ClientCredentials'.sub('{userId}', user_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-retry-token'] = opts[:opc_retry_token] if opts[:opc_retry_token]
+      # rubocop:enable Style/NegatedIf
+      header_params[:'opc-retry-token'] ||= OCI::Retry.generate_opc_retry_token
+
+      post_body = @api_client.object_to_http_body(create_o_auth2_client_credential_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#create_o_auth_client_credential') 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::Identity::Models::OAuth2ClientCredential'
+        )
+      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 Console one-time password for the specified user. For more information about user
     # credentials, see [User Credentials](https://docs.cloud.oracle.com/Content/Identity/Concepts/usercredentials.htm).
     #
@@ -967,6 +1498,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::UIPassword UIPassword}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_or_reset_ui_password.rb.html) to see an example of how to use create_or_reset_ui_password API.
     def create_or_reset_ui_password(user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#create_or_reset_ui_password.' if logger
 
@@ -1043,6 +1575,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Policy Policy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_policy.rb.html) to see an example of how to use create_policy API.
     def create_policy(create_policy_details, opts = {})
       logger.debug 'Calling operation IdentityClient#create_policy.' if logger
 
@@ -1103,6 +1636,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::RegionSubscription RegionSubscription}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_region_subscription.rb.html) to see an example of how to use create_region_subscription API.
     def create_region_subscription(create_region_subscription_details, tenancy_id, opts = {})
       logger.debug 'Calling operation IdentityClient#create_region_subscription.' if logger
 
@@ -1168,6 +1702,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::SmtpCredential SmtpCredential}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_smtp_credential.rb.html) to see an example of how to use create_smtp_credential API.
     def create_smtp_credential(create_smtp_credential_details, user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#create_smtp_credential.' if logger
 
@@ -1241,6 +1776,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::SwiftPassword SwiftPassword}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_swift_password.rb.html) to see an example of how to use create_swift_password API.
     def create_swift_password(create_swift_password_details, user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#create_swift_password.' if logger
 
@@ -1291,21 +1827,26 @@ module OCI
 
     # Creates a new tag in the specified tag namespace.
     #
-    # You must specify either the OCID or the name of the tag namespace that will contain this tag definition.
+    # The tag requires either the OCID or the name of the tag namespace that will contain this
+    # tag definition.
     #
-    # You must also specify a *name* for the tag, which must be unique across all tags in the tag namespace
+    # You must specify a *name* for the tag, which must be unique across all tags in the tag namespace
     # and cannot be changed. The name can contain any ASCII character except the space (_) or period (.) characters.
     # Names are case insensitive. That means, for example, \"myTag\" and \"mytag\" are not allowed in the same namespace.
     # If you specify a name that's already in use in the tag namespace, a 409 error is returned.
     #
-    # You must also specify a *description* for the tag.
-    # It does not have to be unique, and you can change it with
+    # The tag must have a *description*. It does not have to be unique, and you can change it with
     # {#update_tag update_tag}.
     #
-    # If no 'validator' is set on this tag definition, then any (valid) value can be set for this definedTag.
+    # The tag must have a value type, which is specified with a validator. Tags can use either a
+    # static value or a list of possible values. Static values are entered by a user applying the tag
+    # to a resource. Lists are created by you and the user must apply a value from the list. Lists
+    # are validiated.
     #
-    # If a 'validator' is set on this tag definition, then the only valid values that can be set for this
-    # definedTag those that pass the additional validation imposed by the set 'validator'.
+    # * If no `validator` is set, the user applying the tag to a resource can type in a static
+    # value or leave the tag value empty.
+    # * If a `validator` is set, the user applying the tag to a resource must select from a list
+    # of values that you supply with {#enum_tag_definition_validator enum_tag_definition_validator}.
     #
     # @param [String] tag_namespace_id The OCID of the tag namespace.
     #
@@ -1320,6 +1861,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Tag Tag}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_tag.rb.html) to see an example of how to use create_tag API.
     def create_tag(tag_namespace_id, create_tag_details, opts = {})
       logger.debug 'Calling operation IdentityClient#create_tag.' if logger
 
@@ -1391,6 +1933,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::TagDefault TagDefault}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_tag_default.rb.html) to see an example of how to use create_tag_default API.
     def create_tag_default(create_tag_default_details, opts = {})
       logger.debug 'Calling operation IdentityClient#create_tag_default.' if logger
 
@@ -1464,6 +2007,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::TagNamespace TagNamespace}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_tag_namespace.rb.html) to see an example of how to use create_tag_namespace API.
     def create_tag_namespace(create_tag_namespace_details, opts = {})
       logger.debug 'Calling operation IdentityClient#create_tag_namespace.' if logger
 
@@ -1557,6 +2101,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::User User}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/create_user.rb.html) to see an example of how to use create_user API.
     def create_user(create_user_details, opts = {})
       logger.debug 'Calling operation IdentityClient#create_user.' if logger
 
@@ -1620,6 +2165,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/delete_api_key.rb.html) to see an example of how to use delete_api_key API.
     def delete_api_key(user_id, fingerprint, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_api_key.' if logger
 
@@ -1679,6 +2225,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/delete_auth_token.rb.html) to see an example of how to use delete_auth_token API.
     def delete_auth_token(user_id, auth_token_id, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_auth_token.' if logger
 
@@ -1737,6 +2284,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/delete_compartment.rb.html) to see an example of how to use delete_compartment API.
     def delete_compartment(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_compartment.' if logger
 
@@ -1794,6 +2342,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/delete_customer_secret_key.rb.html) to see an example of how to use delete_customer_secret_key API.
     def delete_customer_secret_key(user_id, customer_secret_key_id, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_customer_secret_key.' if logger
 
@@ -1802,7 +2351,121 @@ module OCI
       raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
       raise "Parameter value for 'customer_secret_key_id' must not be blank" if OCI::Internal::Util.blank_string?(customer_secret_key_id)
 
-      path = '/users/{userId}/customerSecretKeys/{customerSecretKeyId}'.sub('{userId}', user_id.to_s).sub('{customerSecretKeyId}', customer_secret_key_id.to_s)
+      path = '/users/{userId}/customerSecretKeys/{customerSecretKeyId}'.sub('{userId}', user_id.to_s).sub('{customerSecretKeyId}', customer_secret_key_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]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_customer_secret_key') 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 dynamic group.
+    #
+    # @param [String] dynamic_group_id The OCID of the dynamic group.
+    # @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 For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #
+    # @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/identity/delete_dynamic_group.rb.html) to see an example of how to use delete_dynamic_group API.
+    def delete_dynamic_group(dynamic_group_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#delete_dynamic_group.' if logger
+
+      raise "Missing the required parameter 'dynamic_group_id' when calling delete_dynamic_group." if dynamic_group_id.nil?
+      raise "Parameter value for 'dynamic_group_id' must not be blank" if OCI::Internal::Util.blank_string?(dynamic_group_id)
+
+      path = '/dynamicGroups/{dynamicGroupId}'.sub('{dynamicGroupId}', dynamic_group_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]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_dynamic_group') 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 group. The group must be empty.
+    #
+    # @param [String] group_id The OCID of the group.
+    # @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 For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #
+    # @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/identity/delete_group.rb.html) to see an example of how to use delete_group API.
+    def delete_group(group_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#delete_group.' if logger
+
+      raise "Missing the required parameter 'group_id' when calling delete_group." if group_id.nil?
+      raise "Parameter value for 'group_id' must not be blank" if OCI::Internal::Util.blank_string?(group_id)
+
+      path = '/groups/{groupId}'.sub('{groupId}', group_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -1819,7 +2482,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_customer_secret_key') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_group') do
         @api_client.call_api(
           :DELETE,
           path,
@@ -1841,9 +2504,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified dynamic group.
+    # Deletes the specified identity provider. The identity provider must not have
+    # any group mappings (see {IdpGroupMapping}).
     #
-    # @param [String] dynamic_group_id The OCID of the dynamic group.
+    # @param [String] identity_provider_id The OCID of the identity provider.
     # @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
@@ -1852,13 +2516,14 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
-    def delete_dynamic_group(dynamic_group_id, opts = {})
-      logger.debug 'Calling operation IdentityClient#delete_dynamic_group.' if logger
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/delete_identity_provider.rb.html) to see an example of how to use delete_identity_provider API.
+    def delete_identity_provider(identity_provider_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#delete_identity_provider.' if logger
 
-      raise "Missing the required parameter 'dynamic_group_id' when calling delete_dynamic_group." if dynamic_group_id.nil?
-      raise "Parameter value for 'dynamic_group_id' must not be blank" if OCI::Internal::Util.blank_string?(dynamic_group_id)
+      raise "Missing the required parameter 'identity_provider_id' when calling delete_identity_provider." if identity_provider_id.nil?
+      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util.blank_string?(identity_provider_id)
 
-      path = '/dynamicGroups/{dynamicGroupId}'.sub('{dynamicGroupId}', dynamic_group_id.to_s)
+      path = '/identityProviders/{identityProviderId}'.sub('{identityProviderId}', identity_provider_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -1875,7 +2540,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_dynamic_group') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_identity_provider') do
         @api_client.call_api(
           :DELETE,
           path,
@@ -1897,9 +2562,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified group. The group must be empty.
-    #
-    # @param [String] group_id The OCID of the group.
+    # Deletes the specified group mapping.
+    # @param [String] identity_provider_id The OCID of the identity provider.
+    # @param [String] mapping_id The OCID of the group mapping.
     # @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
@@ -1908,13 +2573,16 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
-    def delete_group(group_id, opts = {})
-      logger.debug 'Calling operation IdentityClient#delete_group.' if logger
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/delete_idp_group_mapping.rb.html) to see an example of how to use delete_idp_group_mapping API.
+    def delete_idp_group_mapping(identity_provider_id, mapping_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#delete_idp_group_mapping.' if logger
 
-      raise "Missing the required parameter 'group_id' when calling delete_group." if group_id.nil?
-      raise "Parameter value for 'group_id' must not be blank" if OCI::Internal::Util.blank_string?(group_id)
+      raise "Missing the required parameter 'identity_provider_id' when calling delete_idp_group_mapping." if identity_provider_id.nil?
+      raise "Missing the required parameter 'mapping_id' when calling delete_idp_group_mapping." if mapping_id.nil?
+      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util.blank_string?(identity_provider_id)
+      raise "Parameter value for 'mapping_id' must not be blank" if OCI::Internal::Util.blank_string?(mapping_id)
 
-      path = '/groups/{groupId}'.sub('{groupId}', group_id.to_s)
+      path = '/identityProviders/{identityProviderId}/groupMappings/{mappingId}'.sub('{identityProviderId}', identity_provider_id.to_s).sub('{mappingId}', mapping_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -1931,7 +2599,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_group') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_idp_group_mapping') do
         @api_client.call_api(
           :DELETE,
           path,
@@ -1953,10 +2621,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified identity provider. The identity provider must not have
-    # any group mappings (see {IdpGroupMapping}).
+    # Deletes the specified MFA TOTP device for the specified user.
     #
-    # @param [String] identity_provider_id The OCID of the identity provider.
+    # @param [String] user_id The OCID of the user.
+    # @param [String] mfa_totp_device_id The OCID of the MFA TOTP device.
     # @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
@@ -1965,13 +2633,16 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
-    def delete_identity_provider(identity_provider_id, opts = {})
-      logger.debug 'Calling operation IdentityClient#delete_identity_provider.' if logger
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/delete_mfa_totp_device.rb.html) to see an example of how to use delete_mfa_totp_device API.
+    def delete_mfa_totp_device(user_id, mfa_totp_device_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#delete_mfa_totp_device.' if logger
 
-      raise "Missing the required parameter 'identity_provider_id' when calling delete_identity_provider." if identity_provider_id.nil?
-      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util.blank_string?(identity_provider_id)
+      raise "Missing the required parameter 'user_id' when calling delete_mfa_totp_device." if user_id.nil?
+      raise "Missing the required parameter 'mfa_totp_device_id' when calling delete_mfa_totp_device." if mfa_totp_device_id.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
+      raise "Parameter value for 'mfa_totp_device_id' must not be blank" if OCI::Internal::Util.blank_string?(mfa_totp_device_id)
 
-      path = '/identityProviders/{identityProviderId}'.sub('{identityProviderId}', identity_provider_id.to_s)
+      path = '/users/{userId}/mfaTotpDevices/{mfaTotpDeviceId}'.sub('{userId}', user_id.to_s).sub('{mfaTotpDeviceId}', mfa_totp_device_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -1988,7 +2659,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_identity_provider') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_mfa_totp_device') do
         @api_client.call_api(
           :DELETE,
           path,
@@ -2010,9 +2681,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified group mapping.
-    # @param [String] identity_provider_id The OCID of the identity provider.
-    # @param [String] mapping_id The OCID of the group mapping.
+    # Deletes the specified network source
+    #
+    # @param [String] network_source_id The OCID of the network source.
     # @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
@@ -2021,15 +2692,14 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
-    def delete_idp_group_mapping(identity_provider_id, mapping_id, opts = {})
-      logger.debug 'Calling operation IdentityClient#delete_idp_group_mapping.' if logger
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/delete_network_source.rb.html) to see an example of how to use delete_network_source API.
+    def delete_network_source(network_source_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#delete_network_source.' if logger
 
-      raise "Missing the required parameter 'identity_provider_id' when calling delete_idp_group_mapping." if identity_provider_id.nil?
-      raise "Missing the required parameter 'mapping_id' when calling delete_idp_group_mapping." if mapping_id.nil?
-      raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util.blank_string?(identity_provider_id)
-      raise "Parameter value for 'mapping_id' must not be blank" if OCI::Internal::Util.blank_string?(mapping_id)
+      raise "Missing the required parameter 'network_source_id' when calling delete_network_source." if network_source_id.nil?
+      raise "Parameter value for 'network_source_id' must not be blank" if OCI::Internal::Util.blank_string?(network_source_id)
 
-      path = '/identityProviders/{identityProviderId}/groupMappings/{mappingId}'.sub('{identityProviderId}', identity_provider_id.to_s).sub('{mappingId}', mapping_id.to_s)
+      path = '/networkSources/{networkSourceId}'.sub('{networkSourceId}', network_source_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -2046,7 +2716,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_idp_group_mapping') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_network_source') do
         @api_client.call_api(
           :DELETE,
           path,
@@ -2068,10 +2738,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified MFA TOTP device for the specified user.
+    # Delete Oauth token for the user
     #
     # @param [String] user_id The OCID of the user.
-    # @param [String] mfa_totp_device_id The OCID of the MFA TOTP device.
+    # @param [String] oauth2_client_credential_id The ID of the Oauth credential.
     # @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
@@ -2080,15 +2750,16 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
-    def delete_mfa_totp_device(user_id, mfa_totp_device_id, opts = {})
-      logger.debug 'Calling operation IdentityClient#delete_mfa_totp_device.' if logger
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/delete_o_auth_client_credential.rb.html) to see an example of how to use delete_o_auth_client_credential API.
+    def delete_o_auth_client_credential(user_id, oauth2_client_credential_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#delete_o_auth_client_credential.' if logger
 
-      raise "Missing the required parameter 'user_id' when calling delete_mfa_totp_device." if user_id.nil?
-      raise "Missing the required parameter 'mfa_totp_device_id' when calling delete_mfa_totp_device." if mfa_totp_device_id.nil?
+      raise "Missing the required parameter 'user_id' when calling delete_o_auth_client_credential." if user_id.nil?
+      raise "Missing the required parameter 'oauth2_client_credential_id' when calling delete_o_auth_client_credential." if oauth2_client_credential_id.nil?
       raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
-      raise "Parameter value for 'mfa_totp_device_id' must not be blank" if OCI::Internal::Util.blank_string?(mfa_totp_device_id)
+      raise "Parameter value for 'oauth2_client_credential_id' must not be blank" if OCI::Internal::Util.blank_string?(oauth2_client_credential_id)
 
-      path = '/users/{userId}/mfaTotpDevices/{mfaTotpDeviceId}'.sub('{userId}', user_id.to_s).sub('{mfaTotpDeviceId}', mfa_totp_device_id.to_s)
+      path = '/users/{userId}/oauth2ClientCredentials/{oauth2ClientCredentialId}'.sub('{userId}', user_id.to_s).sub('{oauth2ClientCredentialId}', oauth2_client_credential_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -2105,7 +2776,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_mfa_totp_device') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#delete_o_auth_client_credential') do
         @api_client.call_api(
           :DELETE,
           path,
@@ -2137,6 +2808,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/delete_policy.rb.html) to see an example of how to use delete_policy API.
     def delete_policy(policy_id, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_policy.' if logger
 
@@ -2194,6 +2866,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/delete_smtp_credential.rb.html) to see an example of how to use delete_smtp_credential API.
     def delete_smtp_credential(user_id, smtp_credential_id, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_smtp_credential.' if logger
 
@@ -2255,6 +2928,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/delete_swift_password.rb.html) to see an example of how to use delete_swift_password API.
     def delete_swift_password(user_id, swift_password_id, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_swift_password.' if logger
 
@@ -2312,12 +2986,15 @@ module OCI
     #   * If the tag was used with dynamic groups, none of the rules that contain the tag will
     #   be evaluated against the tag.
     #
-    # Once you start the delete operation, the state of the tag changes to DELETING and tag removal
+    # When you start the delete operation, the state of the tag changes to DELETING and tag removal
     # from resources begins. This can take up to 48 hours depending on the number of resources that
-    # were tagged as well as the regions in which those resources reside. When all tags have been
-    # removed, the state changes to DELETED. You cannot restore a deleted tag. Once the deleted tag
+    # were tagged as well as the regions in which those resources reside.
+    #
+    # When all tags have been removed, the state changes to DELETED. You cannot restore a deleted tag. Once the deleted tag
     # changes its state to DELETED, you can use the same tag name again.
     #
+    # After you start this operation, you cannot start either the {#bulk_delete_tags bulk_delete_tags} or the {#cascade_delete_tag_namespace cascade_delete_tag_namespace} operation until this process completes.
+    #
     # To delete a tag, you must first retire it. Use {#update_tag update_tag}
     # to retire a tag.
     #
@@ -2333,6 +3010,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/delete_tag.rb.html) to see an example of how to use delete_tag API.
     def delete_tag(tag_namespace_id, tag_name, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_tag.' if logger
 
@@ -2394,6 +3072,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/delete_tag_default.rb.html) to see an example of how to use delete_tag_default API.
     def delete_tag_default(tag_default_id, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_tag_default.' if logger
 
@@ -2440,8 +3119,11 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes the specified tag namespace. Only an empty tag namespace can be deleted. To delete
-    # a tag namespace, first delete all its tag definitions.
+    # Deletes the specified tag namespace. Only an empty tag namespace can be deleted with this operation. To use this operation
+    # to delete a tag namespace that contains tag definitions, first delete all of its tag definitions.
+    #
+    # Use {#cascade_delete_tag_namespace cascade_delete_tag_namespace} to delete a tag namespace along with all of
+    # the tag definitions contained within that namespace.
     #
     # Use {#delete_tag delete_tag} to delete a tag definition.
     #
@@ -2458,6 +3140,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @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/identity/delete_tag_namespace.rb.html) to see an example of how to use delete_tag_namespace API.
     def delete_tag_namespace(tag_namespace_id, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_tag_namespace.' if logger
 
@@ -2514,6 +3197,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/delete_user.rb.html) to see an example of how to use delete_user API.
     def delete_user(user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#delete_user.' if logger
 
@@ -2571,6 +3255,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::MfaTotpDevice MfaTotpDevice}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/generate_totp_seed.rb.html) to see an example of how to use generate_totp_seed API.
     def generate_totp_seed(user_id, mfa_totp_device_id, opts = {})
       logger.debug 'Calling operation IdentityClient#generate_totp_seed.' if logger
 
@@ -2628,6 +3313,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::AuthenticationPolicy AuthenticationPolicy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_authentication_policy.rb.html) to see an example of how to use get_authentication_policy API.
     def get_authentication_policy(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_authentication_policy.' if logger
 
@@ -2689,6 +3375,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Compartment Compartment}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_compartment.rb.html) to see an example of how to use get_compartment API.
     def get_compartment(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_compartment.' if logger
 
@@ -2743,6 +3430,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::DynamicGroup DynamicGroup}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_dynamic_group.rb.html) to see an example of how to use get_dynamic_group API.
     def get_dynamic_group(dynamic_group_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_dynamic_group.' if logger
 
@@ -2801,6 +3489,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Group Group}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_group.rb.html) to see an example of how to use get_group API.
     def get_group(group_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_group.' if logger
 
@@ -2854,6 +3543,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::IdentityProvider IdentityProvider}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_identity_provider.rb.html) to see an example of how to use get_identity_provider API.
     def get_identity_provider(identity_provider_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_identity_provider.' if logger
 
@@ -2908,6 +3598,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::IdpGroupMapping IdpGroupMapping}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_idp_group_mapping.rb.html) to see an example of how to use get_idp_group_mapping API.
     def get_idp_group_mapping(identity_provider_id, mapping_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_idp_group_mapping.' if logger
 
@@ -2965,6 +3656,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::MfaTotpDeviceSummary MfaTotpDeviceSummary}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_mfa_totp_device.rb.html) to see an example of how to use get_mfa_totp_device API.
     def get_mfa_totp_device(user_id, mfa_totp_device_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_mfa_totp_device.' if logger
 
@@ -3014,12 +3706,68 @@ module OCI
     # rubocop:disable Lint/UnusedMethodArgument
 
 
+    # Gets the specified network source's information.
+    #
+    # @param [String] network_source_id The OCID of the network source.
+    # @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
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::NetworkSources NetworkSources}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_network_source.rb.html) to see an example of how to use get_network_source API.
+    def get_network_source(network_source_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#get_network_source.' if logger
+
+      raise "Missing the required parameter 'network_source_id' when calling get_network_source." if network_source_id.nil?
+      raise "Parameter value for 'network_source_id' must not be blank" if OCI::Internal::Util.blank_string?(network_source_id)
+
+      path = '/networkSources/{networkSourceId}'.sub('{networkSourceId}', network_source_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'
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#get_network_source') 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::Identity::Models::NetworkSources'
+        )
+      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:enable Lint/UnusedMethodArgument
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+    # rubocop:disable Lint/UnusedMethodArgument
+
+
     # Gets the specified policy's information.
     # @param [String] policy_id The OCID of the 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Policy Policy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_policy.rb.html) to see an example of how to use get_policy API.
     def get_policy(policy_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_policy.' if logger
 
@@ -3076,6 +3824,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Tag Tag}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_tag.rb.html) to see an example of how to use get_tag API.
     def get_tag(tag_namespace_id, tag_name, opts = {})
       logger.debug 'Calling operation IdentityClient#get_tag.' if logger
 
@@ -3132,6 +3881,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::TagDefault TagDefault}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_tag_default.rb.html) to see an example of how to use get_tag_default API.
     def get_tag_default(tag_default_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_tag_default.' if logger
 
@@ -3187,6 +3937,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::TagNamespace TagNamespace}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_tag_namespace.rb.html) to see an example of how to use get_tag_namespace API.
     def get_tag_namespace(tag_namespace_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_tag_namespace.' if logger
 
@@ -3242,6 +3993,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::TaggingWorkRequest TaggingWorkRequest}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_tagging_work_request.rb.html) to see an example of how to use get_tagging_work_request API.
     def get_tagging_work_request(work_request_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_tagging_work_request.' if logger
 
@@ -3295,6 +4047,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Tenancy Tenancy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_tenancy.rb.html) to see an example of how to use get_tenancy API.
     def get_tenancy(tenancy_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_tenancy.' if logger
 
@@ -3348,6 +4101,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::User User}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_user.rb.html) to see an example of how to use get_user API.
     def get_user(user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_user.' if logger
 
@@ -3401,6 +4155,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::UserGroupMembership UserGroupMembership}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_user_group_membership.rb.html) to see an example of how to use get_user_group_membership API.
     def get_user_group_membership(user_group_membership_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_user_group_membership.' if logger
 
@@ -3456,6 +4211,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::UIPasswordInformation UIPasswordInformation}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/get_user_ui_password_information.rb.html) to see an example of how to use get_user_ui_password_information API.
     def get_user_ui_password_information(user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#get_user_ui_password_information.' if logger
 
@@ -3511,6 +4267,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::WorkRequest WorkRequest}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/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 IdentityClient#get_work_request.' if logger
 
@@ -3568,6 +4325,7 @@ 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
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::ApiKey ApiKey}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_api_keys.rb.html) to see an example of how to use list_api_keys API.
     def list_api_keys(user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_api_keys.' if logger
 
@@ -3623,6 +4381,7 @@ 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
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::AuthToken AuthToken}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_auth_tokens.rb.html) to see an example of how to use list_auth_tokens API.
     def list_auth_tokens(user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_auth_tokens.' if logger
 
@@ -3682,6 +4441,7 @@ 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
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::AvailabilityDomain AvailabilityDomain}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_availability_domains.rb.html) to see an example of how to use list_availability_domains API.
     def list_availability_domains(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_availability_domains.' if logger
 
@@ -3728,6 +4488,132 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Lists the resource-types supported by compartment bulk actions. Use this API to help you provide the correct
+    # resource-type information to the {#bulk_delete_resources bulk_delete_resources}
+    # and {#bulk_move_resources bulk_move_resources} operations. The returned list of
+    # resource-types provides the appropriate resource-type names to use with the bulk action operations along with
+    # the type of identifying information you'll need to provide for each resource-type. Most resource-types just
+    # require an [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) to identify a specific resource, but some resource-types,
+    # such as buckets, require you to provide other identifying information.
+    #
+    # @param [String] bulk_action_type The type of bulk action.
+    #
+    #   Allowed values are: BULK_MOVE_RESOURCES, BULK_DELETE_RESOURCES
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
+    #
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    #    (default to 20)
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::BulkActionResourceTypeCollection BulkActionResourceTypeCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_bulk_action_resource_types.rb.html) to see an example of how to use list_bulk_action_resource_types API.
+    def list_bulk_action_resource_types(bulk_action_type, opts = {})
+      logger.debug 'Calling operation IdentityClient#list_bulk_action_resource_types.' if logger
+
+      raise "Missing the required parameter 'bulk_action_type' when calling list_bulk_action_resource_types." if bulk_action_type.nil?
+      unless %w[BULK_MOVE_RESOURCES BULK_DELETE_RESOURCES].include?(bulk_action_type)
+        raise "Invalid value for 'bulk_action_type', must be one of BULK_MOVE_RESOURCES, BULK_DELETE_RESOURCES."
+      end
+
+      path = '/compartments/bulkActionResourceTypes'
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:bulkActionType] = bulk_action_type
+      query_params[:page] = opts[:page] if opts[:page]
+      query_params[:limit] = opts[:limit] if opts[:limit]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#list_bulk_action_resource_types') 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::Identity::Models::BulkActionResourceTypeCollection'
+        )
+      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 resource types that support bulk tag editing.
+    #
+    # @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] :page The value of the `opc-next-page` response header from the previous \"List\" call.
+    #
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    #    (default to 20)
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::BulkEditTagsResourceTypeCollection BulkEditTagsResourceTypeCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_bulk_edit_tags_resource_types.rb.html) to see an example of how to use list_bulk_edit_tags_resource_types API.
+    def list_bulk_edit_tags_resource_types(opts = {})
+      logger.debug 'Calling operation IdentityClient#list_bulk_edit_tags_resource_types.' if logger
+
+
+      path = '/tags/bulkEditResourceTypes'
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:page] = opts[:page] if opts[:page]
+      query_params[:limit] = opts[:limit] if opts[:limit]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#list_bulk_edit_tags_resource_types') 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::Identity::Models::BulkEditTagsResourceTypeCollection'
+        )
+      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 compartments in a specified compartment. The members of the list
     # returned depends on the values set for several parameters.
     #
@@ -3755,7 +4641,7 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @option opts [String] :access_level Valid values are `ANY` and `ACCESSIBLE`. Default is `ANY`.
     #   Setting this to `ACCESSIBLE` returns only those compartments for which the
     #   user has INSPECT permissions directly or indirectly (permissions can be on a
@@ -3771,7 +4657,26 @@ module OCI
     #   and all compartments and subcompartments in the tenancy are
     #   returned depending on the the setting of `accessLevel`.
     #
+    # @option opts [String] :name A filter to only return resources that match the given name exactly.
+    #
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for NAME is ascending. The NAME
+    #   sort order is case sensitive.
+    #
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #
+    #   Allowed values are: TIMECREATED, NAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The NAME sort order
+    #   is case sensitive.
+    #
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
+    #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::Compartment Compartment}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_compartments.rb.html) to see an example of how to use list_compartments API.
     def list_compartments(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_compartments.' if logger
 
@@ -3781,6 +4686,18 @@ module OCI
         raise 'Invalid value for "access_level", must be one of ANY, ACCESSIBLE.'
       end
 
+      if opts[:sort_by] && !%w[TIMECREATED NAME].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of TIMECREATED, NAME.'
+      end
+
+      if opts[:sort_order] && !%w[ASC DESC].include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:lifecycle_state] && !OCI::Identity::Models::Compartment::LIFECYCLE_STATE_ENUM.include?(opts[:lifecycle_state])
+        raise 'Invalid value for "lifecycle_state", must be one of the values in OCI::Identity::Models::Compartment::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = '/compartments/'
       operation_signing_strategy = :standard
 
@@ -3792,6 +4709,10 @@ module OCI
       query_params[:limit] = opts[:limit] if opts[:limit]
       query_params[:accessLevel] = opts[:access_level] if opts[:access_level]
       query_params[:compartmentIdInSubtree] = opts[:compartment_id_in_subtree] if !opts[:compartment_id_in_subtree].nil?
+      query_params[:name] = opts[:name] if opts[:name]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:lifecycleState] = opts[:lifecycle_state] if opts[:lifecycle_state]
 
       # Header Params
       header_params = {}
@@ -3836,8 +4757,9 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::Tag Tag}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_cost_tracking_tags.rb.html) to see an example of how to use list_cost_tracking_tags API.
     def list_cost_tracking_tags(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_cost_tracking_tags.' if logger
 
@@ -3894,6 +4816,7 @@ 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
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::CustomerSecretKeySummary CustomerSecretKeySummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_customer_secret_keys.rb.html) to see an example of how to use list_customer_secret_keys API.
     def list_customer_secret_keys(user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_customer_secret_keys.' if logger
 
@@ -3952,13 +4875,44 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    #    (default to 20)
+    # @option opts [String] :name A filter to only return resources that match the given name exactly.
+    #
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for NAME is ascending. The NAME
+    #   sort order is case sensitive.
+    #
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #
+    #   Allowed values are: TIMECREATED, NAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The NAME sort order
+    #   is case sensitive.
+    #
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::DynamicGroup DynamicGroup}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_dynamic_groups.rb.html) to see an example of how to use list_dynamic_groups API.
     def list_dynamic_groups(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_dynamic_groups.' if logger
 
       raise "Missing the required parameter 'compartment_id' when calling list_dynamic_groups." if compartment_id.nil?
 
+      if opts[:sort_by] && !%w[TIMECREATED NAME].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of TIMECREATED, NAME.'
+      end
+
+      if opts[:sort_order] && !%w[ASC DESC].include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:lifecycle_state] && !OCI::Identity::Models::DynamicGroup::LIFECYCLE_STATE_ENUM.include?(opts[:lifecycle_state])
+        raise 'Invalid value for "lifecycle_state", must be one of the values in OCI::Identity::Models::DynamicGroup::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = '/dynamicGroups/'
       operation_signing_strategy = :standard
 
@@ -3968,6 +4922,10 @@ module OCI
       query_params[:compartmentId] = compartment_id
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:name] = opts[:name] if opts[:name]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:lifecycleState] = opts[:lifecycle_state] if opts[:lifecycle_state]
 
       # Header Params
       header_params = {}
@@ -4014,6 +4972,7 @@ 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
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::FaultDomain FaultDomain}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_fault_domains.rb.html) to see an example of how to use list_fault_domains API.
     def list_fault_domains(compartment_id, availability_domain, opts = {})
       logger.debug 'Calling operation IdentityClient#list_fault_domains.' if logger
 
@@ -4074,13 +5033,44 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    #    (default to 20)
+    # @option opts [String] :name A filter to only return resources that match the given name exactly.
+    #
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for NAME is ascending. The NAME
+    #   sort order is case sensitive.
+    #
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #
+    #   Allowed values are: TIMECREATED, NAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The NAME sort order
+    #   is case sensitive.
+    #
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::Group Group}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_groups.rb.html) to see an example of how to use list_groups API.
     def list_groups(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_groups.' if logger
 
       raise "Missing the required parameter 'compartment_id' when calling list_groups." if compartment_id.nil?
 
+      if opts[:sort_by] && !%w[TIMECREATED NAME].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of TIMECREATED, NAME.'
+      end
+
+      if opts[:sort_order] && !%w[ASC DESC].include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:lifecycle_state] && !OCI::Identity::Models::Group::LIFECYCLE_STATE_ENUM.include?(opts[:lifecycle_state])
+        raise 'Invalid value for "lifecycle_state", must be one of the values in OCI::Identity::Models::Group::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = '/groups/'
       operation_signing_strategy = :standard
 
@@ -4090,6 +5080,10 @@ module OCI
       query_params[:compartmentId] = compartment_id
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:name] = opts[:name] if opts[:name]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:lifecycleState] = opts[:lifecycle_state] if opts[:lifecycle_state]
 
       # Header Params
       header_params = {}
@@ -4131,12 +5125,21 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    #    (default to 20)
+    # @option opts [String] :name A filter to only return resources that match the given name exactly.
+    #
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::IdentityProviderGroupSummary IdentityProviderGroupSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_identity_provider_groups.rb.html) to see an example of how to use list_identity_provider_groups API.
     def list_identity_provider_groups(identity_provider_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_identity_provider_groups.' if logger
 
       raise "Missing the required parameter 'identity_provider_id' when calling list_identity_provider_groups." if identity_provider_id.nil?
+
+      if opts[:lifecycle_state] && !OCI::Identity::Models::IdentityProvider::LIFECYCLE_STATE_ENUM.include?(opts[:lifecycle_state])
+        raise 'Invalid value for "lifecycle_state", must be one of the values in OCI::Identity::Models::IdentityProvider::LIFECYCLE_STATE_ENUM.'
+      end
       raise "Parameter value for 'identity_provider_id' must not be blank" if OCI::Internal::Util.blank_string?(identity_provider_id)
 
       path = '/identityProviders/{identityProviderId}/groups/'.sub('{identityProviderId}', identity_provider_id.to_s)
@@ -4147,6 +5150,8 @@ module OCI
       query_params = {}
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:name] = opts[:name] if opts[:name]
+      query_params[:lifecycleState] = opts[:lifecycle_state] if opts[:lifecycle_state]
 
       # Header Params
       header_params = {}
@@ -4195,8 +5200,27 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    #    (default to 20)
+    # @option opts [String] :name A filter to only return resources that match the given name exactly.
+    #
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for NAME is ascending. The NAME
+    #   sort order is case sensitive.
+    #
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #
+    #   Allowed values are: TIMECREATED, NAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The NAME sort order
+    #   is case sensitive.
+    #
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::IdentityProvider IdentityProvider}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_identity_providers.rb.html) to see an example of how to use list_identity_providers API.
     def list_identity_providers(protocol, compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_identity_providers.' if logger
 
@@ -4206,6 +5230,18 @@ module OCI
       end
       raise "Missing the required parameter 'compartment_id' when calling list_identity_providers." if compartment_id.nil?
 
+      if opts[:sort_by] && !%w[TIMECREATED NAME].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of TIMECREATED, NAME.'
+      end
+
+      if opts[:sort_order] && !%w[ASC DESC].include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:lifecycle_state] && !OCI::Identity::Models::IdentityProvider::LIFECYCLE_STATE_ENUM.include?(opts[:lifecycle_state])
+        raise 'Invalid value for "lifecycle_state", must be one of the values in OCI::Identity::Models::IdentityProvider::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = '/identityProviders/'
       operation_signing_strategy = :standard
 
@@ -4216,6 +5252,10 @@ module OCI
       query_params[:compartmentId] = compartment_id
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:name] = opts[:name] if opts[:name]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:lifecycleState] = opts[:lifecycle_state] if opts[:lifecycle_state]
 
       # Header Params
       header_params = {}
@@ -4258,8 +5298,9 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::IdpGroupMapping IdpGroupMapping}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_idp_group_mappings.rb.html) to see an example of how to use list_idp_group_mappings API.
     def list_idp_group_mappings(identity_provider_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_idp_group_mappings.' if logger
 
@@ -4284,7 +5325,187 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#list_idp_group_mappings') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#list_idp_group_mappings') 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::Identity::Models::IdpGroupMapping>'
+        )
+      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 MFA TOTP devices for the specified user. The returned object contains the device's OCID, but not
+    # the seed. The seed is returned only upon creation or when the IAM service regenerates the MFA seed for the device.
+    #
+    # @param [String] user_id The OCID of the user.
+    # @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] :page The value of the `opc-next-page` response header from the previous \"List\" call.
+    #
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    #    (default to 20)
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for NAME is ascending. The NAME
+    #   sort order is case sensitive.
+    #
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #
+    #   Allowed values are: TIMECREATED, NAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The NAME sort order
+    #   is case sensitive.
+    #
+    #   Allowed values are: ASC, DESC
+    # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::MfaTotpDeviceSummary MfaTotpDeviceSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_mfa_totp_devices.rb.html) to see an example of how to use list_mfa_totp_devices API.
+    def list_mfa_totp_devices(user_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#list_mfa_totp_devices.' if logger
+
+      raise "Missing the required parameter 'user_id' when calling list_mfa_totp_devices." if user_id.nil?
+
+      if opts[:sort_by] && !%w[TIMECREATED NAME].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of TIMECREATED, NAME.'
+      end
+
+      if opts[:sort_order] && !%w[ASC DESC].include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
+
+      path = '/users/{userId}/mfaTotpDevices'.sub('{userId}', user_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:page] = opts[:page] if opts[:page]
+      query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#list_mfa_totp_devices') 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::Identity::Models::MfaTotpDeviceSummary>'
+        )
+      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 network sources in your tenancy. You must specify your tenancy's OCID as the value for
+    # the compartment ID (remember that the tenancy is simply the root compartment).
+    # See [Where to Get the Tenancy's OCID and User's OCID](https://docs.cloud.oracle.com/Content/API/Concepts/apisigningkey.htm#five).
+    #
+    # @param [String] compartment_id The OCID of the compartment (remember that the tenancy is simply the root compartment).
+    #
+    # @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] :page The value of the `opc-next-page` response header from the previous \"List\" call.
+    #
+    # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    #    (default to 20)
+    # @option opts [String] :name A filter to only return resources that match the given name exactly.
+    #
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for NAME is ascending. The NAME
+    #   sort order is case sensitive.
+    #
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #
+    #   Allowed values are: TIMECREATED, NAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The NAME sort order
+    #   is case sensitive.
+    #
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
+    #
+    # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::NetworkSourcesSummary NetworkSourcesSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_network_sources.rb.html) to see an example of how to use list_network_sources API.
+    def list_network_sources(compartment_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#list_network_sources.' if logger
+
+      raise "Missing the required parameter 'compartment_id' when calling list_network_sources." if compartment_id.nil?
+
+      if opts[:sort_by] && !%w[TIMECREATED NAME].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of TIMECREATED, NAME.'
+      end
+
+      if opts[:sort_order] && !%w[ASC DESC].include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:lifecycle_state] && !OCI::Identity::Models::NetworkSources::LIFECYCLE_STATE_ENUM.include?(opts[:lifecycle_state])
+        raise 'Invalid value for "lifecycle_state", must be one of the values in OCI::Identity::Models::NetworkSources::LIFECYCLE_STATE_ENUM.'
+      end
+
+      path = '/networkSources'
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:compartmentId] = compartment_id
+      query_params[:page] = opts[:page] if opts[:page]
+      query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:name] = opts[:name] if opts[:name]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:lifecycleState] = opts[:lifecycle_state] if opts[:lifecycle_state]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#list_network_sources') do
         @api_client.call_api(
           :GET,
           path,
@@ -4293,7 +5514,7 @@ module OCI
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
           body: post_body,
-          return_type: 'Array<OCI::Identity::Models::IdpGroupMapping>'
+          return_type: 'Array<OCI::Identity::Models::NetworkSourcesSummary>'
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -4307,8 +5528,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Lists the MFA TOTP devices for the specified user. The returned object contains the device's OCID, but not
-    # the seed. The seed is returned only upon creation or when the IAM service regenerates the MFA seed for the device.
+    # List of Oauth tokens for the user
     #
     # @param [String] user_id The OCID of the user.
     # @param [Hash] opts the optional parameters
@@ -4317,37 +5537,22 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    #    (default to 20)
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
     #
-    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
-    #   TIMECREATED is descending. Default order for NAME is ascending. The NAME
-    #   sort order is case sensitive.
-    #
-    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
-    #   optionally filter by Availability Domain if the scope of the resource type is within a
-    #   single Availability Domain. If you call one of these \"List\" operations without specifying
-    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
-    #
-    #   Allowed values are: TIMECREATED, NAME
-    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The NAME sort order
-    #   is case sensitive.
-    #
-    #   Allowed values are: ASC, DESC
-    # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::MfaTotpDeviceSummary MfaTotpDeviceSummary}>
-    def list_mfa_totp_devices(user_id, opts = {})
-      logger.debug 'Calling operation IdentityClient#list_mfa_totp_devices.' if logger
-
-      raise "Missing the required parameter 'user_id' when calling list_mfa_totp_devices." if user_id.nil?
+    # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::OAuth2ClientCredentialSummary OAuth2ClientCredentialSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_o_auth_client_credentials.rb.html) to see an example of how to use list_o_auth_client_credentials API.
+    def list_o_auth_client_credentials(user_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#list_o_auth_client_credentials.' if logger
 
-      if opts[:sort_by] && !%w[TIMECREATED NAME].include?(opts[:sort_by])
-        raise 'Invalid value for "sort_by", must be one of TIMECREATED, NAME.'
-      end
+      raise "Missing the required parameter 'user_id' when calling list_o_auth_client_credentials." if user_id.nil?
 
-      if opts[:sort_order] && !%w[ASC DESC].include?(opts[:sort_order])
-        raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      if opts[:lifecycle_state] && !OCI::Identity::Models::OAuth2ClientCredentialSummary::LIFECYCLE_STATE_ENUM.include?(opts[:lifecycle_state])
+        raise 'Invalid value for "lifecycle_state", must be one of the values in OCI::Identity::Models::OAuth2ClientCredentialSummary::LIFECYCLE_STATE_ENUM.'
       end
       raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
 
-      path = '/users/{userId}/mfaTotpDevices'.sub('{userId}', user_id.to_s)
+      path = '/users/{userId}/oauth2ClientCredentials'.sub('{userId}', user_id.to_s)
       operation_signing_strategy = :standard
 
       # rubocop:disable Style/NegatedIf
@@ -4355,8 +5560,7 @@ module OCI
       query_params = {}
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:limit] = opts[:limit] if opts[:limit]
-      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
-      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:lifecycleState] = opts[:lifecycle_state] if opts[:lifecycle_state]
 
       # Header Params
       header_params = {}
@@ -4367,7 +5571,7 @@ module OCI
       post_body = nil
 
       # rubocop:disable Metrics/BlockLength
-      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#list_mfa_totp_devices') do
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#list_o_auth_client_credentials') do
         @api_client.call_api(
           :GET,
           path,
@@ -4376,7 +5580,7 @@ module OCI
           query_params: query_params,
           operation_signing_strategy: operation_signing_strategy,
           body: post_body,
-          return_type: 'Array<OCI::Identity::Models::MfaTotpDeviceSummary>'
+          return_type: 'Array<OCI::Identity::Models::OAuth2ClientCredentialSummary>'
         )
       end
       # rubocop:enable Metrics/BlockLength
@@ -4404,13 +5608,44 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
+    #    (default to 20)
+    # @option opts [String] :name A filter to only return resources that match the given name exactly.
+    #
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for NAME is ascending. The NAME
+    #   sort order is case sensitive.
+    #
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #
+    #   Allowed values are: TIMECREATED, NAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The NAME sort order
+    #   is case sensitive.
+    #
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::Policy Policy}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_policies.rb.html) to see an example of how to use list_policies API.
     def list_policies(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_policies.' if logger
 
       raise "Missing the required parameter 'compartment_id' when calling list_policies." if compartment_id.nil?
 
+      if opts[:sort_by] && !%w[TIMECREATED NAME].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of TIMECREATED, NAME.'
+      end
+
+      if opts[:sort_order] && !%w[ASC DESC].include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:lifecycle_state] && !OCI::Identity::Models::Policy::LIFECYCLE_STATE_ENUM.include?(opts[:lifecycle_state])
+        raise 'Invalid value for "lifecycle_state", must be one of the values in OCI::Identity::Models::Policy::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = '/policies/'
       operation_signing_strategy = :standard
 
@@ -4420,6 +5655,10 @@ module OCI
       query_params[:compartmentId] = compartment_id
       query_params[:page] = opts[:page] if opts[:page]
       query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:name] = opts[:name] if opts[:name]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:lifecycleState] = opts[:lifecycle_state] if opts[:lifecycle_state]
 
       # Header Params
       header_params = {}
@@ -4460,6 +5699,7 @@ 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
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::RegionSubscription RegionSubscription}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_region_subscriptions.rb.html) to see an example of how to use list_region_subscriptions API.
     def list_region_subscriptions(tenancy_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_region_subscriptions.' if logger
 
@@ -4512,6 +5752,7 @@ 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
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::Region Region}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_regions.rb.html) to see an example of how to use list_regions API.
     def list_regions(opts = {})
       logger.debug 'Calling operation IdentityClient#list_regions.' if logger
 
@@ -4565,6 +5806,7 @@ 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
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::SmtpCredentialSummary SmtpCredentialSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_smtp_credentials.rb.html) to see an example of how to use list_smtp_credentials API.
     def list_smtp_credentials(user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_smtp_credentials.' if logger
 
@@ -4622,6 +5864,7 @@ 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
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::SwiftPassword SwiftPassword}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_swift_passwords.rb.html) to see an example of how to use list_swift_passwords API.
     def list_swift_passwords(user_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_swift_passwords.' if logger
 
@@ -4676,7 +5919,7 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @option opts [String] :id A filter to only return resources that match the specified OCID exactly.
     #
     # @option opts [String] :compartment_id The OCID of the compartment (remember that the tenancy is simply the root compartment).
@@ -4686,6 +5929,7 @@ module OCI
     # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::TagDefaultSummary TagDefaultSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_tag_defaults.rb.html) to see an example of how to use list_tag_defaults API.
     def list_tag_defaults(opts = {})
       logger.debug 'Calling operation IdentityClient#list_tag_defaults.' if logger
 
@@ -4749,13 +5993,14 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @option opts [BOOLEAN] :include_subcompartments An optional boolean parameter indicating whether to retrieve all tag namespaces in subcompartments. If this
     #   parameter is not specified, only the tag namespaces defined in the specified compartment are retrieved.
     #
     # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::TagNamespaceSummary TagNamespaceSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_tag_namespaces.rb.html) to see an example of how to use list_tag_namespaces API.
     def list_tag_namespaces(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_tag_namespaces.' if logger
 
@@ -4818,8 +6063,9 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::TaggingWorkRequestErrorSummary TaggingWorkRequestErrorSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_tagging_work_request_errors.rb.html) to see an example of how to use list_tagging_work_request_errors API.
     def list_tagging_work_request_errors(work_request_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_tagging_work_request_errors.' if logger
 
@@ -4876,8 +6122,9 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::TaggingWorkRequestLogSummary TaggingWorkRequestLogSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_tagging_work_request_logs.rb.html) to see an example of how to use list_tagging_work_request_logs API.
     def list_tagging_work_request_logs(work_request_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_tagging_work_request_logs.' if logger
 
@@ -4935,9 +6182,10 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @option opts [String] :resource_identifier The identifier of the resource the work request affects.
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::TaggingWorkRequestSummary TaggingWorkRequestSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_tagging_work_requests.rb.html) to see an example of how to use list_tagging_work_requests API.
     def list_tagging_work_requests(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_tagging_work_requests.' if logger
 
@@ -4996,10 +6244,11 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::TagSummary TagSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_tags.rb.html) to see an example of how to use list_tags API.
     def list_tags(tag_namespace_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_tags.' if logger
 
@@ -5061,7 +6310,7 @@ module OCI
     # - Similarly, you can limit the results to just the memberships for a given group by specifying a `groupId`.
     # - You can set both the `userId` and `groupId` to determine if the specified user is in the specified group.
     # If the answer is no, the response is an empty list.
-    # - Although`userId` and `groupId` are not indvidually required, you must set one of them.
+    # - Although`userId` and `groupId` are not individually required, you must set one of them.
     #
     # @param [String] compartment_id The OCID of the compartment (remember that the tenancy is simply the root compartment).
     #
@@ -5073,8 +6322,9 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::UserGroupMembership UserGroupMembership}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_user_group_memberships.rb.html) to see an example of how to use list_user_group_memberships API.
     def list_user_group_memberships(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_user_group_memberships.' if logger
 
@@ -5136,17 +6386,48 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @option opts [String] :identity_provider_id The id of the identity provider.
     #
     # @option opts [String] :external_identifier The id of a user in the identity provider.
     #
+    # @option opts [String] :name A filter to only return resources that match the given name exactly.
+    #
+    # @option opts [String] :sort_by The field to sort by. You can provide one sort order (`sortOrder`). Default order for
+    #   TIMECREATED is descending. Default order for NAME is ascending. The NAME
+    #   sort order is case sensitive.
+    #
+    #   **Note:** In general, some \"List\" operations (for example, `ListInstances`) let you
+    #   optionally filter by Availability Domain if the scope of the resource type is within a
+    #   single Availability Domain. If you call one of these \"List\" operations without specifying
+    #   an Availability Domain, the resources are grouped by Availability Domain, then sorted.
+    #
+    #   Allowed values are: TIMECREATED, NAME
+    # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`). The NAME sort order
+    #   is case sensitive.
+    #
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :lifecycle_state A filter to only return resources that match the given lifecycle state.  The state value is case-insensitive.
+    #
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::User User}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/list_users.rb.html) to see an example of how to use list_users API.
     def list_users(compartment_id, opts = {})
       logger.debug 'Calling operation IdentityClient#list_users.' if logger
 
       raise "Missing the required parameter 'compartment_id' when calling list_users." if compartment_id.nil?
 
+      if opts[:sort_by] && !%w[TIMECREATED NAME].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of TIMECREATED, NAME.'
+      end
+
+      if opts[:sort_order] && !%w[ASC DESC].include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:lifecycle_state] && !OCI::Identity::Models::User::LIFECYCLE_STATE_ENUM.include?(opts[:lifecycle_state])
+        raise 'Invalid value for "lifecycle_state", must be one of the values in OCI::Identity::Models::User::LIFECYCLE_STATE_ENUM.'
+      end
+
       path = '/users/'
       operation_signing_strategy = :standard
 
@@ -5158,6 +6439,10 @@ module OCI
       query_params[:limit] = opts[:limit] if opts[:limit]
       query_params[:identityProviderId] = opts[:identity_provider_id] if opts[:identity_provider_id]
       query_params[:externalIdentifier] = opts[:external_identifier] if opts[:external_identifier]
+      query_params[:name] = opts[:name] if opts[:name]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:lifecycleState] = opts[:lifecycle_state] if opts[:lifecycle_state]
 
       # Header Params
       header_params = {}
@@ -5201,9 +6486,10 @@ module OCI
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
-    #
+    #    (default to 20)
     # @option opts [String] :resource_identifier The identifier of the resource the work request affects.
     # @return [Response] A Response object with data of type Array<{OCI::Identity::Models::WorkRequestSummary WorkRequestSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/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 IdentityClient#list_work_requests.' if logger
 
@@ -5280,6 +6566,7 @@ module OCI
     #   may be rejected).
     #
     # @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/identity/move_compartment.rb.html) to see an example of how to use move_compartment API.
     def move_compartment(compartment_id, move_compartment_details, opts = {})
       logger.debug 'Calling operation IdentityClient#move_compartment.' if logger
 
@@ -5329,6 +6616,68 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Recover the compartment from DELETED state to ACTIVE state.
+    #
+    # @param [String] compartment_id The OCID of the compartment.
+    # @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 For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #
+    # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about a
+    #   particular request, please provide the request ID.
+    #
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::Compartment Compartment}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/recover_compartment.rb.html) to see an example of how to use recover_compartment API.
+    def recover_compartment(compartment_id, opts = {})
+      logger.debug 'Calling operation IdentityClient#recover_compartment.' if logger
+
+      raise "Missing the required parameter 'compartment_id' when calling recover_compartment." if compartment_id.nil?
+      raise "Parameter value for 'compartment_id' must not be blank" if OCI::Internal::Util.blank_string?(compartment_id)
+
+      path = '/compartments/{compartmentId}/actions/recoverCompartment'.sub('{compartmentId}', compartment_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-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#recover_compartment') 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::Identity::Models::Compartment'
+        )
+      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
+
+
     # Removes a user from a group by deleting the corresponding `UserGroupMembership`.
     # @param [String] user_group_membership_id The OCID of the userGroupMembership.
     # @param [Hash] opts the optional parameters
@@ -5339,6 +6688,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @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/identity/remove_user_from_group.rb.html) to see an example of how to use remove_user_from_group API.
     def remove_user_from_group(user_group_membership_id, opts = {})
       logger.debug 'Calling operation IdentityClient#remove_user_from_group.' if logger
 
@@ -5392,6 +6742,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::ScimClientCredentials ScimClientCredentials}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/reset_idp_scim_client.rb.html) to see an example of how to use reset_idp_scim_client API.
     def reset_idp_scim_client(identity_provider_id, opts = {})
       logger.debug 'Calling operation IdentityClient#reset_idp_scim_client.' if logger
 
@@ -5451,6 +6802,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::AuthToken AuthToken}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_auth_token.rb.html) to see an example of how to use update_auth_token API.
     def update_auth_token(user_id, auth_token_id, update_auth_token_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_auth_token.' if logger
 
@@ -5512,6 +6864,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::AuthenticationPolicy AuthenticationPolicy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_authentication_policy.rb.html) to see an example of how to use update_authentication_policy API.
     def update_authentication_policy(compartment_id, update_authentication_policy_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_authentication_policy.' if logger
 
@@ -5570,6 +6923,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Compartment Compartment}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_compartment.rb.html) to see an example of how to use update_compartment API.
     def update_compartment(compartment_id, update_compartment_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_compartment.' if logger
 
@@ -5630,6 +6984,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::CustomerSecretKeySummary CustomerSecretKeySummary}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_customer_secret_key.rb.html) to see an example of how to use update_customer_secret_key API.
     def update_customer_secret_key(user_id, customer_secret_key_id, update_customer_secret_key_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_customer_secret_key.' if logger
 
@@ -5690,6 +7045,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::DynamicGroup DynamicGroup}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_dynamic_group.rb.html) to see an example of how to use update_dynamic_group API.
     def update_dynamic_group(dynamic_group_id, update_dynamic_group_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_dynamic_group.' if logger
 
@@ -5748,6 +7104,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Group Group}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_group.rb.html) to see an example of how to use update_group API.
     def update_group(group_id, update_group_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_group.' if logger
 
@@ -5806,6 +7163,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::IdentityProvider IdentityProvider}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_identity_provider.rb.html) to see an example of how to use update_identity_provider API.
     def update_identity_provider(identity_provider_id, update_identity_provider_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_identity_provider.' if logger
 
@@ -5865,6 +7223,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::IdpGroupMapping IdpGroupMapping}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_idp_group_mapping.rb.html) to see an example of how to use update_idp_group_mapping API.
     def update_idp_group_mapping(identity_provider_id, mapping_id, update_idp_group_mapping_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_idp_group_mapping.' if logger
 
@@ -5914,6 +7273,128 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Updates the specified network source.
+    # @param [String] network_source_id The OCID of the network source.
+    # @param [OCI::Identity::Models::UpdateNetworkSourceDetails] update_network_source_details Request object for updating a network source.
+    # @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 For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::NetworkSources NetworkSources}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_network_source.rb.html) to see an example of how to use update_network_source API.
+    def update_network_source(network_source_id, update_network_source_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#update_network_source.' if logger
+
+      raise "Missing the required parameter 'network_source_id' when calling update_network_source." if network_source_id.nil?
+      raise "Missing the required parameter 'update_network_source_details' when calling update_network_source." if update_network_source_details.nil?
+      raise "Parameter value for 'network_source_id' must not be blank" if OCI::Internal::Util.blank_string?(network_source_id)
+
+      path = '/networkSources/{networkSourceId}'.sub('{networkSourceId}', network_source_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]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = @api_client.object_to_http_body(update_network_source_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#update_network_source') 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::Identity::Models::NetworkSources'
+        )
+      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
+
+
+    # Updates Oauth token for the user
+    #
+    # @param [String] user_id The OCID of the user.
+    # @param [String] oauth2_client_credential_id The ID of the Oauth credential.
+    # @param [OCI::Identity::Models::UpdateOAuth2ClientCredentialDetails] update_o_auth2_client_credential_details Request object containing the information required to generate an Oauth token.
+    # @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 For optimistic concurrency control. In the PUT or DELETE call for a resource, set the `if-match`
+    #   parameter to the value of the etag from a previous GET or POST response for that resource.  The resource
+    #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
+    #
+    # @return [Response] A Response object with data of type {OCI::Identity::Models::OAuth2ClientCredential OAuth2ClientCredential}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_o_auth_client_credential.rb.html) to see an example of how to use update_o_auth_client_credential API.
+    def update_o_auth_client_credential(user_id, oauth2_client_credential_id, update_o_auth2_client_credential_details, opts = {})
+      logger.debug 'Calling operation IdentityClient#update_o_auth_client_credential.' if logger
+
+      raise "Missing the required parameter 'user_id' when calling update_o_auth_client_credential." if user_id.nil?
+      raise "Missing the required parameter 'oauth2_client_credential_id' when calling update_o_auth_client_credential." if oauth2_client_credential_id.nil?
+      raise "Missing the required parameter 'update_o_auth2_client_credential_details' when calling update_o_auth_client_credential." if update_o_auth2_client_credential_details.nil?
+      raise "Parameter value for 'user_id' must not be blank" if OCI::Internal::Util.blank_string?(user_id)
+      raise "Parameter value for 'oauth2_client_credential_id' must not be blank" if OCI::Internal::Util.blank_string?(oauth2_client_credential_id)
+
+      path = '/users/{userId}/oauth2ClientCredentials/{oauth2ClientCredentialId}'.sub('{userId}', user_id.to_s).sub('{oauth2ClientCredentialId}', oauth2_client_credential_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]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = @api_client.object_to_http_body(update_o_auth2_client_credential_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'IdentityClient#update_o_auth_client_credential') 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::Identity::Models::OAuth2ClientCredential'
+        )
+      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
+
+
     # Updates the specified policy. You can update the description or the policy statements themselves.
     #
     # Policy changes take effect typically within 10 seconds.
@@ -5928,6 +7409,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Policy Policy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_policy.rb.html) to see an example of how to use update_policy API.
     def update_policy(policy_id, update_policy_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_policy.' if logger
 
@@ -5988,6 +7470,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::SmtpCredentialSummary SmtpCredentialSummary}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_smtp_credential.rb.html) to see an example of how to use update_smtp_credential API.
     def update_smtp_credential(user_id, smtp_credential_id, update_smtp_credential_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_smtp_credential.' if logger
 
@@ -6052,6 +7535,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::SwiftPassword SwiftPassword}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_swift_password.rb.html) to see an example of how to use update_swift_password API.
     def update_swift_password(user_id, swift_password_id, update_swift_password_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_swift_password.' if logger
 
@@ -6103,9 +7587,14 @@ module OCI
 
     # Updates the specified tag definition.
     #
-    # Setting a 'validator' will enable enforcement of additional validation on values contained in the specified for
-    # this definedTag. Any values that were previously set will not be changed, but any new value set for the
-    # definedTag must pass validation.
+    # Setting `validator` determines the value type. Tags can use either a static value or a
+    # list of possible values. Static values are entered by a user applying the tag to a resource.
+    # Lists are created by you and the user must apply a value from the list. On update, any values
+    # in a list that were previously set do not change, but new values must pass validation. Values
+    # already applied to a resource do not change.
+    #
+    # You cannot remove list values that appear in a TagDefault. To remove a list value that
+    # appears in a TagDefault, first update the TagDefault to use a different value.
     #
     # @param [String] tag_namespace_id The OCID of the tag namespace.
     #
@@ -6120,6 +7609,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::Tag Tag}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_tag.rb.html) to see an example of how to use update_tag API.
     def update_tag(tag_namespace_id, tag_name, update_tag_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_tag.' if logger
 
@@ -6189,6 +7679,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::TagDefault TagDefault}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_tag_default.rb.html) to see an example of how to use update_tag_default API.
     def update_tag_default(tag_default_id, update_tag_default_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_tag_default.' if logger
 
@@ -6242,7 +7733,7 @@ module OCI
     #
     # Updating `isRetired` to 'true' retires the namespace and all the tag definitions in the namespace. Reactivating a
     # namespace (changing `isRetired` from 'true' to 'false') does not reactivate tag definitions.
-    # To reactivate the tag definitions, you must reactivate each one indvidually *after* you reactivate the namespace,
+    # To reactivate the tag definitions, you must reactivate each one individually *after* you reactivate the namespace,
     # using {#update_tag update_tag}. For more information about retiring tag namespaces, see
     # [Retiring Key Definitions and Namespace Definitions](https://docs.cloud.oracle.com/Content/Identity/Concepts/taggingoverview.htm#Retiring).
     #
@@ -6255,6 +7746,7 @@ 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
     # @return [Response] A Response object with data of type {OCI::Identity::Models::TagNamespace TagNamespace}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_tag_namespace.rb.html) to see an example of how to use update_tag_namespace API.
     def update_tag_namespace(tag_namespace_id, update_tag_namespace_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_tag_namespace.' if logger
 
@@ -6313,6 +7805,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::User User}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_user.rb.html) to see an example of how to use update_user API.
     def update_user(user_id, update_user_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_user.' if logger
 
@@ -6372,6 +7865,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::User User}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_user_capabilities.rb.html) to see an example of how to use update_user_capabilities API.
     def update_user_capabilities(user_id, update_user_capabilities_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_user_capabilities.' if logger
 
@@ -6431,6 +7925,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::User User}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/update_user_state.rb.html) to see an example of how to use update_user_state API.
     def update_user_state(user_id, update_state_details, opts = {})
       logger.debug 'Calling operation IdentityClient#update_user_state.' if logger
 
@@ -6506,6 +8001,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Identity::Models::ApiKey ApiKey}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/identity/upload_api_key.rb.html) to see an example of how to use upload_api_key API.
     def upload_api_key(user_id, create_api_key_details, opts = {})
       logger.debug 'Calling operation IdentityClient#upload_api_key.' if logger