oci 2.7.0 → 2.12.0

data/lib/oci/events/models/action_details.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 

data/lib/oci/events/models/action_details_list.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 

data/lib/oci/events/models/action_list.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 

data/lib/oci/events/models/change_rule_compartment_details.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 

data/lib/oci/events/models/create_faa_s_action_details.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 require_relative 'action_details'

data/lib/oci/events/models/create_notification_service_action_details.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 require_relative 'action_details'

data/lib/oci/events/models/create_rule_details.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 
@@ -33,7 +34,7 @@ module OCI
     #
     #   For more examples, see
     # [Matching Events with Filters](https://docs.cloud.oracle.com/iaas/Content/Events/Concepts/filterevents.htm).
-    # * For a condition with fileds to match an event, the event must contain all the field names
+    # * For a condition with fields to match an event, the event must contain all the field names
     # listed in the condition. Field names must appear in the condition with the same nesting
     # structure used in the event.
     #
@@ -42,11 +43,6 @@ module OCI
     # * Rules apply to events in the compartment in which you create them and any child compartments.
     # This means that a condition specified by a rule only matches events emitted from resources in
     # the compartment or any of its child compartments.
-    # * The condition is a string value in a JSON object, but numbers in conditions are converted
-    # from strings to numbers before they are evaluated for matches. This means that 100, 100.0 or
-    # 1.0e2 are all considered equal.
-    # * Boolean values are converted to numbers and then evaluated. This means true and True are
-    # considered equal, as are False and false.
     # * Wildcard matching is supported with the asterisk (*) character.
     #
     #   For examples of wildcard matching, see

data/lib/oci/events/models/create_streaming_service_action_details.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 require_relative 'action_details'

data/lib/oci/events/models/faa_s_action.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 require_relative 'action'
@@ -20,6 +21,7 @@ module OCI
         'id': :'id',
         'lifecycle_message': :'lifecycleMessage',
         'lifecycle_state': :'lifecycleState',
+        'is_enabled': :'isEnabled',
         'description': :'description',
         'function_id': :'functionId'
         # rubocop:enable Style/SymbolLiteral
@@ -34,6 +36,7 @@ module OCI
         'id': :'String',
         'lifecycle_message': :'String',
         'lifecycle_state': :'String',
+        'is_enabled': :'BOOLEAN',
         'description': :'String',
         'function_id': :'String'
         # rubocop:enable Style/SymbolLiteral
@@ -49,6 +52,7 @@ module OCI
     # @option attributes [String] :id The value to assign to the {OCI::Events::Models::Action#id #id} proprety
     # @option attributes [String] :lifecycle_message The value to assign to the {OCI::Events::Models::Action#lifecycle_message #lifecycle_message} proprety
     # @option attributes [String] :lifecycle_state The value to assign to the {OCI::Events::Models::Action#lifecycle_state #lifecycle_state} proprety
+    # @option attributes [BOOLEAN] :is_enabled The value to assign to the {OCI::Events::Models::Action#is_enabled #is_enabled} proprety
     # @option attributes [String] :description The value to assign to the {OCI::Events::Models::Action#description #description} proprety
     # @option attributes [String] :function_id The value to assign to the {#function_id} property
     def initialize(attributes = {})
@@ -83,6 +87,7 @@ module OCI
         id == other.id &&
         lifecycle_message == other.lifecycle_message &&
         lifecycle_state == other.lifecycle_state &&
+        is_enabled == other.is_enabled &&
         description == other.description &&
         function_id == other.function_id
     end
@@ -100,7 +105,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [action_type, id, lifecycle_message, lifecycle_state, description, function_id].hash
+      [action_type, id, lifecycle_message, lifecycle_state, is_enabled, description, function_id].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/events/models/notification_service_action.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 require_relative 'action'
@@ -21,6 +22,7 @@ module OCI
         'id': :'id',
         'lifecycle_message': :'lifecycleMessage',
         'lifecycle_state': :'lifecycleState',
+        'is_enabled': :'isEnabled',
         'description': :'description',
         'topic_id': :'topicId'
         # rubocop:enable Style/SymbolLiteral
@@ -35,6 +37,7 @@ module OCI
         'id': :'String',
         'lifecycle_message': :'String',
         'lifecycle_state': :'String',
+        'is_enabled': :'BOOLEAN',
         'description': :'String',
         'topic_id': :'String'
         # rubocop:enable Style/SymbolLiteral
@@ -50,6 +53,7 @@ module OCI
     # @option attributes [String] :id The value to assign to the {OCI::Events::Models::Action#id #id} proprety
     # @option attributes [String] :lifecycle_message The value to assign to the {OCI::Events::Models::Action#lifecycle_message #lifecycle_message} proprety
     # @option attributes [String] :lifecycle_state The value to assign to the {OCI::Events::Models::Action#lifecycle_state #lifecycle_state} proprety
+    # @option attributes [BOOLEAN] :is_enabled The value to assign to the {OCI::Events::Models::Action#is_enabled #is_enabled} proprety
     # @option attributes [String] :description The value to assign to the {OCI::Events::Models::Action#description #description} proprety
     # @option attributes [String] :topic_id The value to assign to the {#topic_id} property
     def initialize(attributes = {})
@@ -84,6 +88,7 @@ module OCI
         id == other.id &&
         lifecycle_message == other.lifecycle_message &&
         lifecycle_state == other.lifecycle_state &&
+        is_enabled == other.is_enabled &&
         description == other.description &&
         topic_id == other.topic_id
     end
@@ -101,7 +106,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [action_type, id, lifecycle_message, lifecycle_state, description, topic_id].hash
+      [action_type, id, lifecycle_message, lifecycle_state, is_enabled, description, topic_id].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/events/models/rule.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 require 'logger'
@@ -6,7 +7,7 @@ require 'logger'
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
   # The configuration details of an Events rule. For more information, see
-  # [Managing Rules for Events](https://docs.cloud.oracle.com/iaas/Content/Events/Task/managingrulesactions.htm)
+  # [Managing Rules for Events](https://docs.cloud.oracle.com/iaas/Content/Events/Task/managingrules.htm).
   #
   class Events::Models::Rule
     LIFECYCLE_STATE_ENUM = [
@@ -47,7 +48,7 @@ module OCI
     #
     #   For more examples, see
     # [Matching Events with Filters](https://docs.cloud.oracle.com/iaas/Content/Events/Concepts/filterevents.htm).
-    # * For a condition with fileds to match an event, the event must contain all the field names
+    # * For a condition with fields to match an event, the event must contain all the field names
     # listed in the condition. Field names must appear in the condition with the same nesting
     # structure used in the event.
     #
@@ -56,11 +57,6 @@ module OCI
     # * Rules apply to events in the compartment in which you create them and any child compartments.
     # This means that a condition specified by a rule only matches events emitted from resources in
     # the compartment or any of its child compartments.
-    # * The condition is a string value in a JSON object, but numbers in conditions are converted
-    # from strings to numbers before they are evaluated for matches. This means that 100, 100.0 or
-    # 1.0e2 are all considered equal.
-    # * Boolean values are converted to numbers and then evaluated. This means true and True are
-    # considered equal, as are False and false.
     # * Wildcard matching is supported with the asterisk (*) character.
     #
     #   For examples of wildcard matching, see

data/lib/oci/events/models/rule_summary.rb

@@ -1,11 +1,12 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
   # The summary details of rules for Events. For more information, see
-  # [Managing Rules for Events](https://docs.cloud.oracle.com/iaas/Content/Events/Task/managingrulesactions.htm)
+  # [Managing Rules for Events](https://docs.cloud.oracle.com/iaas/Content/Events/Task/managingrules.htm).
   #
   class Events::Models::RuleSummary
     # **[Required]** The [OCID](https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) of this rule.
@@ -39,7 +40,7 @@ module OCI
     #
     #   For more examples, see
     # [Matching Events with Filters](https://docs.cloud.oracle.com/iaas/Content/Events/Concepts/filterevents.htm).
-    # * For a condition with fileds to match an event, the event must contain all the field names
+    # * For a condition with fields to match an event, the event must contain all the field names
     # listed in the condition. Field names must appear in the condition with the same nesting
     # structure used in the event.
     #
@@ -48,11 +49,6 @@ module OCI
     # * Rules apply to events in the compartment in which you create them and any child compartments.
     # This means that a condition specified by a rule only matches events emitted from resources in
     # the compartment or any of its child compartments.
-    # * The condition is a string value in a JSON object, but numbers in conditions are converted
-    # from strings to numbers before they are evaluated for matches. This means that 100, 100.0 or
-    # 1.0e2 are all considered equal.
-    # * Boolean values are converted to numbers and then evaluated. This means true and True are
-    # considered equal, as are False and false.
     # * Wildcard matching is supported with the asterisk (*) character.
     #
     #   For examples of wildcard matching, see

data/lib/oci/events/models/streaming_service_action.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 require_relative 'action'
@@ -20,6 +21,7 @@ module OCI
         'id': :'id',
         'lifecycle_message': :'lifecycleMessage',
         'lifecycle_state': :'lifecycleState',
+        'is_enabled': :'isEnabled',
         'description': :'description',
         'stream_id': :'streamId'
         # rubocop:enable Style/SymbolLiteral
@@ -34,6 +36,7 @@ module OCI
         'id': :'String',
         'lifecycle_message': :'String',
         'lifecycle_state': :'String',
+        'is_enabled': :'BOOLEAN',
         'description': :'String',
         'stream_id': :'String'
         # rubocop:enable Style/SymbolLiteral
@@ -49,6 +52,7 @@ module OCI
     # @option attributes [String] :id The value to assign to the {OCI::Events::Models::Action#id #id} proprety
     # @option attributes [String] :lifecycle_message The value to assign to the {OCI::Events::Models::Action#lifecycle_message #lifecycle_message} proprety
     # @option attributes [String] :lifecycle_state The value to assign to the {OCI::Events::Models::Action#lifecycle_state #lifecycle_state} proprety
+    # @option attributes [BOOLEAN] :is_enabled The value to assign to the {OCI::Events::Models::Action#is_enabled #is_enabled} proprety
     # @option attributes [String] :description The value to assign to the {OCI::Events::Models::Action#description #description} proprety
     # @option attributes [String] :stream_id The value to assign to the {#stream_id} property
     def initialize(attributes = {})
@@ -83,6 +87,7 @@ module OCI
         id == other.id &&
         lifecycle_message == other.lifecycle_message &&
         lifecycle_state == other.lifecycle_state &&
+        is_enabled == other.is_enabled &&
         description == other.description &&
         stream_id == other.stream_id
     end
@@ -100,7 +105,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [action_type, id, lifecycle_message, lifecycle_state, description, stream_id].hash
+      [action_type, id, lifecycle_message, lifecycle_state, is_enabled, description, stream_id].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/events/models/update_rule_details.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 require 'date'
 
@@ -33,7 +34,7 @@ module OCI
     #
     #   For more examples, see
     # [Matching Events with Filters](https://docs.cloud.oracle.com/iaas/Content/Events/Concepts/filterevents.htm).
-    # * For a condition with fileds to match an event, the event must contain all the field names
+    # * For a condition with fields to match an event, the event must contain all the field names
     # listed in the condition. Field names must appear in the condition with the same nesting
     # structure used in the event.
     #
@@ -42,11 +43,6 @@ module OCI
     # * Rules apply to events in the compartment in which you create them and any child compartments.
     # This means that a condition specified by a rule only matches events emitted from resources in
     # the compartment or any of its child compartments.
-    # * The condition is a string value in a JSON object, but numbers in conditions are converted
-    # from strings to numbers before they are evaluated for matches. This means that 100, 100.0 or
-    # 1.0e2 are all considered equal.
-    # * Boolean values are converted to numbers and then evaluated. This means true and True are
-    # considered equal, as are False and false.
     # * Wildcard matching is supported with the asterisk (*) character.
     #
     #   For examples of wildcard matching, see

data/lib/oci/events/util.rb

@@ -1,2 +1,3 @@
-# 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.
 

data/lib/oci/file_storage/file_storage.rb

@@ -1,4 +1,5 @@
-# Copyright (c) 2016, 2019, Oracle and/or its affiliates. All rights reserved.
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
 
 module OCI
   module FileStorage

data/lib/oci/file_storage/file_storage_client.rb

@@ -1,11 +1,12 @@
-# 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'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # The API for the File Storage Service.
+  # API for the File Storage service. Use this API to manage file systems, mount targets, and snapshots. For more information, see [Overview of File Storage](/iaas/Content/File/Concepts/filestorageoverview.htm).
   class FileStorage::FileStorageClient
     # Client used to make HTTP requests.
     # @return [OCI::ApiClient]
@@ -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
@@ -120,11 +110,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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 nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/change_file_system_compartment.rb.html) to see an example of how to use change_file_system_compartment API.
     def change_file_system_compartment(file_system_id, change_file_system_compartment_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#change_file_system_compartment.' if logger
 
@@ -184,11 +175,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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 nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/change_mount_target_compartment.rb.html) to see an example of how to use change_mount_target_compartment API.
     def change_mount_target_compartment(mount_target_id, change_mount_target_compartment_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#change_mount_target_compartment.' if logger
 
@@ -248,11 +240,12 @@ module OCI
     #   hours, but can be invalidated before then due to conflicting operations. For example, if a resource
     #   has been deleted and purged from the system, then a retry of the original creation request
     #   might be rejected.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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::FileStorage::Models::Export Export}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/create_export.rb.html) to see an example of how to use create_export API.
     def create_export(create_export_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#create_export.' if logger
 
@@ -314,6 +307,9 @@ module OCI
     # For information about access control and compartments, see
     # [Overview of the IAM Service](https://docs.cloud.oracle.com/Content/Identity/Concepts/overview.htm).
     #
+    # For information about Network Security Groups access control, see
+    # [Network Security Groups](https://docs.cloud.oracle.com/Content/Network/Concepts/networksecuritygroups.htm).
+    #
     # For information about availability domains, see [Regions and
     # Availability Domains](https://docs.cloud.oracle.com/Content/General/Concepts/regions.htm).
     # To get a list of availability domains, use the
@@ -336,11 +332,12 @@ module OCI
     #   hours, but can be invalidated before then due to conflicting operations. For example, if a resource
     #   has been deleted and purged from the system, then a retry of the original creation request
     #   might be rejected.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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::FileStorage::Models::FileSystem FileSystem}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/create_file_system.rb.html) to see an example of how to use create_file_system API.
     def create_file_system(create_file_system_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#create_file_system.' if logger
 
@@ -430,11 +427,12 @@ module OCI
     #   hours, but can be invalidated before then due to conflicting operations. For example, if a resource
     #   has been deleted and purged from the system, then a retry of the original creation request
     #   might be rejected.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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::FileStorage::Models::MountTarget MountTarget}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/create_mount_target.rb.html) to see an example of how to use create_mount_target API.
     def create_mount_target(create_mount_target_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#create_mount_target.' if logger
 
@@ -494,11 +492,12 @@ module OCI
     #   hours, but can be invalidated before then due to conflicting operations. For example, if a resource
     #   has been deleted and purged from the system, then a retry of the original creation request
     #   might be rejected.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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::FileStorage::Models::Snapshot Snapshot}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/create_snapshot.rb.html) to see an example of how to use create_snapshot API.
     def create_snapshot(create_snapshot_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#create_snapshot.' if logger
 
@@ -557,11 +556,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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 nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/delete_export.rb.html) to see an example of how to use delete_export API.
     def delete_export(export_id, opts = {})
       logger.debug 'Calling operation FileStorageClient#delete_export.' if logger
 
@@ -621,11 +621,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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 nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/delete_file_system.rb.html) to see an example of how to use delete_file_system API.
     def delete_file_system(file_system_id, opts = {})
       logger.debug 'Calling operation FileStorageClient#delete_file_system.' if logger
 
@@ -684,11 +685,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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 nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/delete_mount_target.rb.html) to see an example of how to use delete_mount_target API.
     def delete_mount_target(mount_target_id, opts = {})
       logger.debug 'Calling operation FileStorageClient#delete_mount_target.' if logger
 
@@ -746,11 +748,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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 nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/delete_snapshot.rb.html) to see an example of how to use delete_snapshot API.
     def delete_snapshot(snapshot_id, opts = {})
       logger.debug 'Calling operation FileStorageClient#delete_snapshot.' if logger
 
@@ -806,6 +809,7 @@ module OCI
     #   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::FileStorage::Models::Export Export}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/get_export.rb.html) to see an example of how to use get_export API.
     def get_export(export_id, opts = {})
       logger.debug 'Calling operation FileStorageClient#get_export.' if logger
 
@@ -861,6 +865,7 @@ module OCI
     #   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::FileStorage::Models::ExportSet ExportSet}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/get_export_set.rb.html) to see an example of how to use get_export_set API.
     def get_export_set(export_set_id, opts = {})
       logger.debug 'Calling operation FileStorageClient#get_export_set.' if logger
 
@@ -916,6 +921,7 @@ module OCI
     #   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::FileStorage::Models::FileSystem FileSystem}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/get_file_system.rb.html) to see an example of how to use get_file_system API.
     def get_file_system(file_system_id, opts = {})
       logger.debug 'Calling operation FileStorageClient#get_file_system.' if logger
 
@@ -971,6 +977,7 @@ module OCI
     #   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::FileStorage::Models::MountTarget MountTarget}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/get_mount_target.rb.html) to see an example of how to use get_mount_target API.
     def get_mount_target(mount_target_id, opts = {})
       logger.debug 'Calling operation FileStorageClient#get_mount_target.' if logger
 
@@ -1026,6 +1033,7 @@ module OCI
     #   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::FileStorage::Models::Snapshot Snapshot}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/get_snapshot.rb.html) to see an example of how to use get_snapshot API.
     def get_snapshot(snapshot_id, opts = {})
       logger.debug 'Calling operation FileStorageClient#get_snapshot.' if logger
 
@@ -1090,38 +1098,40 @@ module OCI
     #   see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     #   Example: `500`
-    #
+    #    (default to 1000)
     # @option opts [String] :page For list pagination. The value of the `opc-next-page` response
     #   header from the previous \"List\" call.
     #
     #   For important details about how pagination works,
     #   see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
-    #
+    #    (default to none)
     # @option opts [String] :display_name A user-friendly name. It does not have to be unique, and it is changeable.
     #
     #   Example: `My resource`
-    #
+    #    (default to none)
     # @option opts [String] :lifecycle_state Filter results by the specified lifecycle state. Must be a valid
     #   state for the resource type.
-    #
+    #    (default to none)
     #   Allowed values are: CREATING, ACTIVE, DELETING, DELETED, FAILED
     # @option opts [String] :id Filter results by OCID. Must be an OCID of the correct type for
     #   the resouce type.
-    #
+    #    (default to none)
     # @option opts [String] :sort_by The field to sort by. You can provide either value, but not both.
     #   By default, when you sort by time created, results are shown
     #   in descending order. When you sort by display name, results are
     #   shown in ascending order.
-    #
+    #    (default to TIMECREATED)
     #   Allowed values are: TIMECREATED, DISPLAYNAME
     # @option opts [String] :sort_order The sort order to use, either 'asc' or 'desc', where 'asc' is
-    #   ascending and 'desc' is descending.
-    #
+    #   ascending and 'desc' is descending. The default order is 'desc'
+    #   except for numeric values.
+    #    (default to DESC)
     #   Allowed values are: ASC, DESC
     # @option opts [String] :opc_request_id Unique 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 Array<{OCI::FileStorage::Models::ExportSetSummary ExportSetSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/list_export_sets.rb.html) to see an example of how to use list_export_sets API.
     def list_export_sets(compartment_id, availability_domain, opts = {})
       logger.debug 'Calling operation FileStorageClient#list_export_sets.' if logger
 
@@ -1196,7 +1206,7 @@ module OCI
     # @param [Hash] opts the optional parameters
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
-    # @option opts [String] :compartment_id The OCID of the compartment.
+    # @option opts [String] :compartment_id The OCID of the compartment. (default to none)
     # @option opts [Integer] :limit For list pagination. The maximum number of results per page,
     #   or items to return in a paginated \"List\" call.
     #   1 is the minimum, 1000 is the maximum.
@@ -1205,36 +1215,38 @@ module OCI
     #   see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     #   Example: `500`
-    #
+    #    (default to 1000)
     # @option opts [String] :page For list pagination. The value of the `opc-next-page` response
     #   header from the previous \"List\" call.
     #
     #   For important details about how pagination works,
     #   see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
-    #
-    # @option opts [String] :export_set_id The OCID of the export set.
-    # @option opts [String] :file_system_id The OCID of the file system.
+    #    (default to none)
+    # @option opts [String] :export_set_id The OCID of the export set. (default to none)
+    # @option opts [String] :file_system_id The OCID of the file system. (default to none)
     # @option opts [String] :lifecycle_state Filter results by the specified lifecycle state. Must be a valid
     #   state for the resource type.
-    #
+    #    (default to none)
     #   Allowed values are: CREATING, ACTIVE, DELETING, DELETED, FAILED
     # @option opts [String] :id Filter results by OCID. Must be an OCID of the correct type for
     #   the resouce type.
-    #
+    #    (default to none)
     # @option opts [String] :sort_by The field to sort by. You can provide either value, but not both.
     #   By default, when you sort by time created, results are shown
     #   in descending order. When you sort by path, results are
     #   shown in ascending alphanumeric order.
-    #
+    #    (default to TIMECREATED)
     #   Allowed values are: TIMECREATED, PATH
     # @option opts [String] :sort_order The sort order to use, either 'asc' or 'desc', where 'asc' is
-    #   ascending and 'desc' is descending.
-    #
+    #   ascending and 'desc' is descending. The default order is 'desc'
+    #   except for numeric values.
+    #    (default to DESC)
     #   Allowed values are: ASC, DESC
     # @option opts [String] :opc_request_id Unique 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 Array<{OCI::FileStorage::Models::ExportSummary ExportSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/list_exports.rb.html) to see an example of how to use list_exports API.
     def list_exports(opts = {})
       logger.debug 'Calling operation FileStorageClient#list_exports.' if logger
 
@@ -1318,38 +1330,40 @@ module OCI
     #   see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     #   Example: `500`
-    #
+    #    (default to 1000)
     # @option opts [String] :page For list pagination. The value of the `opc-next-page` response
     #   header from the previous \"List\" call.
     #
     #   For important details about how pagination works,
     #   see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
-    #
+    #    (default to none)
     # @option opts [String] :display_name A user-friendly name. It does not have to be unique, and it is changeable.
     #
     #   Example: `My resource`
-    #
+    #    (default to none)
     # @option opts [String] :lifecycle_state Filter results by the specified lifecycle state. Must be a valid
     #   state for the resource type.
-    #
+    #    (default to none)
     #   Allowed values are: CREATING, ACTIVE, DELETING, DELETED, FAILED
     # @option opts [String] :id Filter results by OCID. Must be an OCID of the correct type for
     #   the resouce type.
-    #
+    #    (default to none)
     # @option opts [String] :sort_by The field to sort by. You can provide either value, but not both.
     #   By default, when you sort by time created, results are shown
     #   in descending order. When you sort by display name, results are
     #   shown in ascending order.
-    #
+    #    (default to TIMECREATED)
     #   Allowed values are: TIMECREATED, DISPLAYNAME
     # @option opts [String] :sort_order The sort order to use, either 'asc' or 'desc', where 'asc' is
-    #   ascending and 'desc' is descending.
-    #
+    #   ascending and 'desc' is descending. The default order is 'desc'
+    #   except for numeric values.
+    #    (default to DESC)
     #   Allowed values are: ASC, DESC
     # @option opts [String] :opc_request_id Unique 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 Array<{OCI::FileStorage::Models::FileSystemSummary FileSystemSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/list_file_systems.rb.html) to see an example of how to use list_file_systems API.
     def list_file_systems(compartment_id, availability_domain, opts = {})
       logger.debug 'Calling operation FileStorageClient#list_file_systems.' if logger
 
@@ -1435,39 +1449,41 @@ module OCI
     #   see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     #   Example: `500`
-    #
+    #    (default to 1000)
     # @option opts [String] :page For list pagination. The value of the `opc-next-page` response
     #   header from the previous \"List\" call.
     #
     #   For important details about how pagination works,
     #   see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
-    #
+    #    (default to none)
     # @option opts [String] :display_name A user-friendly name. It does not have to be unique, and it is changeable.
     #
     #   Example: `My resource`
-    #
-    # @option opts [String] :export_set_id The OCID of the export set.
+    #    (default to none)
+    # @option opts [String] :export_set_id The OCID of the export set. (default to none)
     # @option opts [String] :lifecycle_state Filter results by the specified lifecycle state. Must be a valid
     #   state for the resource type.
-    #
+    #    (default to none)
     #   Allowed values are: CREATING, ACTIVE, DELETING, DELETED, FAILED
     # @option opts [String] :id Filter results by OCID. Must be an OCID of the correct type for
     #   the resouce type.
-    #
+    #    (default to none)
     # @option opts [String] :sort_by The field to sort by. You can choose either value, but not both.
     #   By default, when you sort by time created, results are shown
     #   in descending order. When you sort by display name, results are
     #   shown in ascending order.
-    #
+    #    (default to TIMECREATED)
     #   Allowed values are: TIMECREATED, DISPLAYNAME
     # @option opts [String] :sort_order The sort order to use, either 'asc' or 'desc', where 'asc' is
-    #   ascending and 'desc' is descending.
-    #
+    #   ascending and 'desc' is descending. The default order is 'desc'
+    #   except for numeric values.
+    #    (default to DESC)
     #   Allowed values are: ASC, DESC
     # @option opts [String] :opc_request_id Unique 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 Array<{OCI::FileStorage::Models::MountTargetSummary MountTargetSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/list_mount_targets.rb.html) to see an example of how to use list_mount_targets API.
     def list_mount_targets(compartment_id, availability_domain, opts = {})
       logger.debug 'Calling operation FileStorageClient#list_mount_targets.' if logger
 
@@ -1544,34 +1560,36 @@ module OCI
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
     # @option opts [Integer] :limit For list pagination. The maximum number of results per page,
     #   or items to return in a paginated \"List\" call.
-    #   1 is the minimum, 1000 is the maximum.
+    #   1 is the minimum, 100 is the maximum.
     #
     #   For important details about how pagination works,
     #   see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
-    #   Example: `500`
-    #
+    #   Example: `100`
+    #    (default to 100)
     # @option opts [String] :page For list pagination. The value of the `opc-next-page` response
     #   header from the previous \"List\" call.
     #
     #   For important details about how pagination works,
     #   see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
-    #
+    #    (default to none)
     # @option opts [String] :lifecycle_state Filter results by the specified lifecycle state. Must be a valid
     #   state for the resource type.
-    #
+    #    (default to none)
     #   Allowed values are: CREATING, ACTIVE, DELETING, DELETED, FAILED
     # @option opts [String] :id Filter results by OCID. Must be an OCID of the correct type for
     #   the resouce type.
-    #
+    #    (default to none)
     # @option opts [String] :sort_order The sort order to use, either 'asc' or 'desc', where 'asc' is
-    #   ascending and 'desc' is descending.
-    #
+    #   ascending and 'desc' is descending. The default order is 'desc'
+    #   except for numeric values.
+    #    (default to DESC)
     #   Allowed values are: ASC, DESC
     # @option opts [String] :opc_request_id Unique 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 Array<{OCI::FileStorage::Models::SnapshotSummary SnapshotSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/list_snapshots.rb.html) to see an example of how to use list_snapshots API.
     def list_snapshots(file_system_id, opts = {})
       logger.debug 'Calling operation FileStorageClient#list_snapshots.' if logger
 
@@ -1642,11 +1660,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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::FileStorage::Models::Export Export}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/update_export.rb.html) to see an example of how to use update_export API.
     def update_export(export_id, update_export_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#update_export.' if logger
 
@@ -1706,11 +1725,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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::FileStorage::Models::ExportSet ExportSet}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/update_export_set.rb.html) to see an example of how to use update_export_set API.
     def update_export_set(export_set_id, update_export_set_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#update_export_set.' if logger
 
@@ -1772,11 +1792,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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::FileStorage::Models::FileSystem FileSystem}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/update_file_system.rb.html) to see an example of how to use update_file_system API.
     def update_file_system(file_system_id, update_file_system_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#update_file_system.' if logger
 
@@ -1836,11 +1857,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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::FileStorage::Models::MountTarget MountTarget}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/update_mount_target.rb.html) to see an example of how to use update_mount_target API.
     def update_mount_target(mount_target_id, update_mount_target_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#update_mount_target.' if logger
 
@@ -1900,11 +1922,12 @@ module OCI
     #   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.
-    #
+    #    (default to none)
     # @option opts [String] :opc_request_id Unique 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::FileStorage::Models::Snapshot Snapshot}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/filestorage/update_snapshot.rb.html) to see an example of how to use update_snapshot API.
     def update_snapshot(snapshot_id, update_snapshot_details, opts = {})
       logger.debug 'Calling operation FileStorageClient#update_snapshot.' if logger