oci 2.11.0 → 2.12.0

data/lib/oci/logging/logging_management_client.rb

@@ -116,6 +116,7 @@ module OCI
     #   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/logging/change_log_group_compartment.rb.html) to see an example of how to use change_log_group_compartment API.
     def change_log_group_compartment(log_group_id, change_log_group_compartment_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#change_log_group_compartment.' if logger
 
@@ -181,6 +182,7 @@ module OCI
     #   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/logging/change_log_log_group.rb.html) to see an example of how to use change_log_log_group API.
     def change_log_log_group(log_group_id, log_id, change_log_log_group_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#change_log_log_group.' if logger
 
@@ -256,6 +258,7 @@ module OCI
     #   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/logging/change_log_saved_search_compartment.rb.html) to see an example of how to use change_log_saved_search_compartment API.
     def change_log_saved_search_compartment(log_saved_search_id, change_log_saved_search_compartment_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#change_log_saved_search_compartment.' if logger
 
@@ -330,6 +333,7 @@ module OCI
     #   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/logging/change_unified_agent_configuration_compartment.rb.html) to see an example of how to use change_unified_agent_configuration_compartment API.
     def change_unified_agent_configuration_compartment(unified_agent_configuration_id, change_unified_agent_configuration_compartment_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#change_unified_agent_configuration_compartment.' if logger
 
@@ -398,6 +402,7 @@ module OCI
     #   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/logging/create_log.rb.html) to see an example of how to use create_log API.
     def create_log(log_group_id, create_log_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#create_log.' if logger
 
@@ -464,6 +469,7 @@ module OCI
     #   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/logging/create_log_group.rb.html) to see an example of how to use create_log_group API.
     def create_log_group(create_log_group_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#create_log_group.' if logger
 
@@ -527,6 +533,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::LogSavedSearch LogSavedSearch}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/create_log_saved_search.rb.html) to see an example of how to use create_log_saved_search API.
     def create_log_saved_search(create_log_saved_search_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#create_log_saved_search.' if logger
 
@@ -590,6 +597,7 @@ module OCI
     #   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/logging/create_unified_agent_configuration.rb.html) to see an example of how to use create_unified_agent_configuration API.
     def create_unified_agent_configuration(create_unified_agent_configuration_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#create_unified_agent_configuration.' if logger
 
@@ -652,6 +660,7 @@ module OCI
     #   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/logging/delete_log.rb.html) to see an example of how to use delete_log API.
     def delete_log(log_group_id, log_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#delete_log.' if logger
 
@@ -715,6 +724,7 @@ module OCI
     #   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/logging/delete_log_group.rb.html) to see an example of how to use delete_log_group API.
     def delete_log_group(log_group_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#delete_log_group.' if logger
 
@@ -777,6 +787,7 @@ module OCI
     #   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/logging/delete_log_saved_search.rb.html) to see an example of how to use delete_log_saved_search API.
     def delete_log_saved_search(log_saved_search_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#delete_log_saved_search.' if logger
 
@@ -838,6 +849,7 @@ module OCI
     #   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/logging/delete_unified_agent_configuration.rb.html) to see an example of how to use delete_unified_agent_configuration API.
     def delete_unified_agent_configuration(unified_agent_configuration_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#delete_unified_agent_configuration.' if logger
 
@@ -900,6 +912,7 @@ module OCI
     #   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/logging/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 LoggingManagementClient#delete_work_request.' if logger
 
@@ -957,6 +970,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::Log Log}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/get_log.rb.html) to see an example of how to use get_log API.
     def get_log(log_group_id, log_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#get_log.' if logger
 
@@ -1014,6 +1028,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::LogGroup LogGroup}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/get_log_group.rb.html) to see an example of how to use get_log_group API.
     def get_log_group(log_group_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#get_log_group.' if logger
 
@@ -1073,6 +1088,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::LogIncludedSearch LogIncludedSearch}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/get_log_included_search.rb.html) to see an example of how to use get_log_included_search API.
     def get_log_included_search(compartment_id, log_included_search_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#get_log_included_search.' if logger
 
@@ -1131,6 +1147,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::LogSavedSearch LogSavedSearch}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/get_log_saved_search.rb.html) to see an example of how to use get_log_saved_search API.
     def get_log_saved_search(log_saved_search_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#get_log_saved_search.' if logger
 
@@ -1186,6 +1203,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::UnifiedAgentConfiguration UnifiedAgentConfiguration}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/get_unified_agent_configuration.rb.html) to see an example of how to use get_unified_agent_configuration API.
     def get_unified_agent_configuration(unified_agent_configuration_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#get_unified_agent_configuration.' if logger
 
@@ -1241,6 +1259,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::WorkRequest WorkRequest}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/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 LoggingManagementClient#get_work_request.' if logger
 
@@ -1312,6 +1331,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Logging::Models::LogGroupSummary LogGroupSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/list_log_groups.rb.html) to see an example of how to use list_log_groups API.
     def list_log_groups(compartment_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#list_log_groups.' if logger
 
@@ -1399,6 +1419,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::LogIncludedSearchSummaryCollection LogIncludedSearchSummaryCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/list_log_included_searches.rb.html) to see an example of how to use list_log_included_searches API.
     def list_log_included_searches(compartment_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#list_log_included_searches.' if logger
 
@@ -1486,6 +1507,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::LogSavedSearchSummaryCollection LogSavedSearchSummaryCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/list_log_saved_searches.rb.html) to see an example of how to use list_log_saved_searches API.
     def list_log_saved_searches(compartment_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#list_log_saved_searches.' if logger
 
@@ -1573,6 +1595,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Logging::Models::LogSummary LogSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/list_logs.rb.html) to see an example of how to use list_logs API.
     def list_logs(log_group_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#list_logs.' if logger
 
@@ -1652,6 +1675,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type Array<{OCI::Logging::Models::ServiceSummary ServiceSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/list_services.rb.html) to see an example of how to use list_services API.
     def list_services(opts = {})
       logger.debug 'Calling operation LoggingManagementClient#list_services.' if logger
 
@@ -1725,6 +1749,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::UnifiedAgentConfigurationCollection UnifiedAgentConfigurationCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/list_unified_agent_configurations.rb.html) to see an example of how to use list_unified_agent_configurations API.
     def list_unified_agent_configurations(compartment_id, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#list_unified_agent_configurations.' if logger
 
@@ -1807,6 +1832,7 @@ module OCI
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #    (default to 100)
     # @return [Response] A Response object with data of type Array<{OCI::Logging::Models::WorkRequestError WorkRequestError}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/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 LoggingManagementClient#list_work_request_errors.' if logger
 
@@ -1870,6 +1896,7 @@ module OCI
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call.
     #    (default to 100)
     # @return [Response] A Response object with data of type Array<{OCI::Logging::Models::WorkRequestLog WorkRequestLog}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/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 LoggingManagementClient#list_work_request_logs.' if logger
 
@@ -1944,6 +1971,7 @@ module OCI
     #
     #   Allowed values are: operationType, status, timeAccepted
     # @return [Response] A Response object with data of type Array<{OCI::Logging::Models::WorkRequestSummary WorkRequestSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/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 LoggingManagementClient#list_work_requests.' if logger
 
@@ -2027,6 +2055,7 @@ module OCI
     #   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/logging/update_log.rb.html) to see an example of how to use update_log API.
     def update_log(log_group_id, log_id, update_log_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#update_log.' if logger
 
@@ -2094,6 +2123,7 @@ module OCI
     #   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/logging/update_log_group.rb.html) to see an example of how to use update_log_group API.
     def update_log_group(log_group_id, update_log_group_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#update_log_group.' if logger
 
@@ -2159,6 +2189,7 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @return [Response] A Response object with data of type {OCI::Logging::Models::LogSavedSearch LogSavedSearch}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/logging/update_log_saved_search.rb.html) to see an example of how to use update_log_saved_search API.
     def update_log_saved_search(log_saved_search_id, update_log_saved_search_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#update_log_saved_search.' if logger
 
@@ -2226,6 +2257,7 @@ module OCI
     #   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/logging/update_unified_agent_configuration.rb.html) to see an example of how to use update_unified_agent_configuration API.
     def update_unified_agent_configuration(unified_agent_configuration_id, update_unified_agent_configuration_details, opts = {})
       logger.debug 'Calling operation LoggingManagementClient#update_unified_agent_configuration.' if logger
 

data/lib/oci/loggingingestion/logging_client.rb

@@ -114,6 +114,7 @@ module OCI
     #   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/loggingingestion/put_logs.rb.html) to see an example of how to use put_logs API.
     def put_logs(log_id, put_logs_details, opts = {})
       logger.debug 'Calling operation LoggingClient#put_logs.' if logger
 

data/lib/oci/loggingsearch/log_search_client.rb

@@ -115,6 +115,7 @@ module OCI
     #   pagination, see [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #
     # @return [Response] A Response object with data of type {OCI::Loggingsearch::Models::SearchResponse SearchResponse}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/loggingsearch/search_logs.rb.html) to see an example of how to use search_logs API.
     def search_logs(search_logs_details, opts = {})
       logger.debug 'Calling operation LogSearchClient#search_logs.' if logger
 

data/lib/oci/management_agent/management_agent.rb

@@ -12,6 +12,8 @@ end
 
 # Require models
 require 'oci/management_agent/models/action_types'
+require 'oci/management_agent/models/availability_history_summary'
+require 'oci/management_agent/models/availability_status'
 require 'oci/management_agent/models/create_management_agent_install_key_details'
 require 'oci/management_agent/models/datatypes'
 require 'oci/management_agent/models/deploy_plugins_details'

data/lib/oci/management_agent/management_agent_client.rb

@@ -112,6 +112,7 @@ module OCI
     #
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type {OCI::ManagementAgent::Models::ManagementAgentInstallKey ManagementAgentInstallKey}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/create_management_agent_install_key.rb.html) to see an example of how to use create_management_agent_install_key API.
     def create_management_agent_install_key(create_management_agent_install_key_details, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#create_management_agent_install_key.' if logger
 
@@ -172,6 +173,7 @@ module OCI
     #
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @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/managementagent/delete_management_agent.rb.html) to see an example of how to use delete_management_agent API.
     def delete_management_agent(management_agent_id, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#delete_management_agent.' if logger
 
@@ -231,6 +233,7 @@ module OCI
     #
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @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/managementagent/delete_management_agent_install_key.rb.html) to see an example of how to use delete_management_agent_install_key API.
     def delete_management_agent_install_key(management_agent_install_key_id, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#delete_management_agent_install_key.' if logger
 
@@ -290,6 +293,7 @@ module OCI
     #   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/managementagent/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 ManagementAgentClient#delete_work_request.' if logger
 
@@ -350,6 +354,7 @@ module OCI
     #
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @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/managementagent/deploy_plugins.rb.html) to see an example of how to use deploy_plugins API.
     def deploy_plugins(deploy_plugins_details, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#deploy_plugins.' if logger
 
@@ -403,6 +408,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.
     # @return [Response] A Response object with data of type {OCI::ManagementAgent::Models::ManagementAgent ManagementAgent}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/get_management_agent.rb.html) to see an example of how to use get_management_agent API.
     def get_management_agent(management_agent_id, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#get_management_agent.' if logger
 
@@ -456,6 +462,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.
     # @return [Response] A Response object with data of type {OCI::ManagementAgent::Models::ManagementAgentInstallKey ManagementAgentInstallKey}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/get_management_agent_install_key.rb.html) to see an example of how to use get_management_agent_install_key API.
     def get_management_agent_install_key(management_agent_install_key_id, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#get_management_agent_install_key.' if logger
 
@@ -513,6 +520,7 @@ module OCI
     # @option opts [String, IO] :response_target Streaming http body into a file (specified by file name or File object) or IO object if the block is not given
     # @option [Block] &block Streaming http body to the block
     # @return [Response] A Response object with data of type String if response_target and block are not given, otherwise with nil data
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/get_management_agent_install_key_content.rb.html) to see an example of how to use get_management_agent_install_key_content API.
     def get_management_agent_install_key_content(management_agent_install_key_id, opts = {}, &block)
       logger.debug 'Calling operation ManagementAgentClient#get_management_agent_install_key_content.' if logger
 
@@ -611,6 +619,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.
     # @return [Response] A Response object with data of type {OCI::ManagementAgent::Models::WorkRequest WorkRequest}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/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 ManagementAgentClient#get_work_request.' if logger
 
@@ -657,6 +666,89 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
+    # Lists the availability history records of Management Agent
+    # @param [String] management_agent_id Unique Management Agent identifier
+    # @param [Hash] opts the optional parameters
+    # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
+    #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
+    # @option opts [String] :opc_request_id The client request ID for tracing.
+    # @option opts [DateTime] :time_availability_status_ended_greater_than Filter to limit the availability history results to that of time after the input time including the boundary record.
+    #   Defaulted to current date minus one year.
+    #   The date and time to be given as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
+    #
+    # @option opts [DateTime] :time_availability_status_started_less_than Filter to limit the availability history results to that of time before the input time including the boundary record
+    #   Defaulted to current date.
+    #   The date and time to be given as described in [RFC 3339](https://tools.ietf.org/rfc/rfc3339), section 14.29.
+    #
+    # @option opts [Integer] :limit The maximum number of items to return. (default to 10)
+    # @option opts [String] :page The page token representing the page at which to start retrieving results. This is usually retrieved from a previous list call.
+    # @option opts [String] :sort_order The sort order to use, either 'asc' or 'desc'. (default to DESC)
+    #   Allowed values are: ASC, DESC
+    # @option opts [String] :sort_by The field to sort by. Default order for timeAvailabilityStatusStarted is descending.
+    #    (default to timeAvailabilityStatusStarted)
+    #   Allowed values are: timeAvailabilityStatusStarted
+    # @return [Response] A Response object with data of type Array<{OCI::ManagementAgent::Models::AvailabilityHistorySummary AvailabilityHistorySummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/list_availability_histories.rb.html) to see an example of how to use list_availability_histories API.
+    def list_availability_histories(management_agent_id, opts = {})
+      logger.debug 'Calling operation ManagementAgentClient#list_availability_histories.' if logger
+
+      raise "Missing the required parameter 'management_agent_id' when calling list_availability_histories." if management_agent_id.nil?
+
+      if opts[:sort_order] && !%w[ASC DESC].include?(opts[:sort_order])
+        raise 'Invalid value for "sort_order", must be one of ASC, DESC.'
+      end
+
+      if opts[:sort_by] && !%w[timeAvailabilityStatusStarted].include?(opts[:sort_by])
+        raise 'Invalid value for "sort_by", must be one of timeAvailabilityStatusStarted.'
+      end
+      raise "Parameter value for 'management_agent_id' must not be blank" if OCI::Internal::Util.blank_string?(management_agent_id)
+
+      path = '/managementAgents/{managementAgentId}/availabilityHistories'.sub('{managementAgentId}', management_agent_id.to_s)
+      operation_signing_strategy = :standard
+
+      # rubocop:disable Style/NegatedIf
+      # Query Params
+      query_params = {}
+      query_params[:timeAvailabilityStatusEndedGreaterThan] = opts[:time_availability_status_ended_greater_than] if opts[:time_availability_status_ended_greater_than]
+      query_params[:timeAvailabilityStatusStartedLessThan] = opts[:time_availability_status_started_less_than] if opts[:time_availability_status_started_less_than]
+      query_params[:limit] = opts[:limit] if opts[:limit]
+      query_params[:page] = opts[:page] if opts[:page]
+      query_params[:sortOrder] = opts[:sort_order] if opts[:sort_order]
+      query_params[:sortBy] = opts[:sort_by] if opts[:sort_by]
+
+      # Header Params
+      header_params = {}
+      header_params[:accept] = 'application/json'
+      header_params[:'content-type'] = 'application/json'
+      header_params[:'opc-request-id'] = opts[:opc_request_id] if opts[:opc_request_id]
+      # rubocop:enable Style/NegatedIf
+
+      post_body = nil
+
+      # rubocop:disable Metrics/BlockLength
+      OCI::Retry.make_retrying_call(applicable_retry_config(opts), call_name: 'ManagementAgentClient#list_availability_histories') do
+        @api_client.call_api(
+          :GET,
+          path,
+          endpoint,
+          header_params: header_params,
+          query_params: query_params,
+          operation_signing_strategy: operation_signing_strategy,
+          body: post_body,
+          return_type: 'Array<OCI::ManagementAgent::Models::AvailabilityHistorySummary>'
+        )
+      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
+
+
     # Get supported agent image information
     #
     # @param [String] compartment_id The ID of the compartment from which the Management Agents to be listed.
@@ -680,6 +772,7 @@ module OCI
     # @option opts [String] :name A filter to return only resources that match the entire platform name given.
     # @option opts [String] :lifecycle_state Filter to return only Management Agents in the particular lifecycle state.
     # @return [Response] A Response object with data of type Array<{OCI::ManagementAgent::Models::ManagementAgentImageSummary ManagementAgentImageSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/list_management_agent_images.rb.html) to see an example of how to use list_management_agent_images API.
     def list_management_agent_images(compartment_id, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#list_management_agent_images.' if logger
 
@@ -764,6 +857,7 @@ module OCI
     #   Allowed values are: timeCreated, displayName
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type Array<{OCI::ManagementAgent::Models::ManagementAgentInstallKeySummary ManagementAgentInstallKeySummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/list_management_agent_install_keys.rb.html) to see an example of how to use list_management_agent_install_keys API.
     def list_management_agent_install_keys(compartment_id, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#list_management_agent_install_keys.' if logger
 
@@ -846,6 +940,7 @@ module OCI
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @option opts [String] :lifecycle_state Filter to return only Management Agents in the particular lifecycle state.
     # @return [Response] A Response object with data of type Array<{OCI::ManagementAgent::Models::ManagementAgentPluginSummary ManagementAgentPluginSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/list_management_agent_plugins.rb.html) to see an example of how to use list_management_agent_plugins API.
     def list_management_agent_plugins(compartment_id, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#list_management_agent_plugins.' if logger
 
@@ -930,6 +1025,7 @@ module OCI
     #   Allowed values are: timeCreated, displayName
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @return [Response] A Response object with data of type Array<{OCI::ManagementAgent::Models::ManagementAgentSummary ManagementAgentSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/list_management_agents.rb.html) to see an example of how to use list_management_agents API.
     def list_management_agents(compartment_id, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#list_management_agents.' if logger
 
@@ -1016,6 +1112,7 @@ module OCI
     #    (default to timestamp)
     #   Allowed values are: timestamp
     # @return [Response] A Response object with data of type Array<{OCI::ManagementAgent::Models::WorkRequestError WorkRequestError}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/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 ManagementAgentClient#list_work_request_errors.' if logger
 
@@ -1089,6 +1186,7 @@ module OCI
     #    (default to timestamp)
     #   Allowed values are: timestamp
     # @return [Response] A Response object with data of type Array<{OCI::ManagementAgent::Models::WorkRequestLogEntry WorkRequestLogEntry}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/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 ManagementAgentClient#list_work_request_logs.' if logger
 
@@ -1168,6 +1266,7 @@ module OCI
     #    (default to timeAccepted)
     #   Allowed values are: timeAccepted
     # @return [Response] A Response object with data of type Array<{OCI::ManagementAgent::Models::WorkRequestSummary WorkRequestSummary}>
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/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 ManagementAgentClient#list_work_requests.' if logger
 
@@ -1254,6 +1353,7 @@ module OCI
     #   provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::ManagementAgent::Models::ManagementAgent ManagementAgent}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/update_management_agent.rb.html) to see an example of how to use update_management_agent API.
     def update_management_agent(management_agent_id, update_management_agent_details, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#update_management_agent.' if logger
 
@@ -1325,6 +1425,7 @@ module OCI
     #   provide matches the resource's current etag value.
     #
     # @return [Response] A Response object with data of type {OCI::ManagementAgent::Models::ManagementAgentInstallKey ManagementAgentInstallKey}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementagent/update_management_agent_install_key.rb.html) to see an example of how to use update_management_agent_install_key API.
     def update_management_agent_install_key(management_agent_install_key_id, update_management_agent_install_key_details, opts = {})
       logger.debug 'Calling operation ManagementAgentClient#update_management_agent_install_key.' if logger