oci 2.11.0 → 2.12.0

data/lib/oci/ocvp/esxi_host_client.rb

@@ -119,6 +119,7 @@ module OCI
     #   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/ocvp/create_esxi_host.rb.html) to see an example of how to use create_esxi_host API.
     def create_esxi_host(create_esxi_host_details, opts = {})
       logger.debug 'Calling operation EsxiHostClient#create_esxi_host.' if logger
 
@@ -195,6 +196,7 @@ module OCI
     #   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/ocvp/delete_esxi_host.rb.html) to see an example of how to use delete_esxi_host API.
     def delete_esxi_host(esxi_host_id, opts = {})
       logger.debug 'Calling operation EsxiHostClient#delete_esxi_host.' if logger
 
@@ -251,6 +253,7 @@ module OCI
     #   request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::EsxiHost EsxiHost}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/get_esxi_host.rb.html) to see an example of how to use get_esxi_host API.
     def get_esxi_host(esxi_host_id, opts = {})
       logger.debug 'Calling operation EsxiHostClient#get_esxi_host.' if logger
 
@@ -341,6 +344,7 @@ module OCI
     #
     # @option opts [String] :lifecycle_state The lifecycle state of the resource.
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::EsxiHostCollection EsxiHostCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/list_esxi_hosts.rb.html) to see an example of how to use list_esxi_hosts API.
     def list_esxi_hosts(opts = {})
       logger.debug 'Calling operation EsxiHostClient#list_esxi_hosts.' if logger
 
@@ -422,6 +426,7 @@ module OCI
     #   request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::EsxiHost EsxiHost}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/update_esxi_host.rb.html) to see an example of how to use update_esxi_host API.
     def update_esxi_host(esxi_host_id, update_esxi_host_details, opts = {})
       logger.debug 'Calling operation EsxiHostClient#update_esxi_host.' if logger
 

data/lib/oci/ocvp/sddc_client.rb

@@ -124,6 +124,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/ocvp/change_sddc_compartment.rb.html) to see an example of how to use change_sddc_compartment API.
     def change_sddc_compartment(sddc_id, change_sddc_compartment_details, opts = {})
       logger.debug 'Calling operation SddcClient#change_sddc_compartment.' if logger
 
@@ -192,6 +193,7 @@ module OCI
     #   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/ocvp/create_sddc.rb.html) to see an example of how to use create_sddc API.
     def create_sddc(create_sddc_details, opts = {})
       logger.debug 'Calling operation SddcClient#create_sddc.' if logger
 
@@ -260,6 +262,7 @@ module OCI
     #   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/ocvp/delete_sddc.rb.html) to see an example of how to use delete_sddc API.
     def delete_sddc(sddc_id, opts = {})
       logger.debug 'Calling operation SddcClient#delete_sddc.' if logger
 
@@ -316,6 +319,7 @@ module OCI
     #   request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::Sddc Sddc}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/get_sddc.rb.html) to see an example of how to use get_sddc API.
     def get_sddc(sddc_id, opts = {})
       logger.debug 'Calling operation SddcClient#get_sddc.' if logger
 
@@ -400,6 +404,7 @@ module OCI
     #
     # @option opts [String] :lifecycle_state The lifecycle state of the resource.
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::SddcCollection SddcCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/list_sddcs.rb.html) to see an example of how to use list_sddcs API.
     def list_sddcs(compartment_id, opts = {})
       logger.debug 'Calling operation SddcClient#list_sddcs.' if logger
 
@@ -484,6 +489,7 @@ module OCI
     #   request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::SupportedVmwareSoftwareVersionCollection SupportedVmwareSoftwareVersionCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/list_supported_vmware_software_versions.rb.html) to see an example of how to use list_supported_vmware_software_versions API.
     def list_supported_vmware_software_versions(compartment_id, opts = {})
       logger.debug 'Calling operation SddcClient#list_supported_vmware_software_versions.' if logger
 
@@ -555,6 +561,7 @@ module OCI
     #   request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::Sddc Sddc}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/update_sddc.rb.html) to see an example of how to use update_sddc API.
     def update_sddc(sddc_id, update_sddc_details, opts = {})
       logger.debug 'Calling operation SddcClient#update_sddc.' if logger
 

data/lib/oci/ocvp/work_request_client.rb

@@ -107,6 +107,7 @@ module OCI
     #   request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::WorkRequest WorkRequest}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/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 WorkRequestClient#get_work_request.' if logger
 
@@ -171,6 +172,7 @@ module OCI
     #   [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #    (default to 10)
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::WorkRequestErrorCollection WorkRequestErrorCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/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 WorkRequestClient#list_work_request_errors.' if logger
 
@@ -237,6 +239,7 @@ module OCI
     #   [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #    (default to 10)
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::WorkRequestLogEntryCollection WorkRequestLogEntryCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/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 WorkRequestClient#list_work_request_logs.' if logger
 
@@ -305,6 +308,7 @@ module OCI
     #   [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #    (default to 10)
     # @return [Response] A Response object with data of type {OCI::Ocvp::Models::WorkRequestCollection WorkRequestCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ocvp/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 WorkRequestClient#list_work_requests.' if logger
 

data/lib/oci/oda/oda_client.rb

@@ -122,6 +122,7 @@ module OCI
     #   then the service might reject a retry of the original creation request.
     #
     # @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/oda/change_oda_instance_compartment.rb.html) to see an example of how to use change_oda_instance_compartment API.
     def change_oda_instance_compartment(oda_instance_id, change_oda_instance_compartment_details, opts = {})
       logger.debug 'Calling operation OdaClient#change_oda_instance_compartment.' if logger
 
@@ -189,6 +190,7 @@ module OCI
     #   then the service might reject a retry of the original creation request.
     #
     # @return [Response] A Response object with data of type {OCI::Oda::Models::OdaInstance OdaInstance}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/oda/create_oda_instance.rb.html) to see an example of how to use create_oda_instance API.
     def create_oda_instance(create_oda_instance_details, opts = {})
       logger.debug 'Calling operation OdaClient#create_oda_instance.' if logger
 
@@ -251,6 +253,7 @@ module OCI
     #
     # @option opts [String] :opc_request_id The client request ID for tracing. This value is included in the opc-request-id response header.
     # @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/oda/delete_oda_instance.rb.html) to see an example of how to use delete_oda_instance API.
     def delete_oda_instance(oda_instance_id, opts = {})
       logger.debug 'Calling operation OdaClient#delete_oda_instance.' if logger
 
@@ -304,6 +307,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 The client request ID for tracing. This value is included in the opc-request-id response header.
     # @return [Response] A Response object with data of type {OCI::Oda::Models::OdaInstance OdaInstance}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/oda/get_oda_instance.rb.html) to see an example of how to use get_oda_instance API.
     def get_oda_instance(oda_instance_id, opts = {})
       logger.debug 'Calling operation OdaClient#get_oda_instance.' if logger
 
@@ -361,6 +365,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 The client request ID for tracing. This value is included in the opc-request-id response header.
     # @return [Response] A Response object with data of type {OCI::Oda::Models::WorkRequest WorkRequest}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/oda/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 OdaClient#get_work_request.' if logger
 
@@ -441,6 +446,7 @@ module OCI
     #   Allowed values are: TIMECREATED, DISPLAYNAME
     # @option opts [String] :opc_request_id The client request ID for tracing. This value is included in the opc-request-id response header.
     # @return [Response] A Response object with data of type Array<{OCI::Oda::Models::OdaInstanceSummary OdaInstanceSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/oda/list_oda_instances.rb.html) to see an example of how to use list_oda_instances API.
     def list_oda_instances(compartment_id, opts = {})
       logger.debug 'Calling operation OdaClient#list_oda_instances.' if logger
 
@@ -532,6 +538,7 @@ module OCI
     # @option opts [String] :sort_order Sort the results in this order, use either `ASC` (ascending) or `DESC` (descending).
     #   Allowed values are: ASC, DESC
     # @return [Response] A Response object with data of type Array<{OCI::Oda::Models::WorkRequestError WorkRequestError}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/oda/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 OdaClient#list_work_request_errors.' if logger
 
@@ -617,6 +624,7 @@ module OCI
     # @option opts [String] :sort_order Sort the results in this order, use either `ASC` (ascending) or `DESC` (descending).
     #   Allowed values are: ASC, DESC
     # @return [Response] A Response object with data of type Array<{OCI::Oda::Models::WorkRequestLogEntry WorkRequestLogEntry}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/oda/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 OdaClient#list_work_request_logs.' if logger
 
@@ -703,6 +711,7 @@ module OCI
     # @option opts [String] :sort_order Sort the results in this order, use either `ASC` (ascending) or `DESC` (descending).
     #   Allowed values are: ASC, DESC
     # @return [Response] A Response object with data of type Array<{OCI::Oda::Models::WorkRequestSummary WorkRequestSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/oda/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 OdaClient#list_work_requests.' if logger
 
@@ -785,6 +794,7 @@ module OCI
     #   then the service might reject a retry of the original creation request.
     #
     # @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/oda/start_oda_instance.rb.html) to see an example of how to use start_oda_instance API.
     def start_oda_instance(oda_instance_id, opts = {})
       logger.debug 'Calling operation OdaClient#start_oda_instance.' if logger
 
@@ -857,6 +867,7 @@ module OCI
     #   then the service might reject a retry of the original creation request.
     #
     # @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/oda/stop_oda_instance.rb.html) to see an example of how to use stop_oda_instance API.
     def stop_oda_instance(oda_instance_id, opts = {})
       logger.debug 'Calling operation OdaClient#stop_oda_instance.' if logger
 
@@ -920,6 +931,7 @@ module OCI
     #
     # @option opts [String] :opc_request_id The client request ID for tracing. This value is included in the opc-request-id response header.
     # @return [Response] A Response object with data of type {OCI::Oda::Models::OdaInstance OdaInstance}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/oda/update_oda_instance.rb.html) to see an example of how to use update_oda_instance API.
     def update_oda_instance(oda_instance_id, update_oda_instance_details, opts = {})
       logger.debug 'Calling operation OdaClient#update_oda_instance.' if logger
 

data/lib/oci/ons/notification_control_plane_client.rb

@@ -125,6 +125,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/change_topic_compartment.rb.html) to see an example of how to use change_topic_compartment API.
     def change_topic_compartment(topic_id, change_topic_compartment_details, opts = {})
       logger.debug 'Calling operation NotificationControlPlaneClient#change_topic_compartment.' if logger
 
@@ -203,6 +204,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ons::Models::NotificationTopic NotificationTopic}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/create_topic.rb.html) to see an example of how to use create_topic API.
     def create_topic(create_topic_details, opts = {})
       logger.debug 'Calling operation NotificationControlPlaneClient#create_topic.' if logger
 
@@ -267,6 +269,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/delete_topic.rb.html) to see an example of how to use delete_topic API.
     def delete_topic(topic_id, opts = {})
       logger.debug 'Calling operation NotificationControlPlaneClient#delete_topic.' if logger
 
@@ -326,6 +329,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ons::Models::NotificationTopic NotificationTopic}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/get_topic.rb.html) to see an example of how to use get_topic API.
     def get_topic(topic_id, opts = {})
       logger.debug 'Calling operation NotificationControlPlaneClient#get_topic.' if logger
 
@@ -403,6 +407,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Ons::Models::NotificationTopicSummary NotificationTopicSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/list_topics.rb.html) to see an example of how to use list_topics API.
     def list_topics(compartment_id, opts = {})
       logger.debug 'Calling operation NotificationControlPlaneClient#list_topics.' if logger
 
@@ -486,6 +491,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Ons::Models::NotificationTopic NotificationTopic}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/update_topic.rb.html) to see an example of how to use update_topic API.
     def update_topic(topic_id, topic_attributes_details, opts = {})
       logger.debug 'Calling operation NotificationControlPlaneClient#update_topic.' if logger
 

data/lib/oci/ons/notification_data_plane_client.rb

@@ -125,6 +125,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/change_subscription_compartment.rb.html) to see an example of how to use change_subscription_compartment API.
     def change_subscription_compartment(subscription_id, change_subscription_compartment_details, opts = {})
       logger.debug 'Calling operation NotificationDataPlaneClient#change_subscription_compartment.' if logger
 
@@ -194,6 +195,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ons::Models::Subscription Subscription}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/create_subscription.rb.html) to see an example of how to use create_subscription API.
     def create_subscription(create_subscription_details, opts = {})
       logger.debug 'Calling operation NotificationDataPlaneClient#create_subscription.' if logger
 
@@ -258,6 +260,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type nil
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/delete_subscription.rb.html) to see an example of how to use delete_subscription API.
     def delete_subscription(subscription_id, opts = {})
       logger.debug 'Calling operation NotificationDataPlaneClient#delete_subscription.' if logger
 
@@ -331,6 +334,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ons::Models::ConfirmationResult ConfirmationResult}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/get_confirm_subscription.rb.html) to see an example of how to use get_confirm_subscription API.
     def get_confirm_subscription(id, token, protocol, opts = {})
       logger.debug 'Calling operation NotificationDataPlaneClient#get_confirm_subscription.' if logger
 
@@ -394,6 +398,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ons::Models::Subscription Subscription}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/get_subscription.rb.html) to see an example of how to use get_subscription API.
     def get_subscription(subscription_id, opts = {})
       logger.debug 'Calling operation NotificationDataPlaneClient#get_subscription.' if logger
 
@@ -467,6 +472,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type String
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/get_unsubscription.rb.html) to see an example of how to use get_unsubscription API.
     def get_unsubscription(id, token, protocol, opts = {})
       logger.debug 'Calling operation NotificationDataPlaneClient#get_unsubscription.' if logger
 
@@ -538,6 +544,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Ons::Models::SubscriptionSummary SubscriptionSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/list_subscriptions.rb.html) to see an example of how to use list_subscriptions API.
     def list_subscriptions(compartment_id, opts = {})
       logger.debug 'Calling operation NotificationDataPlaneClient#list_subscriptions.' if logger
 
@@ -618,6 +625,7 @@ module OCI
     #    (default to JSON)
     #   Allowed values are: JSON, RAW_TEXT
     # @return [Response] A Response object with data of type {OCI::Ons::Models::PublishResult PublishResult}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/publish_message.rb.html) to see an example of how to use publish_message API.
     def publish_message(topic_id, message_details, opts = {})
       logger.debug 'Calling operation NotificationDataPlaneClient#publish_message.' if logger
 
@@ -683,6 +691,7 @@ module OCI
     #   particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Ons::Models::Subscription Subscription}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/resend_subscription_confirmation.rb.html) to see an example of how to use resend_subscription_confirmation API.
     def resend_subscription_confirmation(id, opts = {})
       logger.debug 'Calling operation NotificationDataPlaneClient#resend_subscription_confirmation.' if logger
 
@@ -748,6 +757,7 @@ module OCI
     #   will be updated or deleted only if the etag you provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::Ons::Models::UpdateSubscriptionDetails UpdateSubscriptionDetails}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/ons/update_subscription.rb.html) to see an example of how to use update_subscription API.
     def update_subscription(subscription_id, update_subscription_details, opts = {})
       logger.debug 'Calling operation NotificationDataPlaneClient#update_subscription.' if logger
 

data/lib/oci/opsi/models/sql_insight_aggregation.rb

@@ -9,7 +9,7 @@ module OCI
   class Opsi::Models::SqlInsightAggregation
     # **[Required]** Insight text.
     # For example `Degrading SQLs`, `Variant SQLs`,
-    #   `Inefficient SQLs`, `SQLs with Plan Changes`,
+    #   `Inefficient SQLs`, `Improving SQLs`, `SQLs with Plan Changes`,
     #   `Degrading SQLs have increasing IO Time above 50%`,
     #   `Degrading SQLs are variant`,
     #   `2 of the 2 variant SQLs have plan changes`,
@@ -28,6 +28,7 @@ module OCI
     # VARIANT,
     # INEFFICIENT,
     # CHANGING_PLANS,
+    # IMPROVING,
     # DEGRADING_VARIANT,
     # DEGRADING_INEFFICIENT,
     # DEGRADING_CHANGING_PLANS,

data/lib/oci/opsi/models/sql_insight_thresholds.rb

@@ -43,6 +43,11 @@ module OCI
     # @return [Integer]
     attr_accessor :increase_in_inefficient_wait_in_pct
 
+    # **[Required]** Improved Percent Threshold is used to derive improving SQLs.
+    #
+    # @return [Integer]
+    attr_accessor :improved_in_pct
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
@@ -52,7 +57,8 @@ module OCI
         'inefficiency_in_pct': :'inefficiencyInPct',
         'increase_in_io_in_pct': :'increaseInIOInPct',
         'increase_in_cpu_in_pct': :'increaseInCPUInPct',
-        'increase_in_inefficient_wait_in_pct': :'increaseInInefficientWaitInPct'
+        'increase_in_inefficient_wait_in_pct': :'increaseInInefficientWaitInPct',
+        'improved_in_pct': :'improvedInPct'
         # rubocop:enable Style/SymbolLiteral
       }
     end
@@ -66,7 +72,8 @@ module OCI
         'inefficiency_in_pct': :'Integer',
         'increase_in_io_in_pct': :'Integer',
         'increase_in_cpu_in_pct': :'Integer',
-        'increase_in_inefficient_wait_in_pct': :'Integer'
+        'increase_in_inefficient_wait_in_pct': :'Integer',
+        'improved_in_pct': :'Integer'
         # rubocop:enable Style/SymbolLiteral
       }
     end
@@ -83,6 +90,7 @@ module OCI
     # @option attributes [Integer] :increase_in_io_in_pct The value to assign to the {#increase_in_io_in_pct} property
     # @option attributes [Integer] :increase_in_cpu_in_pct The value to assign to the {#increase_in_cpu_in_pct} property
     # @option attributes [Integer] :increase_in_inefficient_wait_in_pct The value to assign to the {#increase_in_inefficient_wait_in_pct} property
+    # @option attributes [Integer] :improved_in_pct The value to assign to the {#improved_in_pct} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 
@@ -131,6 +139,14 @@ module OCI
 
       self.increase_in_inefficient_wait_in_pct = attributes[:'increase_in_inefficient_wait_in_pct'] if attributes[:'increase_in_inefficient_wait_in_pct']
       self.increase_in_inefficient_wait_in_pct = 50 if increase_in_inefficient_wait_in_pct.nil? && !attributes.key?(:'increaseInInefficientWaitInPct') && !attributes.key?(:'increase_in_inefficient_wait_in_pct') # rubocop:disable Style/StringLiterals
+
+      self.improved_in_pct = attributes[:'improvedInPct'] if attributes[:'improvedInPct']
+      self.improved_in_pct = 20 if improved_in_pct.nil? && !attributes.key?(:'improvedInPct') # rubocop:disable Style/StringLiterals
+
+      raise 'You cannot provide both :improvedInPct and :improved_in_pct' if attributes.key?(:'improvedInPct') && attributes.key?(:'improved_in_pct')
+
+      self.improved_in_pct = attributes[:'improved_in_pct'] if attributes[:'improved_in_pct']
+      self.improved_in_pct = 20 if improved_in_pct.nil? && !attributes.key?(:'improvedInPct') && !attributes.key?(:'improved_in_pct') # rubocop:disable Style/StringLiterals
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
     # rubocop:enable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
@@ -149,7 +165,8 @@ module OCI
         inefficiency_in_pct == other.inefficiency_in_pct &&
         increase_in_io_in_pct == other.increase_in_io_in_pct &&
         increase_in_cpu_in_pct == other.increase_in_cpu_in_pct &&
-        increase_in_inefficient_wait_in_pct == other.increase_in_inefficient_wait_in_pct
+        increase_in_inefficient_wait_in_pct == other.increase_in_inefficient_wait_in_pct &&
+        improved_in_pct == other.improved_in_pct
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
 
@@ -165,7 +182,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [degradation_in_pct, variability, inefficiency_in_pct, increase_in_io_in_pct, increase_in_cpu_in_pct, increase_in_inefficient_wait_in_pct].hash
+      [degradation_in_pct, variability, inefficiency_in_pct, increase_in_io_in_pct, increase_in_cpu_in_pct, increase_in_inefficient_wait_in_pct, improved_in_pct].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/opsi/operations_insights_client.rb

@@ -123,6 +123,7 @@ module OCI
     #   operations, such as a resource being deleted or purged from the system.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::IngestSqlBucketResponseDetails IngestSqlBucketResponseDetails}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/ingest_sql_bucket.rb.html) to see an example of how to use ingest_sql_bucket API.
     def ingest_sql_bucket(compartment_id, database_id, ingest_sql_bucket_details, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#ingest_sql_bucket.' if logger
 
@@ -198,6 +199,7 @@ module OCI
     #   operations, such as a resource being deleted or purged from the system.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::IngestSqlPlanLinesResponseDetails IngestSqlPlanLinesResponseDetails}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/ingest_sql_plan_lines.rb.html) to see an example of how to use ingest_sql_plan_lines API.
     def ingest_sql_plan_lines(compartment_id, database_id, ingest_sql_plan_lines_details, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#ingest_sql_plan_lines.' if logger
 
@@ -275,6 +277,7 @@ module OCI
     #   operations, such as a resource being deleted or purged from the system.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::IngestSqlTextResponseDetails IngestSqlTextResponseDetails}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/ingest_sql_text.rb.html) to see an example of how to use ingest_sql_text API.
     def ingest_sql_text(compartment_id, database_id, ingest_sql_text_details, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#ingest_sql_text.' if logger
 
@@ -360,6 +363,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::DatabaseInsightsCollection DatabaseInsightsCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/list_database_insights.rb.html) to see an example of how to use list_database_insights API.
     def list_database_insights(compartment_id, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#list_database_insights.' if logger
 
@@ -462,6 +466,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SqlPlanCollection SqlPlanCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/list_sql_plans.rb.html) to see an example of how to use list_sql_plans API.
     def list_sql_plans(compartment_id, database_id, sql_identifier, plan_hash, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#list_sql_plans.' if logger
 
@@ -547,6 +552,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SqlSearchCollection SqlSearchCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/list_sql_searches.rb.html) to see an example of how to use list_sql_searches API.
     def list_sql_searches(compartment_id, sql_identifier, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#list_sql_searches.' if logger
 
@@ -617,6 +623,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SqlTextCollection SqlTextCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/list_sql_texts.rb.html) to see an example of how to use list_sql_texts API.
     def list_sql_texts(compartment_id, sql_identifier, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#list_sql_texts.' if logger
 
@@ -719,6 +726,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SummarizeDatabaseInsightResourceCapacityTrendAggregationCollection SummarizeDatabaseInsightResourceCapacityTrendAggregationCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_database_insight_resource_capacity_trend.rb.html) to see an example of how to use summarize_database_insight_resource_capacity_trend API.
     def summarize_database_insight_resource_capacity_trend(compartment_id, resource_metric, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_database_insight_resource_capacity_trend.' if logger
 
@@ -861,6 +869,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SummarizeDatabaseInsightResourceForecastTrendAggregation SummarizeDatabaseInsightResourceForecastTrendAggregation}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_database_insight_resource_forecast_trend.rb.html) to see an example of how to use summarize_database_insight_resource_forecast_trend API.
     def summarize_database_insight_resource_forecast_trend(compartment_id, resource_metric, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_database_insight_resource_forecast_trend.' if logger
 
@@ -999,6 +1008,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SummarizeDatabaseInsightResourceStatisticsAggregationCollection SummarizeDatabaseInsightResourceStatisticsAggregationCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_database_insight_resource_statistics.rb.html) to see an example of how to use summarize_database_insight_resource_statistics API.
     def summarize_database_insight_resource_statistics(compartment_id, resource_metric, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_database_insight_resource_statistics.' if logger
 
@@ -1120,6 +1130,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SummarizeDatabaseInsightResourceUsageAggregation SummarizeDatabaseInsightResourceUsageAggregation}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_database_insight_resource_usage.rb.html) to see an example of how to use summarize_database_insight_resource_usage API.
     def summarize_database_insight_resource_usage(compartment_id, resource_metric, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_database_insight_resource_usage.' if logger
 
@@ -1230,6 +1241,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SummarizeDatabaseInsightResourceUsageTrendAggregationCollection SummarizeDatabaseInsightResourceUsageTrendAggregationCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_database_insight_resource_usage_trend.rb.html) to see an example of how to use summarize_database_insight_resource_usage_trend API.
     def summarize_database_insight_resource_usage_trend(compartment_id, resource_metric, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_database_insight_resource_usage_trend.' if logger
 
@@ -1344,6 +1356,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SummarizeDatabaseInsightResourceUtilizationInsightAggregation SummarizeDatabaseInsightResourceUtilizationInsightAggregation}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_database_insight_resource_utilization_insight.rb.html) to see an example of how to use summarize_database_insight_resource_utilization_insight API.
     def summarize_database_insight_resource_utilization_insight(compartment_id, resource_metric, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_database_insight_resource_utilization_insight.' if logger
 
@@ -1446,6 +1459,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SqlInsightAggregationCollection SqlInsightAggregationCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_sql_insights.rb.html) to see an example of how to use summarize_sql_insights API.
     def summarize_sql_insights(compartment_id, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_sql_insights.' if logger
 
@@ -1543,6 +1557,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SqlPlanInsightAggregationCollection SqlPlanInsightAggregationCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_sql_plan_insights.rb.html) to see an example of how to use summarize_sql_plan_insights API.
     def summarize_sql_plan_insights(compartment_id, database_id, sql_identifier, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_sql_plan_insights.' if logger
 
@@ -1631,6 +1646,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SqlResponseTimeDistributionAggregationCollection SqlResponseTimeDistributionAggregationCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_sql_response_time_distributions.rb.html) to see an example of how to use summarize_sql_response_time_distributions API.
     def summarize_sql_response_time_distributions(compartment_id, database_id, sql_identifier, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_sql_response_time_distributions.' if logger
 
@@ -1738,8 +1754,9 @@ module OCI
     #   Allowed values are: databaseTimeInSec, executionsPerHour, executionsCount, cpuTimeInSec, ioTimeInSec, inefficientWaitTimeInSec, responseTimeInSec, planCount, variability, averageActiveSessions, databaseTimePct, inefficiencyInPct, changeInCpuTimeInPct, changeInIoTimeInPct, changeInInefficientWaitTimeInPct, changeInResponseTimeInPct, changeInAverageActiveSessionsInPct, changeInExecutionsPerHourInPct, changeInInefficiencyInPct
     # @option opts [Array<String>] :category Filter sqls by one or more performance categories.
     #    (default to [])
-    #   Allowed values are: DEGRADING, VARIANT, INEFFICIENT, CHANGING_PLANS, DEGRADING_VARIANT, DEGRADING_INEFFICIENT, DEGRADING_CHANGING_PLANS, DEGRADING_INCREASING_IO, DEGRADING_INCREASING_CPU, DEGRADING_INCREASING_INEFFICIENT_WAIT, DEGRADING_CHANGING_PLANS_AND_INCREASING_IO, DEGRADING_CHANGING_PLANS_AND_INCREASING_CPU, DEGRADING_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT, VARIANT_INEFFICIENT, VARIANT_CHANGING_PLANS, VARIANT_INCREASING_IO, VARIANT_INCREASING_CPU, VARIANT_INCREASING_INEFFICIENT_WAIT, VARIANT_CHANGING_PLANS_AND_INCREASING_IO, VARIANT_CHANGING_PLANS_AND_INCREASING_CPU, VARIANT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT, INEFFICIENT_CHANGING_PLANS, INEFFICIENT_INCREASING_INEFFICIENT_WAIT, INEFFICIENT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT
+    #   Allowed values are: DEGRADING, VARIANT, INEFFICIENT, CHANGING_PLANS, IMPROVING, DEGRADING_VARIANT, DEGRADING_INEFFICIENT, DEGRADING_CHANGING_PLANS, DEGRADING_INCREASING_IO, DEGRADING_INCREASING_CPU, DEGRADING_INCREASING_INEFFICIENT_WAIT, DEGRADING_CHANGING_PLANS_AND_INCREASING_IO, DEGRADING_CHANGING_PLANS_AND_INCREASING_CPU, DEGRADING_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT, VARIANT_INEFFICIENT, VARIANT_CHANGING_PLANS, VARIANT_INCREASING_IO, VARIANT_INCREASING_CPU, VARIANT_INCREASING_INEFFICIENT_WAIT, VARIANT_CHANGING_PLANS_AND_INCREASING_IO, VARIANT_CHANGING_PLANS_AND_INCREASING_CPU, VARIANT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT, INEFFICIENT_CHANGING_PLANS, INEFFICIENT_INCREASING_INEFFICIENT_WAIT, INEFFICIENT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SqlStatisticAggregationCollection SqlStatisticAggregationCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_sql_statistics.rb.html) to see an example of how to use summarize_sql_statistics API.
     def summarize_sql_statistics(compartment_id, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_sql_statistics.' if logger
 
@@ -1764,11 +1781,11 @@ module OCI
       end
 
 
-      category_allowable_values = %w[DEGRADING VARIANT INEFFICIENT CHANGING_PLANS DEGRADING_VARIANT DEGRADING_INEFFICIENT DEGRADING_CHANGING_PLANS DEGRADING_INCREASING_IO DEGRADING_INCREASING_CPU DEGRADING_INCREASING_INEFFICIENT_WAIT DEGRADING_CHANGING_PLANS_AND_INCREASING_IO DEGRADING_CHANGING_PLANS_AND_INCREASING_CPU DEGRADING_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT VARIANT_INEFFICIENT VARIANT_CHANGING_PLANS VARIANT_INCREASING_IO VARIANT_INCREASING_CPU VARIANT_INCREASING_INEFFICIENT_WAIT VARIANT_CHANGING_PLANS_AND_INCREASING_IO VARIANT_CHANGING_PLANS_AND_INCREASING_CPU VARIANT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT INEFFICIENT_CHANGING_PLANS INEFFICIENT_INCREASING_INEFFICIENT_WAIT INEFFICIENT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT]
+      category_allowable_values = %w[DEGRADING VARIANT INEFFICIENT CHANGING_PLANS IMPROVING DEGRADING_VARIANT DEGRADING_INEFFICIENT DEGRADING_CHANGING_PLANS DEGRADING_INCREASING_IO DEGRADING_INCREASING_CPU DEGRADING_INCREASING_INEFFICIENT_WAIT DEGRADING_CHANGING_PLANS_AND_INCREASING_IO DEGRADING_CHANGING_PLANS_AND_INCREASING_CPU DEGRADING_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT VARIANT_INEFFICIENT VARIANT_CHANGING_PLANS VARIANT_INCREASING_IO VARIANT_INCREASING_CPU VARIANT_INCREASING_INEFFICIENT_WAIT VARIANT_CHANGING_PLANS_AND_INCREASING_IO VARIANT_CHANGING_PLANS_AND_INCREASING_CPU VARIANT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT INEFFICIENT_CHANGING_PLANS INEFFICIENT_INCREASING_INEFFICIENT_WAIT INEFFICIENT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT]
       if opts[:category] && !opts[:category].empty?
         opts[:category].each do |val_to_check|
           unless category_allowable_values.include?(val_to_check)
-            raise 'Invalid value for "category", must be one of DEGRADING, VARIANT, INEFFICIENT, CHANGING_PLANS, DEGRADING_VARIANT, DEGRADING_INEFFICIENT, DEGRADING_CHANGING_PLANS, DEGRADING_INCREASING_IO, DEGRADING_INCREASING_CPU, DEGRADING_INCREASING_INEFFICIENT_WAIT, DEGRADING_CHANGING_PLANS_AND_INCREASING_IO, DEGRADING_CHANGING_PLANS_AND_INCREASING_CPU, DEGRADING_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT, VARIANT_INEFFICIENT, VARIANT_CHANGING_PLANS, VARIANT_INCREASING_IO, VARIANT_INCREASING_CPU, VARIANT_INCREASING_INEFFICIENT_WAIT, VARIANT_CHANGING_PLANS_AND_INCREASING_IO, VARIANT_CHANGING_PLANS_AND_INCREASING_CPU, VARIANT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT, INEFFICIENT_CHANGING_PLANS, INEFFICIENT_INCREASING_INEFFICIENT_WAIT, INEFFICIENT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT.'
+            raise 'Invalid value for "category", must be one of DEGRADING, VARIANT, INEFFICIENT, CHANGING_PLANS, IMPROVING, DEGRADING_VARIANT, DEGRADING_INEFFICIENT, DEGRADING_CHANGING_PLANS, DEGRADING_INCREASING_IO, DEGRADING_INCREASING_CPU, DEGRADING_INCREASING_INEFFICIENT_WAIT, DEGRADING_CHANGING_PLANS_AND_INCREASING_IO, DEGRADING_CHANGING_PLANS_AND_INCREASING_CPU, DEGRADING_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT, VARIANT_INEFFICIENT, VARIANT_CHANGING_PLANS, VARIANT_INCREASING_IO, VARIANT_INCREASING_CPU, VARIANT_INCREASING_INEFFICIENT_WAIT, VARIANT_CHANGING_PLANS_AND_INCREASING_IO, VARIANT_CHANGING_PLANS_AND_INCREASING_CPU, VARIANT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT, INEFFICIENT_CHANGING_PLANS, INEFFICIENT_INCREASING_INEFFICIENT_WAIT, INEFFICIENT_CHANGING_PLANS_AND_INCREASING_INEFFICIENT_WAIT.'
           end
         end
       end
@@ -1860,6 +1877,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SqlStatisticsTimeSeriesAggregationCollection SqlStatisticsTimeSeriesAggregationCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_sql_statistics_time_series.rb.html) to see an example of how to use summarize_sql_statistics_time_series API.
     def summarize_sql_statistics_time_series(compartment_id, sql_identifier, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_sql_statistics_time_series.' if logger
 
@@ -1947,6 +1965,7 @@ module OCI
     #   Oracle about a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Opsi::Models::SqlStatisticsTimeSeriesByPlanAggregationCollection SqlStatisticsTimeSeriesByPlanAggregationCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/opsi/summarize_sql_statistics_time_series_by_plan.rb.html) to see an example of how to use summarize_sql_statistics_time_series_by_plan API.
     def summarize_sql_statistics_time_series_by_plan(compartment_id, database_id, sql_identifier, opts = {})
       logger.debug 'Calling operation OperationsInsightsClient#summarize_sql_statistics_time_series_by_plan.' if logger