oci 2.11.0 → 2.12.0

data/lib/oci/management_agent/models/availability_history_summary.rb

@@ -0,0 +1,217 @@
+# Copyright (c) 2016, 2020, Oracle and/or its affiliates.  All rights reserved.
+# This software is dual-licensed to you under the Universal Permissive License (UPL) 1.0 as shown at https://oss.oracle.com/licenses/upl or Apache License 2.0 as shown at http://www.apache.org/licenses/LICENSE-2.0. You may choose either license.
+
+require 'date'
+require 'logger'
+
+# rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
+module OCI
+  # Availability history of Management Agent.
+  class ManagementAgent::Models::AvailabilityHistorySummary
+    AVAILABILITY_STATUS_ENUM = [
+      AVAILABILITY_STATUS_ACTIVE = 'ACTIVE'.freeze,
+      AVAILABILITY_STATUS_SILENT = 'SILENT'.freeze,
+      AVAILABILITY_STATUS_NOT_AVAILABLE = 'NOT_AVAILABLE'.freeze,
+      AVAILABILITY_STATUS_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
+    # **[Required]** agent identifier
+    # @return [String]
+    attr_accessor :management_agent_id
+
+    # **[Required]** The availability status of managementAgent
+    # @return [String]
+    attr_reader :availability_status
+
+    # The time at which the Management Agent moved to the availability status. An RFC3339 formatted datetime string
+    # @return [DateTime]
+    attr_accessor :time_availability_status_started
+
+    # The time till which the Management Agent was known to be in the availability status. An RFC3339 formatted datetime string
+    # @return [DateTime]
+    attr_accessor :time_availability_status_ended
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'management_agent_id': :'managementAgentId',
+        'availability_status': :'availabilityStatus',
+        'time_availability_status_started': :'timeAvailabilityStatusStarted',
+        'time_availability_status_ended': :'timeAvailabilityStatusEnded'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'management_agent_id': :'String',
+        'availability_status': :'String',
+        'time_availability_status_started': :'DateTime',
+        'time_availability_status_ended': :'DateTime'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:disable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+
+    # Initializes the object
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @option attributes [String] :management_agent_id The value to assign to the {#management_agent_id} property
+    # @option attributes [String] :availability_status The value to assign to the {#availability_status} property
+    # @option attributes [DateTime] :time_availability_status_started The value to assign to the {#time_availability_status_started} property
+    # @option attributes [DateTime] :time_availability_status_ended The value to assign to the {#time_availability_status_ended} property
+    def initialize(attributes = {})
+      return unless attributes.is_a?(Hash)
+
+      # convert string to symbol for hash key
+      attributes = attributes.each_with_object({}) { |(k, v), h| h[k.to_sym] = v }
+
+      self.management_agent_id = attributes[:'managementAgentId'] if attributes[:'managementAgentId']
+
+      raise 'You cannot provide both :managementAgentId and :management_agent_id' if attributes.key?(:'managementAgentId') && attributes.key?(:'management_agent_id')
+
+      self.management_agent_id = attributes[:'management_agent_id'] if attributes[:'management_agent_id']
+
+      self.availability_status = attributes[:'availabilityStatus'] if attributes[:'availabilityStatus']
+
+      raise 'You cannot provide both :availabilityStatus and :availability_status' if attributes.key?(:'availabilityStatus') && attributes.key?(:'availability_status')
+
+      self.availability_status = attributes[:'availability_status'] if attributes[:'availability_status']
+
+      self.time_availability_status_started = attributes[:'timeAvailabilityStatusStarted'] if attributes[:'timeAvailabilityStatusStarted']
+
+      raise 'You cannot provide both :timeAvailabilityStatusStarted and :time_availability_status_started' if attributes.key?(:'timeAvailabilityStatusStarted') && attributes.key?(:'time_availability_status_started')
+
+      self.time_availability_status_started = attributes[:'time_availability_status_started'] if attributes[:'time_availability_status_started']
+
+      self.time_availability_status_ended = attributes[:'timeAvailabilityStatusEnded'] if attributes[:'timeAvailabilityStatusEnded']
+
+      raise 'You cannot provide both :timeAvailabilityStatusEnded and :time_availability_status_ended' if attributes.key?(:'timeAvailabilityStatusEnded') && attributes.key?(:'time_availability_status_ended')
+
+      self.time_availability_status_ended = attributes[:'time_availability_status_ended'] if attributes[:'time_availability_status_ended']
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
+    # rubocop:enable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] availability_status Object to be assigned
+    def availability_status=(availability_status)
+      # rubocop:disable Style/ConditionalAssignment
+      if availability_status && !AVAILABILITY_STATUS_ENUM.include?(availability_status)
+        OCI.logger.debug("Unknown value for 'availability_status' [" + availability_status + "]. Mapping to 'AVAILABILITY_STATUS_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @availability_status = AVAILABILITY_STATUS_UNKNOWN_ENUM_VALUE
+      else
+        @availability_status = availability_status
+      end
+      # rubocop:enable Style/ConditionalAssignment
+    end
+
+    # rubocop:disable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+
+    # Checks equality by comparing each attribute.
+    # @param [Object] other the other object to be compared
+    def ==(other)
+      return true if equal?(other)
+
+      self.class == other.class &&
+        management_agent_id == other.management_agent_id &&
+        availability_status == other.availability_status &&
+        time_availability_status_started == other.time_availability_status_started &&
+        time_availability_status_ended == other.time_availability_status_ended
+    end
+    # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
+
+    # @see the `==` method
+    # @param [Object] other the other object to be compared
+    def eql?(other)
+      self == other
+    end
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # Calculates hash code according to all attributes.
+    # @return [Fixnum] Hash code
+    def hash
+      [management_agent_id, availability_status, time_availability_status_started, time_availability_status_ended].hash
+    end
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # rubocop:disable Metrics/AbcSize, Layout/EmptyLines
+
+
+    # Builds the object from hash
+    # @param [Hash] attributes Model attributes in the form of hash
+    # @return [Object] Returns the model itself
+    def build_from_hash(attributes)
+      return nil unless attributes.is_a?(Hash)
+
+      self.class.swagger_types.each_pair do |key, type|
+        if type =~ /^Array<(.*)>/i
+          # check to ensure the input is an array given that the the attribute
+          # is documented as an array but the input is not
+          if attributes[self.class.attribute_map[key]].is_a?(Array)
+            public_method("#{key}=").call(
+              attributes[self.class.attribute_map[key]]
+                .map { |v| OCI::Internal::Util.convert_to_type(Regexp.last_match(1), v) }
+            )
+          end
+        elsif !attributes[self.class.attribute_map[key]].nil?
+          public_method("#{key}=").call(
+            OCI::Internal::Util.convert_to_type(type, attributes[self.class.attribute_map[key]])
+          )
+        end
+        # or else data not found in attributes(hash), not an issue as the data can be optional
+      end
+
+      self
+    end
+    # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
+
+    # Returns the string representation of the object
+    # @return [String] String presentation of the object
+    def to_s
+      to_hash.to_s
+    end
+
+    # Returns the object in the form of hash
+    # @return [Hash] Returns the object in the form of hash
+    def to_hash
+      hash = {}
+      self.class.attribute_map.each_pair do |attr, param|
+        value = public_method(attr).call
+        next if value.nil? && !instance_variable_defined?("@#{attr}")
+
+        hash[param] = _to_hash(value)
+      end
+      hash
+    end
+
+    private
+
+    # Outputs non-array value in the form of hash
+    # For object, use to_hash. Otherwise, just return the value
+    # @param [Object] value Any valid value
+    # @return [Hash] Returns the value in the form of hash
+    def _to_hash(value)
+      if value.is_a?(Array)
+        value.compact.map { |v| _to_hash(v) }
+      elsif value.is_a?(Hash)
+        {}.tap do |hash|
+          value.each { |k, v| hash[k] = _to_hash(v) }
+        end
+      elsif value.respond_to? :to_hash
+        value.to_hash
+      else
+        value
+      end
+    end
+  end
+end
+# rubocop:enable Lint/UnneededCopDisableDirective, Metrics/LineLength

data/lib/oci/management_agent/models/availability_status.rb

@@ -0,0 +1,12 @@
+# 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 ManagementAgent::Models
+    AVAILABILITY_STATUS_ENUM = [
+      AVAILABILITY_STATUS_ACTIVE = 'ACTIVE'.freeze,
+      AVAILABILITY_STATUS_SILENT = 'SILENT'.freeze,
+      AVAILABILITY_STATUS_NOT_AVAILABLE = 'NOT_AVAILABLE'.freeze
+    ].freeze
+  end
+end

data/lib/oci/management_agent/models/management_agent.rb

@@ -14,6 +14,13 @@ module OCI
       PLATFORM_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
+    AVAILABILITY_STATUS_ENUM = [
+      AVAILABILITY_STATUS_ACTIVE = 'ACTIVE'.freeze,
+      AVAILABILITY_STATUS_SILENT = 'SILENT'.freeze,
+      AVAILABILITY_STATUS_NOT_AVAILABLE = 'NOT_AVAILABLE'.freeze,
+      AVAILABILITY_STATUS_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_CREATING = 'CREATING'.freeze,
       LIFECYCLE_STATE_UPDATING = 'UPDATING'.freeze,
@@ -86,6 +93,10 @@ module OCI
     # @return [DateTime]
     attr_accessor :time_last_heartbeat
 
+    # The current availability status of managementAgent
+    # @return [String]
+    attr_reader :availability_status
+
     # The current state of managementAgent
     # @return [String]
     attr_reader :lifecycle_state
@@ -125,6 +136,7 @@ module OCI
         'time_created': :'timeCreated',
         'time_updated': :'timeUpdated',
         'time_last_heartbeat': :'timeLastHeartbeat',
+        'availability_status': :'availabilityStatus',
         'lifecycle_state': :'lifecycleState',
         'lifecycle_details': :'lifecycleDetails',
         'freeform_tags': :'freeformTags',
@@ -152,6 +164,7 @@ module OCI
         'time_created': :'DateTime',
         'time_updated': :'DateTime',
         'time_last_heartbeat': :'DateTime',
+        'availability_status': :'String',
         'lifecycle_state': :'String',
         'lifecycle_details': :'String',
         'freeform_tags': :'Hash<String, String>',
@@ -181,6 +194,7 @@ module OCI
     # @option attributes [DateTime] :time_created The value to assign to the {#time_created} property
     # @option attributes [DateTime] :time_updated The value to assign to the {#time_updated} property
     # @option attributes [DateTime] :time_last_heartbeat The value to assign to the {#time_last_heartbeat} property
+    # @option attributes [String] :availability_status The value to assign to the {#availability_status} property
     # @option attributes [String] :lifecycle_state The value to assign to the {#lifecycle_state} property
     # @option attributes [String] :lifecycle_details The value to assign to the {#lifecycle_details} property
     # @option attributes [Hash<String, String>] :freeform_tags The value to assign to the {#freeform_tags} property
@@ -269,6 +283,12 @@ module OCI
 
       self.time_last_heartbeat = attributes[:'time_last_heartbeat'] if attributes[:'time_last_heartbeat']
 
+      self.availability_status = attributes[:'availabilityStatus'] if attributes[:'availabilityStatus']
+
+      raise 'You cannot provide both :availabilityStatus and :availability_status' if attributes.key?(:'availabilityStatus') && attributes.key?(:'availability_status')
+
+      self.availability_status = attributes[:'availability_status'] if attributes[:'availability_status']
+
       self.lifecycle_state = attributes[:'lifecycleState'] if attributes[:'lifecycleState']
 
       raise 'You cannot provide both :lifecycleState and :lifecycle_state' if attributes.key?(:'lifecycleState') && attributes.key?(:'lifecycle_state')
@@ -309,6 +329,19 @@ module OCI
       # rubocop:enable Style/ConditionalAssignment
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] availability_status Object to be assigned
+    def availability_status=(availability_status)
+      # rubocop:disable Style/ConditionalAssignment
+      if availability_status && !AVAILABILITY_STATUS_ENUM.include?(availability_status)
+        OCI.logger.debug("Unknown value for 'availability_status' [" + availability_status + "]. Mapping to 'AVAILABILITY_STATUS_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @availability_status = AVAILABILITY_STATUS_UNKNOWN_ENUM_VALUE
+      else
+        @availability_status = availability_status
+      end
+      # rubocop:enable Style/ConditionalAssignment
+    end
+
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] lifecycle_state Object to be assigned
     def lifecycle_state=(lifecycle_state)
@@ -346,6 +379,7 @@ module OCI
         time_created == other.time_created &&
         time_updated == other.time_updated &&
         time_last_heartbeat == other.time_last_heartbeat &&
+        availability_status == other.availability_status &&
         lifecycle_state == other.lifecycle_state &&
         lifecycle_details == other.lifecycle_details &&
         freeform_tags == other.freeform_tags &&
@@ -365,7 +399,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [id, install_key_id, display_name, platform_type, platform_name, platform_version, version, host, install_path, plugin_list, compartment_id, is_agent_auto_upgradable, time_created, time_updated, time_last_heartbeat, lifecycle_state, lifecycle_details, freeform_tags, defined_tags].hash
+      [id, install_key_id, display_name, platform_type, platform_name, platform_version, version, host, install_path, plugin_list, compartment_id, is_agent_auto_upgradable, time_created, time_updated, time_last_heartbeat, availability_status, lifecycle_state, lifecycle_details, freeform_tags, defined_tags].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/management_agent/models/management_agent_summary.rb

@@ -14,6 +14,13 @@ module OCI
       PLATFORM_TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
+    AVAILABILITY_STATUS_ENUM = [
+      AVAILABILITY_STATUS_ACTIVE = 'ACTIVE'.freeze,
+      AVAILABILITY_STATUS_SILENT = 'SILENT'.freeze,
+      AVAILABILITY_STATUS_NOT_AVAILABLE = 'NOT_AVAILABLE'.freeze,
+      AVAILABILITY_STATUS_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_CREATING = 'CREATING'.freeze,
       LIFECYCLE_STATE_UPDATING = 'UPDATING'.freeze,
@@ -74,6 +81,14 @@ module OCI
     # @return [String]
     attr_accessor :compartment_id
 
+    # The time the Management Agent has last recorded its heartbeat. An RFC3339 formatted datetime string
+    # @return [DateTime]
+    attr_accessor :time_last_heartbeat
+
+    # The current availability status of managementAgent
+    # @return [String]
+    attr_reader :availability_status
+
     # The current state of managementAgent
     # @return [String]
     attr_reader :lifecycle_state
@@ -110,6 +125,8 @@ module OCI
         'host': :'host',
         'plugin_list': :'pluginList',
         'compartment_id': :'compartmentId',
+        'time_last_heartbeat': :'timeLastHeartbeat',
+        'availability_status': :'availabilityStatus',
         'lifecycle_state': :'lifecycleState',
         'lifecycle_details': :'lifecycleDetails',
         'freeform_tags': :'freeformTags',
@@ -134,6 +151,8 @@ module OCI
         'host': :'String',
         'plugin_list': :'Array<OCI::ManagementAgent::Models::ManagementAgentPluginDetails>',
         'compartment_id': :'String',
+        'time_last_heartbeat': :'DateTime',
+        'availability_status': :'String',
         'lifecycle_state': :'String',
         'lifecycle_details': :'String',
         'freeform_tags': :'Hash<String, String>',
@@ -160,6 +179,8 @@ module OCI
     # @option attributes [String] :host The value to assign to the {#host} property
     # @option attributes [Array<OCI::ManagementAgent::Models::ManagementAgentPluginDetails>] :plugin_list The value to assign to the {#plugin_list} property
     # @option attributes [String] :compartment_id The value to assign to the {#compartment_id} property
+    # @option attributes [DateTime] :time_last_heartbeat The value to assign to the {#time_last_heartbeat} property
+    # @option attributes [String] :availability_status The value to assign to the {#availability_status} property
     # @option attributes [String] :lifecycle_state The value to assign to the {#lifecycle_state} property
     # @option attributes [String] :lifecycle_details The value to assign to the {#lifecycle_details} property
     # @option attributes [Hash<String, String>] :freeform_tags The value to assign to the {#freeform_tags} property
@@ -230,6 +251,18 @@ module OCI
 
       self.compartment_id = attributes[:'compartment_id'] if attributes[:'compartment_id']
 
+      self.time_last_heartbeat = attributes[:'timeLastHeartbeat'] if attributes[:'timeLastHeartbeat']
+
+      raise 'You cannot provide both :timeLastHeartbeat and :time_last_heartbeat' if attributes.key?(:'timeLastHeartbeat') && attributes.key?(:'time_last_heartbeat')
+
+      self.time_last_heartbeat = attributes[:'time_last_heartbeat'] if attributes[:'time_last_heartbeat']
+
+      self.availability_status = attributes[:'availabilityStatus'] if attributes[:'availabilityStatus']
+
+      raise 'You cannot provide both :availabilityStatus and :availability_status' if attributes.key?(:'availabilityStatus') && attributes.key?(:'availability_status')
+
+      self.availability_status = attributes[:'availability_status'] if attributes[:'availability_status']
+
       self.lifecycle_state = attributes[:'lifecycleState'] if attributes[:'lifecycleState']
 
       raise 'You cannot provide both :lifecycleState and :lifecycle_state' if attributes.key?(:'lifecycleState') && attributes.key?(:'lifecycle_state')
@@ -270,6 +303,19 @@ module OCI
       # rubocop:enable Style/ConditionalAssignment
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] availability_status Object to be assigned
+    def availability_status=(availability_status)
+      # rubocop:disable Style/ConditionalAssignment
+      if availability_status && !AVAILABILITY_STATUS_ENUM.include?(availability_status)
+        OCI.logger.debug("Unknown value for 'availability_status' [" + availability_status + "]. Mapping to 'AVAILABILITY_STATUS_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @availability_status = AVAILABILITY_STATUS_UNKNOWN_ENUM_VALUE
+      else
+        @availability_status = availability_status
+      end
+      # rubocop:enable Style/ConditionalAssignment
+    end
+
     # Custom attribute writer method checking allowed values (enum).
     # @param [Object] lifecycle_state Object to be assigned
     def lifecycle_state=(lifecycle_state)
@@ -304,6 +350,8 @@ module OCI
         host == other.host &&
         plugin_list == other.plugin_list &&
         compartment_id == other.compartment_id &&
+        time_last_heartbeat == other.time_last_heartbeat &&
+        availability_status == other.availability_status &&
         lifecycle_state == other.lifecycle_state &&
         lifecycle_details == other.lifecycle_details &&
         freeform_tags == other.freeform_tags &&
@@ -323,7 +371,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [id, install_key_id, display_name, platform_type, platform_name, platform_version, version, is_agent_auto_upgradable, time_created, host, plugin_list, compartment_id, lifecycle_state, lifecycle_details, freeform_tags, defined_tags].hash
+      [id, install_key_id, display_name, platform_type, platform_name, platform_version, version, is_agent_auto_upgradable, time_created, host, plugin_list, compartment_id, time_last_heartbeat, availability_status, lifecycle_state, lifecycle_details, freeform_tags, defined_tags].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/management_dashboard/dashx_apis_client.rb

@@ -120,6 +120,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/managementdashboard/change_management_dashboards_compartment.rb.html) to see an example of how to use change_management_dashboards_compartment API.
     def change_management_dashboards_compartment(management_dashboard_id, change_management_dashboards_compartment_details, opts = {})
       logger.debug 'Calling operation DashxApisClient#change_management_dashboards_compartment.' if logger
 
@@ -190,6 +191,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/managementdashboard/change_management_saved_searches_compartment.rb.html) to see an example of how to use change_management_saved_searches_compartment API.
     def change_management_saved_searches_compartment(management_saved_search_id, change_management_saved_searches_compartment_details, opts = {})
       logger.debug 'Calling operation DashxApisClient#change_management_saved_searches_compartment.' if logger
 
@@ -253,6 +255,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::ManagementDashboard::Models::ManagementDashboard ManagementDashboard}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementdashboard/create_management_dashboard.rb.html) to see an example of how to use create_management_dashboard API.
     def create_management_dashboard(create_management_dashboard_details, opts = {})
       logger.debug 'Calling operation DashxApisClient#create_management_dashboard.' if logger
 
@@ -314,6 +317,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::ManagementDashboard::Models::ManagementSavedSearch ManagementSavedSearch}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementdashboard/create_management_saved_search.rb.html) to see an example of how to use create_management_saved_search API.
     def create_management_saved_search(create_management_saved_search_details, opts = {})
       logger.debug 'Calling operation DashxApisClient#create_management_saved_search.' if logger
 
@@ -374,6 +378,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/managementdashboard/delete_management_dashboard.rb.html) to see an example of how to use delete_management_dashboard API.
     def delete_management_dashboard(management_dashboard_id, opts = {})
       logger.debug 'Calling operation DashxApisClient#delete_management_dashboard.' if logger
 
@@ -433,6 +438,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/managementdashboard/delete_management_saved_search.rb.html) to see an example of how to use delete_management_saved_search API.
     def delete_management_saved_search(management_saved_search_id, opts = {})
       logger.debug 'Calling operation DashxApisClient#delete_management_saved_search.' if logger
 
@@ -492,6 +498,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::ManagementDashboard::Models::ManagementDashboardExportDetails ManagementDashboardExportDetails}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementdashboard/export_dashboard.rb.html) to see an example of how to use export_dashboard API.
     def export_dashboard(export_dashboard_id, opts = {})
       logger.debug 'Calling operation DashxApisClient#export_dashboard.' if logger
 
@@ -553,6 +560,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::ManagementDashboard::Models::ManagementDashboard ManagementDashboard}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementdashboard/get_management_dashboard.rb.html) to see an example of how to use get_management_dashboard API.
     def get_management_dashboard(management_dashboard_id, opts = {})
       logger.debug 'Calling operation DashxApisClient#get_management_dashboard.' if logger
 
@@ -614,6 +622,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::ManagementDashboard::Models::ManagementSavedSearch ManagementSavedSearch}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementdashboard/get_management_saved_search.rb.html) to see an example of how to use get_management_saved_search API.
     def get_management_saved_search(management_saved_search_id, opts = {})
       logger.debug 'Calling operation DashxApisClient#get_management_saved_search.' if logger
 
@@ -682,6 +691,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/managementdashboard/import_dashboard.rb.html) to see an example of how to use import_dashboard API.
     def import_dashboard(management_dashboard_import_details, opts = {})
       logger.debug 'Calling operation DashxApisClient#import_dashboard.' if logger
 
@@ -743,6 +753,7 @@ module OCI
     #    (default to timeCreated)
     #   Allowed values are: timeCreated, displayName
     # @return [Response] A Response object with data of type {OCI::ManagementDashboard::Models::ManagementDashboardCollection ManagementDashboardCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementdashboard/list_management_dashboards.rb.html) to see an example of how to use list_management_dashboards API.
     def list_management_dashboards(compartment_id, opts = {})
       logger.debug 'Calling operation DashxApisClient#list_management_dashboards.' if logger
 
@@ -816,6 +827,7 @@ module OCI
     #    (default to timeCreated)
     #   Allowed values are: timeCreated, displayName
     # @return [Response] A Response object with data of type {OCI::ManagementDashboard::Models::ManagementSavedSearchCollection ManagementSavedSearchCollection}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementdashboard/list_management_saved_searches.rb.html) to see an example of how to use list_management_saved_searches API.
     def list_management_saved_searches(compartment_id, opts = {})
       logger.debug 'Calling operation DashxApisClient#list_management_saved_searches.' if logger
 
@@ -896,6 +908,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::ManagementDashboard::Models::ManagementDashboard ManagementDashboard}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementdashboard/update_management_dashboard.rb.html) to see an example of how to use update_management_dashboard API.
     def update_management_dashboard(management_dashboard_id, update_management_dashboard_details, opts = {})
       logger.debug 'Calling operation DashxApisClient#update_management_dashboard.' if logger
 
@@ -967,6 +980,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::ManagementDashboard::Models::ManagementSavedSearch ManagementSavedSearch}
+    # @note Click [here](https://docs.cloud.oracle.com/en-us/iaas/tools/ruby-sdk-examples/latest/managementdashboard/update_management_saved_search.rb.html) to see an example of how to use update_management_saved_search API.
     def update_management_saved_search(management_saved_search_id, update_management_saved_search_details, opts = {})
       logger.debug 'Calling operation DashxApisClient#update_management_saved_search.' if logger