oci 2.11.0 → 2.12.0

data/lib/oci/audit/audit_client.rb

@@ -87,7 +87,7 @@ module OCI
 
       raise 'A region must be specified.' unless @region
 
-      @endpoint = OCI::Regions.get_service_endpoint_for_template(@region, 'https://audit.{region}.oraclecloud.com') + '/20190901'
+      @endpoint = OCI::Regions.get_service_endpoint_for_template(@region, 'https://audit.{region}.{secondLevelDomain}') + '/20190901'
       logger.info "AuditClient endpoint set to '#{@endpoint} from region #{@region}'." if logger
     end
 
@@ -108,6 +108,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::Audit::Models::Configuration Configuration}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/audit/get_configuration.rb.html) to see an example of how to use get_configuration API.
     def get_configuration(compartment_id, opts = {})
       logger.debug 'Calling operation AuditClient#get_configuration.' if logger
 
@@ -185,6 +186,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Audit::Models::AuditEvent AuditEvent}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/audit/list_events.rb.html) to see an example of how to use list_events API.
     def list_events(compartment_id, start_time, end_time, opts = {})
       logger.debug 'Calling operation AuditClient#list_events.' if logger
 
@@ -244,6 +246,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 nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/audit/update_configuration.rb.html) to see an example of how to use update_configuration API.
     def update_configuration(compartment_id, update_configuration_details, opts = {})
       logger.debug 'Calling operation AuditClient#update_configuration.' if logger
 

data/lib/oci/audit/models/audit_event.rb

@@ -8,7 +8,7 @@ module OCI
   # All the attributes of an audit event. For more information, see [Viewing Audit Log Events](https://docs.cloud.oracle.com/iaas/Content/Audit/Tasks/viewinglogevents.htm).
   #
   class Audit::Models::AuditEvent
-    # The type of event that happened.
+    # **[Required]** The type of event that happened.
     #
     # The service that produces the event can also add, remove, or change the meaning of a field.
     # A service implementing these type changes would publish a new version of an `eventType` and
@@ -19,7 +19,7 @@ module OCI
     # @return [String]
     attr_accessor :event_type
 
-    # The version of the CloudEvents specification. The structure of the envelope follows the
+    # **[Required]** The version of the CloudEvents specification. The structure of the envelope follows the
     # [CloudEvents](https://github.com/cloudevents/spec) industry standard format hosted by the
     # [Cloud Native Computing Foundation ( CNCF)](https://www.cncf.io/).
     #
@@ -30,7 +30,7 @@ module OCI
     # @return [String]
     attr_accessor :cloud_events_version
 
-    # The version of the event type. This version applies to the payload of the event, not the envelope.
+    # **[Required]** The version of the event type. This version applies to the payload of the event, not the envelope.
     # Use `cloudEventsVersion` to determine the version of the envelope.
     #
     # Example: `2.0`
@@ -38,32 +38,33 @@ module OCI
     # @return [String]
     attr_accessor :event_type_version
 
-    # The source of the event.
+    # **[Required]** The source of the event.
     #
     # Example: `ComputeApi`
     #
     # @return [String]
     attr_accessor :source
 
-    # The GUID of the event.
+    # **[Required]** The GUID of the event.
     #
     # @return [String]
     attr_accessor :event_id
 
-    # The time the event occurred, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format.
+    # **[Required]** The time the event occurred, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format.
     #
     # Example: `2019-09-18T00:10:59.252Z`
     #
     # @return [DateTime]
     attr_accessor :event_time
 
-    # The content type of the data contained in `data`.
+    # **[Required]** The content type of the data contained in `data`.
     #
     # Example: `application/json`
     #
     # @return [String]
     attr_accessor :content_type
 
+    # This attribute is required.
     # @return [OCI::Audit::Models::Data]
     attr_accessor :data
 

data/lib/oci/audit/models/data.rb

@@ -7,113 +7,6 @@ require 'date'
 module OCI
   # The payload of the event. Information within `data` comes from the resource emitting the event.
   #
-  # Example:
-  #
-  #   -----
-  #     {
-  #       \"eventGroupingId\": null,
-  #       \"eventName\": \"GetInstance\",
-  #       \"compartmentId\": \"ocid1.tenancy.oc1..<unique_ID>\",
-  #       \"compartmentName\": \"compartmentA\",
-  #       \"resourceName\": \"my_instance\",
-  #       \"resourceId\": \"ocid1.instance.oc1.phx.<unique_ID>\",
-  #       \"availabilityDomain\": \"<availability_domain>\",
-  #       \"freeformTags\": null,
-  #       \"definedTags\": null,
-  #       \"identity\": {
-  #         \"principalName\": \"ExampleName\",
-  #         \"principalId\": \"ocid1.user.oc1..<unique_ID>\",
-  #         \"authType\": \"natv\",
-  #         \"callerName\": null,
-  #         \"callerId\": null,
-  #         \"tenantId\": \"ocid1.tenancy.oc1..<unique_ID>\",
-  #         \"ipAddress\": \"172.24.80.88\",
-  #         \"credentials\": null,
-  #         \"userAgent\": \"Jersey/2.23 (HttpUrlConnection 1.8.0_212)\",
-  #         \"consoleSessionId\": null
-  #       },
-  #       \"request\": {
-  #         \"id\": \"<unique_ID>\",
-  #         \"path\": \"/20160918/instances/ocid1.instance.oc1.phx.<unique_ID>\",
-  #         \"action\": \"GET\",
-  #         \"parameters\": {},
-  #         \"headers\": {
-  #           \"opc-principal\": [
-  #             \"{\\\"tenantId\\\":\\\"ocid1.tenancy.oc1..<unique_ID>\\\",\\\"subjectId\\\":\\\"ocid1.user.oc1..<unique_ID>\\\",\\\"claims\\\":[{\\\"key\\\":\\\"pstype\\\",\\\"value\\\":\\\"natv\\\",\\\"issuer\\\":\\\"authService.oracle.com\\\"},{\\\"key\\\":\\\"h_host\\\",\\\"value\\\":\\\"iaas.r2.oracleiaas.com\\\",\\\"issuer\\\":\\\"h\\\"},{\\\"key\\\":\\\"h_opc-request-id\\\",\\\"value\\\":\\\"<unique_ID>\\\",\\\"issuer\\\":\\\"h\\\"},{\\\"key\\\":\\\"ptype\\\",\\\"value\\\":\\\"user\\\",\\\"issuer\\\":\\\"authService.oracle.com\\\"},{\\\"key\\\":\\\"h_date\\\",\\\"value\\\":\\\"Wed, 18 Sep 2019 00:10:58 UTC\\\",\\\"issuer\\\":\\\"h\\\"},{\\\"key\\\":\\\"h_accept\\\",\\\"value\\\":\\\"application/json\\\",\\\"issuer\\\":\\\"h\\\"},{\\\"key\\\":\\\"authorization\\\",\\\"value\\\":\\\"Signature headers=\\\\\\\"date (request-target) host accept opc-request-id\\\\\\\",keyId=\\\\\\\"ocid1.tenancy.oc1..<unique_ID>/ocid1.user.oc1..<unique_ID>/8c:b4:5f:18:e7:ec:db:08:b8:fa:d2:2a:7d:11:76:ac\\\\\\\",algorithm=\\\\\\\"rsa-pss-sha256\\\\\\\",signature=\\\\\\\"<unique_ID>\\\\\\\",version=\\\\\\\"1\\\\\\\"\\\",\\\"issuer\\\":\\\"h\\\"},{\\\"key\\\":\\\"h_(request-target)\\\",\\\"value\\\":\\\"get /20160918/instances/ocid1.instance.oc1.phx.<unique_ID>\\\",\\\"issuer\\\":\\\"h\\\"}]}\"
-  #           ],
-  #           \"Accept\": [
-  #             \"application/json\"
-  #           ],
-  #           \"X-Oracle-Auth-Client-CN\": [
-  #             \"splat-proxy-se-02302.node.ad2.r2\"
-  #           ],
-  #           \"X-Forwarded-Host\": [
-  #             \"compute-api.svc.ad1.r2\"
-  #           ],
-  #           \"Connection\": [
-  #             \"close\"
-  #           ],
-  #           \"User-Agent\": [
-  #             \"Jersey/2.23 (HttpUrlConnection 1.8.0_212)\"
-  #           ],
-  #           \"X-Forwarded-For\": [
-  #             \"172.24.80.88\"
-  #           ],
-  #           \"X-Real-IP\": [
-  #             \"172.24.80.88\"
-  #           ],
-  #           \"oci-original-url\": [
-  #             \"https://iaas.r2.oracleiaas.com/20160918/instances/ocid1.instance.oc1.phx.<unique_ID>\"
-  #           ],
-  #           \"opc-request-id\": [
-  #             \"<unique_ID>\"
-  #           ],
-  #           \"Date\": [
-  #             \"Wed, 18 Sep 2019 00:10:58 UTC\"
-  #           ]
-  #         }
-  #       },
-  #       \"response\": {
-  #         \"status\": \"200\",
-  #         \"responseTime\": \"2019-09-18T00:10:59.278Z\",
-  #         \"headers\": {
-  #           \"ETag\": [
-  #             \"<unique_ID>\"
-  #           ],
-  #           \"Connection\": [
-  #             \"close\"
-  #           ],
-  #           \"Content-Length\": [
-  #             \"1828\"
-  #           ],
-  #           \"opc-request-id\": [
-  #             \"<unique_ID>\"
-  #           ],
-  #           \"Date\": [
-  #             \"Wed, 18 Sep 2019 00:10:59 GMT\"
-  #           ],
-  #           \"Content-Type\": [
-  #             \"application/json\"
-  #           ]
-  #         },
-  #         \"payload\": {
-  #           \"resourceName\": \"my_instance\",
-  #           \"id\": \"ocid1.instance.oc1.phx.<unique_ID>\"
-  #         },
-  #         \"message\": null
-  #       },
-  #       \"stateChange\": {
-  #         \"previous\": null,
-  #         \"current\": null
-  #       },
-  #       \"additionalDetails\": {
-  #         \"imageId\": \"ocid1.image.oc1.phx.<unique_ID>\",
-  #         \"shape\": \"VM.Standard1.1\",
-  #         \"type\": \"CustomerVmi\"
-  #       }
-  #     }
-  #   -----
-  #
   class Audit::Models::Data
     # This value links multiple audit events that are part of the same API operation. For example,
     # a long running API operations that emit an event at the start and the end of an operation

data/lib/oci/audit/models/identity.rb

@@ -7,23 +7,6 @@ require 'date'
 module OCI
   # A container object for identity attributes.
   #
-  # Example:
-  #
-  #   -----
-  #     {
-  #       \"principalName\": \"ExampleName\",
-  #       \"principalId\": \"ocid1.user.oc1..<unique_ID>\",
-  #       \"authType\": \"natv\",
-  #       \"callerName\": null,
-  #       \"callerId\": null,
-  #       \"tenantId\": \"ocid1.tenancy.oc1..<unique_ID>\",
-  #       \"ipAddress\": \"172.24.80.88\",
-  #       \"credentials\": null,
-  #       \"userAgent\": \"Jersey/2.23 (HttpUrlConnection 1.8.0_212)\",
-  #       \"consoleSessionId\": null
-  #     }
-  #   -----
-  #
   class Audit::Models::Identity
     # The name of the user or service. This value is the friendly name associated with `principalId`.
     #

data/lib/oci/audit/models/request.rb

@@ -7,52 +7,6 @@ require 'date'
 module OCI
   # A container object for request attributes.
   #
-  # Example:
-  #
-  #   -----
-  #     {
-  #       \"id\": \"<unique_ID>\",
-  #       \"path\": \"/20160918/instances/ocid1.instance.oc1.phx.<unique_ID>\",
-  #       \"action\": \"GET\",
-  #       \"parameters\": {},
-  #       \"headers\": {
-  #         \"opc-principal\": [
-  #           \"{\\\"tenantId\\\":\\\"ocid1.tenancy.oc1..<unique_ID>\\\",\\\"subjectId\\\":\\\"ocid1.user.oc1..<unique_ID>\\\",\\\"claims\\\":[{\\\"key\\\":\\\"pstype\\\",\\\"value\\\":\\\"natv\\\",\\\"issuer\\\":\\\"authService.oracle.com\\\"},{\\\"key\\\":\\\"h_host\\\",\\\"value\\\":\\\"iaas.r2.oracleiaas.com\\\",\\\"issuer\\\":\\\"h\\\"},{\\\"key\\\":\\\"h_opc-request-id\\\",\\\"value\\\":\\\"<unique_ID>\\\",\\\"issuer\\\":\\\"h\\\"},{\\\"key\\\":\\\"ptype\\\",\\\"value\\\":\\\"user\\\",\\\"issuer\\\":\\\"authService.oracle.com\\\"},{\\\"key\\\":\\\"h_date\\\",\\\"value\\\":\\\"Wed, 18 Sep 2019 00:10:58 UTC\\\",\\\"issuer\\\":\\\"h\\\"},{\\\"key\\\":\\\"h_accept\\\",\\\"value\\\":\\\"application/json\\\",\\\"issuer\\\":\\\"h\\\"},{\\\"key\\\":\\\"authorization\\\",\\\"value\\\":\\\"Signature headers=\\\\\\\"date (request-target) host accept opc-request-id\\\\\\\",keyId=\\\\\\\"ocid1.tenancy.oc1..<unique_ID>/ocid1.user.oc1..<unique_ID>/8c:b4:5f:18:e7:ec:db:08:b8:fa:d2:2a:7d:11:76:ac\\\\\\\",algorithm=\\\\\\\"rsa-pss-sha256\\\\\\\",signature=\\\\\\\"<unique_ID>\\\\\\\",version=\\\\\\\"1\\\\\\\"\\\",\\\"issuer\\\":\\\"h\\\"},{\\\"key\\\":\\\"h_(request-target)\\\",\\\"value\\\":\\\"get /20160918/instances/ocid1.instance.oc1.phx.<unique_ID>\\\",\\\"issuer\\\":\\\"h\\\"}]}\"
-  #         ],
-  #         \"Accept\": [
-  #           \"application/json\"
-  #         ],
-  #         \"X-Oracle-Auth-Client-CN\": [
-  #           \"splat-proxy-se-02302.node.ad2.r2\"
-  #         ],
-  #         \"X-Forwarded-Host\": [
-  #           \"compute-api.svc.ad1.r2\"
-  #         ],
-  #         \"Connection\": [
-  #           \"close\"
-  #         ],
-  #         \"User-Agent\": [
-  #           \"Jersey/2.23 (HttpUrlConnection 1.8.0_212)\"
-  #         ],
-  #         \"X-Forwarded-For\": [
-  #           \"172.24.80.88\"
-  #         ],
-  #         \"X-Real-IP\": [
-  #           \"172.24.80.88\"
-  #         ],
-  #         \"oci-original-url\": [
-  #           \"https://iaas.r2.oracleiaas.com/20160918/instances/ocid1.instance.oc1.phx.<unique_ID>\"
-  #         ],
-  #         \"opc-request-id\": [
-  #           \"<unique_ID>\"
-  #         ],
-  #         \"Date\": [
-  #           \"Wed, 18 Sep 2019 00:10:58 UTC\"
-  #         ]
-  #       }
-  #     }
-  #   -----
-  #
   class Audit::Models::Request
     # The opc-request-id of the request.
     #

data/lib/oci/audit/models/response.rb

@@ -7,40 +7,6 @@ require 'date'
 module OCI
   # A container object for response attributes.
   #
-  # Example:
-  #
-  #   -----
-  #     {
-  #       \"status\": \"200\",
-  #       \"responseTime\": \"2019-09-18T00:10:59.278Z\",
-  #       \"headers\": {
-  #         \"ETag\": [
-  #           \"<unique_ID>\"
-  #         ],
-  #         \"Connection\": [
-  #           \"close\"
-  #         ],
-  #         \"Content-Length\": [
-  #           \"1828\"
-  #         ],
-  #         \"opc-request-id\": [
-  #           \"<unique_ID>\"
-  #         ],
-  #         \"Date\": [
-  #           \"Wed, 18 Sep 2019 00:10:59 GMT\"
-  #         ],
-  #         \"Content-Type\": [
-  #           \"application/json\"
-  #         ]
-  #       },
-  #       \"payload\": {
-  #         \"resourceName\": \"my_instance\",
-  #         \"id\": \"ocid1.instance.oc1.phx.<unique_ID>\"
-  #       },
-  #       \"message\": null
-  #     }
-  #   -----
-  #
   class Audit::Models::Response
     # The status code of the response.
     #

data/lib/oci/audit/models/state_change.rb

@@ -7,15 +7,6 @@ require 'date'
 module OCI
   # A container object for state change attributes.
   #
-  # Example:
-  #
-  #   -----
-  #     {
-  #       \"previous\": null,
-  #       \"current\": null
-  #     }
-  #   -----
-  #
   class Audit::Models::StateChange
     # Provides the previous state of fields that may have changed during an operation. To determine
     # how the current operation changed a resource, compare the information in this attribute to

data/lib/oci/auth/signers/ephemeral_resource_principals_signer.rb

@@ -81,7 +81,6 @@ module OCI
 
         def refresh_security_token
           @refresh_lock.lock
-          @session_key_supplier.refresh
           @security_token = OCI::Auth::SecurityTokenContainer.new(resource_principal_session_token, key_pair: @session_key_supplier)
 
           # Resources may be moved between compartments. Update any coordinates on refresh.

data/lib/oci/auth/signers/resource_principals_signer.rb

@@ -11,7 +11,7 @@ module OCI
       OCI_RESOURCE_PRINCIPAL_VERSION = 'OCI_RESOURCE_PRINCIPAL_VERSION'.freeze
       OCI_RESOURCE_PRINCIPAL_RPT_ENDPOINT = 'OCI_RESOURCE_PRINCIPAL_RPT_ENDPOINT'.freeze
       OCI_RESOURCE_PRINCIPAL_RPST_ENDPOINT = 'OCI_RESOURCE_PRINCIPAL_RPST_ENDPOINT'.freeze
-      OCI_RESOURCE_PRINCIPAL_RPST = 'OCI_RESOUCE_RPINCIPAL_RPST'.freeze
+      OCI_RESOURCE_PRINCIPAL_RPST = 'OCI_RESOURCE_PRINCIPAL_RPST'.freeze
       OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM = 'OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM'.freeze
       OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM_PASSPHRASE = 'OCI_RESOURCE_PRINCIPAL_PRIVATE_PEM_PASSPHRASE'.freeze
       OCI_RESOURCE_PRINCIPAL_REGION = 'OCI_RESOURCE_PRINCIPAL_REGION'.freeze

data/lib/oci/autoscaling/auto_scaling_client.rb

@@ -127,6 +127,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/autoscaling/change_auto_scaling_configuration_compartment.rb.html) to see an example of how to use change_auto_scaling_configuration_compartment API.
     def change_auto_scaling_configuration_compartment(auto_scaling_configuration_id, change_compartment_details, opts = {})
       logger.debug 'Calling operation AutoScalingClient#change_auto_scaling_configuration_compartment.' if logger
 
@@ -189,6 +190,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Autoscaling::Models::AutoScalingConfiguration AutoScalingConfiguration}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/autoscaling/create_auto_scaling_configuration.rb.html) to see an example of how to use create_auto_scaling_configuration API.
     def create_auto_scaling_configuration(create_auto_scaling_configuration_details, opts = {})
       logger.debug 'Calling operation AutoScalingClient#create_auto_scaling_configuration.' if logger
 
@@ -251,6 +253,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Autoscaling::Models::AutoScalingPolicy AutoScalingPolicy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/autoscaling/create_auto_scaling_policy.rb.html) to see an example of how to use create_auto_scaling_policy API.
     def create_auto_scaling_policy(auto_scaling_configuration_id, create_auto_scaling_policy_details, opts = {})
       logger.debug 'Calling operation AutoScalingClient#create_auto_scaling_policy.' if logger
 
@@ -311,6 +314,7 @@ module OCI
     #
     # @option opts [String] :opc_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/autoscaling/delete_auto_scaling_configuration.rb.html) to see an example of how to use delete_auto_scaling_configuration API.
     def delete_auto_scaling_configuration(auto_scaling_configuration_id, opts = {})
       logger.debug 'Calling operation AutoScalingClient#delete_auto_scaling_configuration.' if logger
 
@@ -369,6 +373,7 @@ module OCI
     #
     # @option opts [String] :opc_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/autoscaling/delete_auto_scaling_policy.rb.html) to see an example of how to use delete_auto_scaling_policy API.
     def delete_auto_scaling_policy(auto_scaling_configuration_id, auto_scaling_policy_id, opts = {})
       logger.debug 'Calling operation AutoScalingClient#delete_auto_scaling_policy.' if logger
 
@@ -424,6 +429,7 @@ module OCI
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
     # @option opts [String] :opc_request_id
     # @return [Response] A Response object with data of type {OCI::Autoscaling::Models::AutoScalingConfiguration AutoScalingConfiguration}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/autoscaling/get_auto_scaling_configuration.rb.html) to see an example of how to use get_auto_scaling_configuration API.
     def get_auto_scaling_configuration(auto_scaling_configuration_id, opts = {})
       logger.debug 'Calling operation AutoScalingClient#get_auto_scaling_configuration.' if logger
 
@@ -478,6 +484,7 @@ module OCI
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
     # @option opts [String] :opc_request_id
     # @return [Response] A Response object with data of type {OCI::Autoscaling::Models::AutoScalingPolicy AutoScalingPolicy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/autoscaling/get_auto_scaling_policy.rb.html) to see an example of how to use get_auto_scaling_policy API.
     def get_auto_scaling_policy(auto_scaling_configuration_id, auto_scaling_policy_id, opts = {})
       logger.debug 'Calling operation AutoScalingClient#get_auto_scaling_policy.' if logger
 
@@ -554,6 +561,7 @@ module OCI
     #    (default to [ASC])
     #   Allowed values are: ASC, DESC
     # @return [Response] A Response object with data of type Array<{OCI::Autoscaling::Models::AutoScalingConfigurationSummary AutoScalingConfigurationSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/autoscaling/list_auto_scaling_configurations.rb.html) to see an example of how to use list_auto_scaling_configurations API.
     def list_auto_scaling_configurations(compartment_id, opts = {})
       logger.debug 'Calling operation AutoScalingClient#list_auto_scaling_configurations.' if logger
 
@@ -638,6 +646,7 @@ module OCI
     #    (default to [ASC])
     #   Allowed values are: ASC, DESC
     # @return [Response] A Response object with data of type Array<{OCI::Autoscaling::Models::AutoScalingPolicySummary AutoScalingPolicySummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/autoscaling/list_auto_scaling_policies.rb.html) to see an example of how to use list_auto_scaling_policies API.
     def list_auto_scaling_policies(auto_scaling_configuration_id, opts = {})
       logger.debug 'Calling operation AutoScalingClient#list_auto_scaling_policies.' if logger
 
@@ -717,6 +726,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Autoscaling::Models::AutoScalingConfiguration AutoScalingConfiguration}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/autoscaling/update_auto_scaling_configuration.rb.html) to see an example of how to use update_auto_scaling_configuration API.
     def update_auto_scaling_configuration(auto_scaling_configuration_id, update_auto_scaling_configuration_details, opts = {})
       logger.debug 'Calling operation AutoScalingClient#update_auto_scaling_configuration.' if logger
 
@@ -786,6 +796,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Autoscaling::Models::AutoScalingPolicy AutoScalingPolicy}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/autoscaling/update_auto_scaling_policy.rb.html) to see an example of how to use update_auto_scaling_policy API.
     def update_auto_scaling_policy(auto_scaling_configuration_id, auto_scaling_policy_id, update_auto_scaling_policy_details, opts = {})
       logger.debug 'Calling operation AutoScalingClient#update_auto_scaling_policy.' if logger