oci 2.7.0 → 2.12.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: 66717b5bc86a778e9e9401b76a23d3fa4663dc4114f7e8e971ef110378e8b344
-  data.tar.gz: b5c5cf170c071abb2109e992f014c9538085e19d0dc29b85d0b9ffa350afdf72
+  metadata.gz: 5ab1d48e7c22017e79da87b54b5babb79d67be150fc84fcf6a93e263c7a307a7
+  data.tar.gz: 7bb498e3032b1e20df8a164027b68e88c86e037d4a7d213631d7a87188bdce97
 SHA512:
-  metadata.gz: 678eed1c97323bb632c54501586bfc746ad8e5e0f7b15ab5cf28cf1e62f16e2b3e1c8a7bc1127d59afc0a76b5742115d01386a0384a76abb1b662dcf7fcee75b
-  data.tar.gz: c0962730bcd97cf5de2b272b7fe404b53271ab941ff6b1ebb847a8390683a56406c3279668a5f3942271ad2f926a28896570453c674316faa8e088bd1d1973ea
+  metadata.gz: 46ea9785a238430c95f5b7b2c04fd54a22ffd56cc8f481b9d90a50217c283e2462ffc93a91947673c91ff85252da78bb68abfa955cae0a8d2ea7a2595346e5f8
+  data.tar.gz: 4aa2ff45dcb6793afe2c20cb22a364633cb576e1d61e299d32c729b98026ddbd6d02103a190f01792232a647c2ee4d2a03b43b5fb56f97ef64d9c500c0b4178a

data/README.md

@@ -1,5 +1,8 @@
 # Oracle Cloud Infrastructure Ruby SDK
-**Version 2.7.0**
+
+This is Oracle Cloud Infrastructure SDK for Ruby. This project is open source, in active development and maintained by Oracle Corp. The home page for the project is <a href="https://docs.cloud.oracle.com/en-us/iaas/Content/API/SDKDocs/rubysdk.htm">here</a>.
+
+**Version 2.10.0**
 
 This topic describes how to install, configure, and use the Oracle Cloud Infrastructure Ruby SDK.
 
@@ -9,12 +12,24 @@ The Ruby SDK supports the following services:
 
 * Analytics Cloud 
 * Announcements
+* API Gateway
+* Application Migration
 * Audit
+* Autoscaling (Compute)
+* Big Data
+* Blockchain Platform
 * Budgets
+* Cloud Guard
+* Compute Instance Agent
 * Compute Autoscaling
 * Container Engine
 * Content and Experience
 * Core Services (which includes Networking, Compute, and Block Volume)
+* Data Catalog
+* Data Flow
+* Data Integration
+* Data Science
+* Data Safe
 * Data Transfer 
 * Database
 * Digital Assistant
@@ -25,18 +40,35 @@ The Ruby SDK supports the following services:
 * Functions
 * Health Checks
 * Identity and Access Management
+* Incident Management
 * Integration Cloud
 * Key Management
 * Limits
 * Load Balancing
+* Logging
+* Logging Analytics
+* Logging Search
+* Logging Ingestion
+* Management Agent Cloud
+* Management Dashboard
+* Marketplace
 * Monitoring
+* MySQL Database service
 * Notification
 * Oracle Content and Experience
+* Oracle Roving Edge Infrastructure
 * Object Storage
+* Oracle NoSQL Database Cloud
+* OS Management
 * Quotas
 * Resource Manager
 * Search
+* Secret Management (for the Vault service)
+* Service Connector Hub
 * Streaming
+* Support Management
+* Usage
+* VMWare Solution
 * Web Application Acceleration and Security
 * Work Requests
 
@@ -107,7 +139,7 @@ The following table provides details about some of the attributes of the SDK.
     <tr>
 		<td>Instance Principals Authentication</td>
 		<td>
-            The Ruby SDK supports <a href="https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Tasks/callingservicesfrominstances.htm">Instance Principals</a> authentication via the use of the {OCI::Auth::Signers::InstancePrincipalsSecurityTokenSigner} class. An example of using Instance Principals authentication: <a href="https://github.com/oracle/oci-ruby-sdk/blob/master/examples-oci/instance_principals_example.rb">instance_principals_example.rb</a>
+            The Ruby SDK supports <a href="https://docs.cloud.oracle.com/Content/Identity/Tasks/callingservicesfrominstances.htm">Instance Principals</a> authentication via the use of the {OCI::Auth::Signers::InstancePrincipalsSecurityTokenSigner} class. An example of using Instance Principals authentication: <a href="https://github.com/oracle/oci-ruby-sdk/blob/master/examples-oci/instance_principals_example.rb">instance_principals_example.rb</a>
         </td>
 	</tr>
     <tr>
@@ -115,7 +147,7 @@ The following table provides details about some of the attributes of the SDK.
 		<td>
             The Object Storage service supports multipart uploads to make large object uploads easier by splitting the large object into parts. The Ruby SDK supports raw multipart upload operations for advanced use cases, as well as a higher-level upload class that uses the multipart upload APIs.
             <p>
-                <a href="https://docs.us-phoenix-1.oraclecloud.com/Content/Object/Tasks/usingmultipartuploads.htm">Managing Multipart Uploads</a> provides links to the APIs used for raw multipart upload operations. Higher-level uploads can be performed using the {OCI::ObjectStorage::Transfer::UploadManager}.
+                <a href="https://docs.cloud.oracle.com/Content/Object/Tasks/usingmultipartuploads.htm">Managing Multipart Uploads</a> provides links to the APIs used for raw multipart upload operations. Higher-level uploads can be performed using the {OCI::ObjectStorage::Transfer::UploadManager}.
             </p>
             <p>
                 The UploadManager simplifies interaction with the Object Storage service by abstracting away the method used to upload objects and can handle uploading an entire object at once, or in multiple parts if it is of sufficient size (which is configurable via a {OCI::ObjectStorage::Transfer::UploadManagerConfig} object). In the latter case, the UploadManager will split a large object into parts for you, upload the parts in parallel, and then recombine and commit the parts as a single object in Object Storage.
@@ -142,7 +174,7 @@ The following table provides details about some of the attributes of the SDK.
 To use the Ruby SDK, you must have:
 
 * An Oracle Cloud Infrastructure account.
-* A user created in that account, in a group with a policy that grants the desired permissions. This can be a user for yourself, or another person/system that needs to call the API. For an example of how to set up a new user, group, compartment, and policy, see [Adding Users](https://docs.us-phoenix-1.oraclecloud.com/Content/GSG/Tasks/addingusers.htm) in the Getting Started Guide. For a list of typical policies you may want to use, see [Common Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/commonpolicies.htm) in the User Guide.
+* A user created in that account, in a group with a policy that grants the desired permissions. This can be a user for yourself, or another person/system that needs to call the API. For an example of how to set up a new user, group, compartment, and policy, see [Adding Users](https://docs.cloud.oracle.com/Content/GSG/Tasks/addingusers.htm) in the Getting Started Guide. For a list of typical policies you may want to use, see [Common Policies](https://docs.cloud.oracle.com/Content/Identity/Concepts/commonpolicies.htm) in the User Guide.
 * A keypair used for signing API requests, with the public key uploaded to Oracle. Only the user calling the API should be in possession of the private key. See the configuration information below.
 * Ruby version 2.2 or later running on Mac, Linux or Windows.
 
@@ -175,7 +207,7 @@ Using `OCI` as the top level module name is preferred and it is also used in the
 
 To use any of the APIs, you must supply a {OCI::Config Config} object. You can create the object directly in code, or you can create one in a config file. The configuration includes:
 
-* Required credentials and settings: See [SDK and Tool Configuration](https://docs.us-phoenix-1.oraclecloud.com/Content/API/Concepts/sdkconfig.htm) in the User Guide.
+* Required credentials and settings: See [SDK and Tool Configuration](https://docs.cloud.oracle.com/Content/API/Concepts/sdkconfig.htm) in the User Guide.
 * Optional SDK-specific settings: See the {OCI::Config Config} object for the full list of config options.
 
 Note that the Ruby SDK does not support parsing custom attributes in the configuration file.
@@ -339,7 +371,7 @@ Once an {OCI::ApiClientProxySettings} object has been created, it can be used wh
 ### Service Errors
 Any operation that receives a response with a non-2xx HTTP status code from an Oracle Cloud Infrastructure service will cause an exception of type {OCI::Errors::ServiceError ServiceError} to be thrown by the SDK.
 
-For information about common service errors returned by OCI, see [API Errors](https://docs.us-phoenix-1.oraclecloud.com/Content/API/References/apierrors.htm).
+For information about common service errors returned by OCI, see [API Errors](https://docs.cloud.oracle.com/Content/API/References/apierrors.htm).
 
 The key attributes to inspect when dealing with a {OCI::Errors::ServiceError} are:
 
@@ -585,9 +617,9 @@ The {OCI::Signer} can be used to sign arbitrary requests to the Oracle Cloud Inf
 
 ## Documentation
 
-Full documentation, including prerequisites, installation, and configuration instructions can be found [here](https://docs.us-phoenix-1.oraclecloud.com/Content/API/SDKDocs/rubysdk.htm).
+Full documentation, including prerequisites, installation, and configuration instructions can be found [here](docs.cloud.oracle.com/Content/API/SDKDocs/rubysdk.htm).
 
-API reference can be found [here](https://docs.us-phoenix-1.oraclecloud.com/tools/ruby/latest/frames.html).
+API reference can be found [here](https://docs.cloud.oracle.com/tools/ruby/latest/frames.html).
 
 ## Changes
 
@@ -604,7 +636,7 @@ To be notified when a new version of the Ruby SDK is released, subscribe to the
 
 ## Known Issues
 
-You can find information on any known issues with the SDK [here](https://docs.us-phoenix-1.oraclecloud.com/Content/knownissues.htm) and under the [Issues](https://github.com/oracle/oci-ruby-sdk/issues) tab of this project's [GitHub repository](https://github.com/oracle/oci-ruby-sdk).
+You can find information on any known issues with the SDK [here](https://docs.cloud.oracle.com/Content/knownissues.htm) and under the [Issues](https://github.com/oracle/oci-ruby-sdk/issues) tab of this project's [GitHub repository](https://github.com/oracle/oci-ruby-sdk).
 
 ## Questions or Feedback?
 You can post an issue on the [Issues](https://github.com/oracle/oci-ruby-sdk/issues) tab of this project's [GitHub repository](https://github.com/oracle/oci-ruby-sdk).
@@ -617,8 +649,9 @@ Addtional ways to get in touch:
 
 ## License
 
-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 SDK and sample is dual licensed under the Universal Permissive License 1.0 and the Apache License 2.0.
+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.
 
 See [LICENSE](https://github.com/oracle/oci-ruby-sdk/blob/master/LICENSE.txt) for more details.

data/lib/oci.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 'oci/api_client'
 require 'oci/api_client_proxy_settings'
@@ -48,6 +49,37 @@ require 'oci/oce/oce'
 require 'oci/oda/oda'
 require 'oci/integration/integration'
 require 'oci/analytics/analytics'
+require 'oci/apigateway/apigateway'
+require 'oci/os_management/os_management'
+require 'oci/marketplace/marketplace'
+require 'oci/nosql/nosql'
+require 'oci/data_catalog/data_catalog'
+require 'oci/application_migration/application_migration'
+require 'oci/data_flow/data_flow'
+require 'oci/data_science/data_science'
+require 'oci/vault/vault'
+require 'oci/bds/bds'
+require 'oci/secrets/secrets'
+require 'oci/cims/cims'
+require 'oci/data_safe/data_safe'
+require 'oci/mysql/mysql'
+require 'oci/data_integration/data_integration'
+require 'oci/usage_api/usage_api'
+require 'oci/ocvp/ocvp'
+require 'oci/blockchain/blockchain'
+require 'oci/management_agent/management_agent'
+require 'oci/loggingingestion/loggingingestion'
+require 'oci/logging/logging'
+require 'oci/management_dashboard/management_dashboard'
+require 'oci/loggingsearch/loggingsearch'
+require 'oci/log_analytics/log_analytics'
+require 'oci/sch/sch'
+require 'oci/cloud_guard/cloud_guard'
+require 'oci/opsi/opsi'
+require 'oci/compute_instance_agent/compute_instance_agent'
+require 'oci/tenant_manager_control_plane/tenant_manager_control_plane'
+require 'oci/optimizer/optimizer'
+require 'oci/rover/rover'
 
 # Top level module for the Oracle Cloud Infrastructure SDK
 module OCI

data/lib/oci/analytics/analytics.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 Analytics
@@ -15,14 +16,20 @@ require 'oci/analytics/models/analytics_instance_lifecycle_state'
 require 'oci/analytics/models/analytics_instance_summary'
 require 'oci/analytics/models/capacity'
 require 'oci/analytics/models/capacity_type'
+require 'oci/analytics/models/change_analytics_instance_network_endpoint_details'
 require 'oci/analytics/models/change_compartment_details'
 require 'oci/analytics/models/create_analytics_instance_details'
 require 'oci/analytics/models/feature_set'
 require 'oci/analytics/models/license_type'
+require 'oci/analytics/models/network_endpoint_details'
+require 'oci/analytics/models/network_endpoint_type'
+require 'oci/analytics/models/private_endpoint_details'
+require 'oci/analytics/models/public_endpoint_details'
 require 'oci/analytics/models/scale_analytics_instance_details'
 require 'oci/analytics/models/sort_by'
 require 'oci/analytics/models/sort_order'
 require 'oci/analytics/models/update_analytics_instance_details'
+require 'oci/analytics/models/virtual_cloud_network'
 require 'oci/analytics/models/work_request'
 require 'oci/analytics/models/work_request_action_result'
 require 'oci/analytics/models/work_request_error'

data/lib/oci/analytics/analytics_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
@@ -132,6 +122,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/analytics/change_analytics_instance_compartment.rb.html) to see an example of how to use change_analytics_instance_compartment API.
     def change_analytics_instance_compartment(analytics_instance_id, change_compartment_details, opts = {})
       logger.debug 'Calling operation AnalyticsClient#change_analytics_instance_compartment.' if logger
 
@@ -181,6 +172,80 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Change an Analytics instance network endpoint. The operation is long-running
+    # and creates a new WorkRequest.
+    #
+    # @param [String] analytics_instance_id The OCID of the AnalyticsInstance.
+    #
+    # @param [OCI::Analytics::Models::ChangeAnalyticsInstanceNetworkEndpointDetails] change_analytics_instance_network_endpoint_details Input payload for changing an Analytics instance network endpoint.
+    #
+    # @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 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 (for example, 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 nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/analytics/change_analytics_instance_network_endpoint.rb.html) to see an example of how to use change_analytics_instance_network_endpoint API.
+    def change_analytics_instance_network_endpoint(analytics_instance_id, change_analytics_instance_network_endpoint_details, opts = {})
+      logger.debug 'Calling operation AnalyticsClient#change_analytics_instance_network_endpoint.' if logger
+
+      raise "Missing the required parameter 'analytics_instance_id' when calling change_analytics_instance_network_endpoint." if analytics_instance_id.nil?
+      raise "Missing the required parameter 'change_analytics_instance_network_endpoint_details' when calling change_analytics_instance_network_endpoint." if change_analytics_instance_network_endpoint_details.nil?
+      raise "Parameter value for 'analytics_instance_id' must not be blank" if OCI::Internal::Util.blank_string?(analytics_instance_id)
+
+      path = '/analyticsInstances/{analyticsInstanceId}/actions/changeNetworkEndpoint'.sub('{analyticsInstanceId}', analytics_instance_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]
+      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_analytics_instance_network_endpoint_details)
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'AnalyticsClient#change_analytics_instance_network_endpoint') do
+        @api_client.call_api(
+          :POST,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body
+        )
+      end
+      # rubocop:enable Metrics/BlockLength
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Style/IfUnlessModifier, Metrics/ParameterLists
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
+
+
     # Create a new AnalyticsInstance in the specified compartment. The operation is long-running
     # and creates a new WorkRequest.
     #
@@ -199,6 +264,7 @@ module OCI
     #   may be rejected).
     #
     # @return [Response] A Response object with data of type {OCI::Analytics::Models::AnalyticsInstance AnalyticsInstance}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/analytics/create_analytics_instance.rb.html) to see an example of how to use create_analytics_instance API.
     def create_analytics_instance(create_analytics_instance_details, opts = {})
       logger.debug 'Calling operation AnalyticsClient#create_analytics_instance.' if logger
 
@@ -268,6 +334,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/analytics/delete_analytics_instance.rb.html) to see an example of how to use delete_analytics_instance API.
     def delete_analytics_instance(analytics_instance_id, opts = {})
       logger.debug 'Calling operation AnalyticsClient#delete_analytics_instance.' if logger
 
@@ -331,6 +398,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 nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/analytics/delete_work_request.rb.html) to see an example of how to use delete_work_request API.
     def delete_work_request(work_request_id, opts = {})
       logger.debug 'Calling operation AnalyticsClient#delete_work_request.' if logger
 
@@ -388,6 +456,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::Analytics::Models::AnalyticsInstance AnalyticsInstance}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/analytics/get_analytics_instance.rb.html) to see an example of how to use get_analytics_instance API.
     def get_analytics_instance(analytics_instance_id, opts = {})
       logger.debug 'Calling operation AnalyticsClient#get_analytics_instance.' if logger
 
@@ -445,6 +514,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::Analytics::Models::WorkRequest WorkRequest}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/analytics/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 AnalyticsClient#get_work_request.' if logger
 
@@ -528,6 +598,7 @@ module OCI
     # @option opts [String] :sort_order The sort order to use, either ascending (`ASC`) or descending (`DESC`).
     #
     # @return [Response] A Response object with data of type Array<{OCI::Analytics::Models::AnalyticsInstanceSummary AnalyticsInstanceSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/analytics/list_analytics_instances.rb.html) to see an example of how to use list_analytics_instances API.
     def list_analytics_instances(compartment_id, opts = {})
       logger.debug 'Calling operation AnalyticsClient#list_analytics_instances.' if logger
 
@@ -623,6 +694,7 @@ module OCI
     #   [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     # @return [Response] A Response object with data of type Array<{OCI::Analytics::Models::WorkRequestError WorkRequestError}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/analytics/list_work_request_errors.rb.html) to see an example of how to use list_work_request_errors API.
     def list_work_request_errors(work_request_id, opts = {})
       logger.debug 'Calling operation AnalyticsClient#list_work_request_errors.' if logger
 
@@ -692,6 +764,7 @@ module OCI
     #   [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     # @return [Response] A Response object with data of type Array<{OCI::Analytics::Models::WorkRequestLog WorkRequestLog}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/analytics/list_work_request_logs.rb.html) to see an example of how to use list_work_request_logs API.
     def list_work_request_logs(work_request_id, opts = {})
       logger.debug 'Calling operation AnalyticsClient#list_work_request_logs.' if logger
 
@@ -772,6 +845,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 Array<{OCI::Analytics::Models::WorkRequestSummary WorkRequestSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/analytics/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 AnalyticsClient#list_work_requests.' if logger
 
@@ -871,6 +945,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/analytics/scale_analytics_instance.rb.html) to see an example of how to use scale_analytics_instance API.
     def scale_analytics_instance(analytics_instance_id, scale_analytics_instance_details, opts = {})
       logger.debug 'Calling operation AnalyticsClient#scale_analytics_instance.' if logger
 
@@ -942,6 +1017,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/analytics/start_analytics_instance.rb.html) to see an example of how to use start_analytics_instance API.
     def start_analytics_instance(analytics_instance_id, opts = {})
       logger.debug 'Calling operation AnalyticsClient#start_analytics_instance.' if logger
 
@@ -1012,6 +1088,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/analytics/stop_analytics_instance.rb.html) to see an example of how to use stop_analytics_instance API.
     def stop_analytics_instance(analytics_instance_id, opts = {})
       logger.debug 'Calling operation AnalyticsClient#stop_analytics_instance.' if logger
 
@@ -1079,6 +1156,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::Analytics::Models::AnalyticsInstance AnalyticsInstance}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/analytics/update_analytics_instance.rb.html) to see an example of how to use update_analytics_instance API.
     def update_analytics_instance(analytics_instance_id, update_analytics_instance_details, opts = {})
       logger.debug 'Calling operation AnalyticsClient#update_analytics_instance.' if logger