oci 2.14.0 → 2.15.0

data/lib/oci/log_analytics/models/scheduled_task.rb

@@ -32,6 +32,16 @@ module OCI
       TASK_STATUS_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
+    PAUSE_REASON_ENUM = [
+      PAUSE_REASON_METRIC_EXTRACTION_NOT_VALID = 'METRIC_EXTRACTION_NOT_VALID'.freeze,
+      PAUSE_REASON_SAVED_SEARCH_NOT_VALID = 'SAVED_SEARCH_NOT_VALID'.freeze,
+      PAUSE_REASON_SAVED_SEARCH_NOT_FOUND = 'SAVED_SEARCH_NOT_FOUND'.freeze,
+      PAUSE_REASON_QUERY_STRING_NOT_VALID = 'QUERY_STRING_NOT_VALID'.freeze,
+      PAUSE_REASON_USER_ACTION = 'USER_ACTION'.freeze,
+      PAUSE_REASON_TENANCY_LIFECYCLE = 'TENANCY_LIFECYCLE'.freeze,
+      PAUSE_REASON_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
+    ].freeze
+
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_ACTIVE = 'ACTIVE'.freeze,
       LIFECYCLE_STATE_DELETED = 'DELETED'.freeze,
@@ -71,6 +81,10 @@ module OCI
     # @return [String]
     attr_reader :task_status
 
+    # reason for taskStatus PAUSED.
+    # @return [String]
+    attr_reader :pause_reason
+
     # most recent Work Request Identifier [OCID] (https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) for the asynchronous request.
     # @return [String]
     attr_accessor :work_request_id
@@ -93,6 +107,12 @@ module OCI
     # @return [DateTime]
     attr_accessor :time_updated
 
+    # The date and time the scheduled task will execute next,
+    # in the format defined by RFC3339.
+    #
+    # @return [DateTime]
+    attr_accessor :time_of_next_execution
+
     # **[Required]** The current state of the scheduled task.
     # @return [String]
     attr_reader :lifecycle_state
@@ -120,11 +140,13 @@ module OCI
         'schedules': :'schedules',
         'action': :'action',
         'task_status': :'taskStatus',
+        'pause_reason': :'pauseReason',
         'work_request_id': :'workRequestId',
         'num_occurrences': :'numOccurrences',
         'compartment_id': :'compartmentId',
         'time_created': :'timeCreated',
         'time_updated': :'timeUpdated',
+        'time_of_next_execution': :'timeOfNextExecution',
         'lifecycle_state': :'lifecycleState',
         'freeform_tags': :'freeformTags',
         'defined_tags': :'definedTags'
@@ -143,11 +165,13 @@ module OCI
         'schedules': :'Array<OCI::LogAnalytics::Models::Schedule>',
         'action': :'OCI::LogAnalytics::Models::Action',
         'task_status': :'String',
+        'pause_reason': :'String',
         'work_request_id': :'String',
         'num_occurrences': :'Integer',
         'compartment_id': :'String',
         'time_created': :'DateTime',
         'time_updated': :'DateTime',
+        'time_of_next_execution': :'DateTime',
         'lifecycle_state': :'String',
         'freeform_tags': :'Hash<String, String>',
         'defined_tags': :'Hash<String, Hash<String, Object>>'
@@ -183,11 +207,13 @@ module OCI
     # @option attributes [Array<OCI::LogAnalytics::Models::Schedule>] :schedules The value to assign to the {#schedules} property
     # @option attributes [OCI::LogAnalytics::Models::Action] :action The value to assign to the {#action} property
     # @option attributes [String] :task_status The value to assign to the {#task_status} property
+    # @option attributes [String] :pause_reason The value to assign to the {#pause_reason} property
     # @option attributes [String] :work_request_id The value to assign to the {#work_request_id} property
     # @option attributes [Integer] :num_occurrences The value to assign to the {#num_occurrences} property
     # @option attributes [String] :compartment_id The value to assign to the {#compartment_id} property
     # @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_of_next_execution The value to assign to the {#time_of_next_execution} property
     # @option attributes [String] :lifecycle_state The value to assign to the {#lifecycle_state} property
     # @option attributes [Hash<String, String>] :freeform_tags The value to assign to the {#freeform_tags} property
     # @option attributes [Hash<String, Hash<String, Object>>] :defined_tags The value to assign to the {#defined_tags} property
@@ -223,6 +249,12 @@ module OCI
 
       self.task_status = attributes[:'task_status'] if attributes[:'task_status']
 
+      self.pause_reason = attributes[:'pauseReason'] if attributes[:'pauseReason']
+
+      raise 'You cannot provide both :pauseReason and :pause_reason' if attributes.key?(:'pauseReason') && attributes.key?(:'pause_reason')
+
+      self.pause_reason = attributes[:'pause_reason'] if attributes[:'pause_reason']
+
       self.work_request_id = attributes[:'workRequestId'] if attributes[:'workRequestId']
 
       raise 'You cannot provide both :workRequestId and :work_request_id' if attributes.key?(:'workRequestId') && attributes.key?(:'work_request_id')
@@ -253,6 +285,12 @@ module OCI
 
       self.time_updated = attributes[:'time_updated'] if attributes[:'time_updated']
 
+      self.time_of_next_execution = attributes[:'timeOfNextExecution'] if attributes[:'timeOfNextExecution']
+
+      raise 'You cannot provide both :timeOfNextExecution and :time_of_next_execution' if attributes.key?(:'timeOfNextExecution') && attributes.key?(:'time_of_next_execution')
+
+      self.time_of_next_execution = attributes[:'time_of_next_execution'] if attributes[:'time_of_next_execution']
+
       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')
@@ -313,6 +351,19 @@ module OCI
       # rubocop:enable Style/ConditionalAssignment
     end
 
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] pause_reason Object to be assigned
+    def pause_reason=(pause_reason)
+      # rubocop:disable Style/ConditionalAssignment
+      if pause_reason && !PAUSE_REASON_ENUM.include?(pause_reason)
+        OCI.logger.debug("Unknown value for 'pause_reason' [" + pause_reason + "]. Mapping to 'PAUSE_REASON_UNKNOWN_ENUM_VALUE'") if OCI.logger
+        @pause_reason = PAUSE_REASON_UNKNOWN_ENUM_VALUE
+      else
+        @pause_reason = pause_reason
+      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)
@@ -342,11 +393,13 @@ module OCI
         schedules == other.schedules &&
         action == other.action &&
         task_status == other.task_status &&
+        pause_reason == other.pause_reason &&
         work_request_id == other.work_request_id &&
         num_occurrences == other.num_occurrences &&
         compartment_id == other.compartment_id &&
         time_created == other.time_created &&
         time_updated == other.time_updated &&
+        time_of_next_execution == other.time_of_next_execution &&
         lifecycle_state == other.lifecycle_state &&
         freeform_tags == other.freeform_tags &&
         defined_tags == other.defined_tags
@@ -365,7 +418,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [kind, id, display_name, task_type, schedules, action, task_status, work_request_id, num_occurrences, compartment_id, time_created, time_updated, lifecycle_state, freeform_tags, defined_tags].hash
+      [kind, id, display_name, task_type, schedules, action, task_status, pause_reason, work_request_id, num_occurrences, compartment_id, time_created, time_updated, time_of_next_execution, lifecycle_state, freeform_tags, defined_tags].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/log_analytics/models/scheduled_task_summary.rb

@@ -61,6 +61,10 @@ module OCI
     # @return [String]
     attr_reader :task_status
 
+    # reason for taskStatus PAUSED.
+    # @return [String]
+    attr_accessor :pause_reason
+
     # most recent Work Request Identifier [OCID] (https://docs.cloud.oracle.com/iaas/Content/General/Concepts/identifiers.htm) for the asynchronous request.
     # @return [String]
     attr_accessor :work_request_id
@@ -104,6 +108,7 @@ module OCI
         'time_updated': :'timeUpdated',
         'lifecycle_state': :'lifecycleState',
         'task_status': :'taskStatus',
+        'pause_reason': :'pauseReason',
         'work_request_id': :'workRequestId',
         'display_name': :'displayName',
         'freeform_tags': :'freeformTags',
@@ -125,6 +130,7 @@ module OCI
         'time_updated': :'DateTime',
         'lifecycle_state': :'String',
         'task_status': :'String',
+        'pause_reason': :'String',
         'work_request_id': :'String',
         'display_name': :'String',
         'freeform_tags': :'Hash<String, String>',
@@ -148,6 +154,7 @@ module OCI
     # @option attributes [DateTime] :time_updated The value to assign to the {#time_updated} property
     # @option attributes [String] :lifecycle_state The value to assign to the {#lifecycle_state} property
     # @option attributes [String] :task_status The value to assign to the {#task_status} property
+    # @option attributes [String] :pause_reason The value to assign to the {#pause_reason} property
     # @option attributes [String] :work_request_id The value to assign to the {#work_request_id} property
     # @option attributes [String] :display_name The value to assign to the {#display_name} property
     # @option attributes [Hash<String, String>] :freeform_tags The value to assign to the {#freeform_tags} property
@@ -198,6 +205,12 @@ module OCI
 
       self.task_status = attributes[:'task_status'] if attributes[:'task_status']
 
+      self.pause_reason = attributes[:'pauseReason'] if attributes[:'pauseReason']
+
+      raise 'You cannot provide both :pauseReason and :pause_reason' if attributes.key?(:'pauseReason') && attributes.key?(:'pause_reason')
+
+      self.pause_reason = attributes[:'pause_reason'] if attributes[:'pause_reason']
+
       self.work_request_id = attributes[:'workRequestId'] if attributes[:'workRequestId']
 
       raise 'You cannot provide both :workRequestId and :work_request_id' if attributes.key?(:'workRequestId') && attributes.key?(:'work_request_id')
@@ -292,6 +305,7 @@ module OCI
         time_updated == other.time_updated &&
         lifecycle_state == other.lifecycle_state &&
         task_status == other.task_status &&
+        pause_reason == other.pause_reason &&
         work_request_id == other.work_request_id &&
         display_name == other.display_name &&
         freeform_tags == other.freeform_tags &&
@@ -313,7 +327,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [id, task_type, compartment_id, time_created, time_updated, lifecycle_state, task_status, work_request_id, display_name, freeform_tags, defined_tags, last_execution_status, time_last_executed].hash
+      [id, task_type, compartment_id, time_created, time_updated, lifecycle_state, task_status, pause_reason, work_request_id, display_name, freeform_tags, defined_tags, last_execution_status, time_last_executed].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/log_analytics/models/standard_task.rb

@@ -35,11 +35,13 @@ module OCI
         'schedules': :'schedules',
         'action': :'action',
         'task_status': :'taskStatus',
+        'pause_reason': :'pauseReason',
         'work_request_id': :'workRequestId',
         'num_occurrences': :'numOccurrences',
         'compartment_id': :'compartmentId',
         'time_created': :'timeCreated',
         'time_updated': :'timeUpdated',
+        'time_of_next_execution': :'timeOfNextExecution',
         'lifecycle_state': :'lifecycleState',
         'freeform_tags': :'freeformTags',
         'defined_tags': :'definedTags',
@@ -60,11 +62,13 @@ module OCI
         'schedules': :'Array<OCI::LogAnalytics::Models::Schedule>',
         'action': :'OCI::LogAnalytics::Models::Action',
         'task_status': :'String',
+        'pause_reason': :'String',
         'work_request_id': :'String',
         'num_occurrences': :'Integer',
         'compartment_id': :'String',
         'time_created': :'DateTime',
         'time_updated': :'DateTime',
+        'time_of_next_execution': :'DateTime',
         'lifecycle_state': :'String',
         'freeform_tags': :'Hash<String, String>',
         'defined_tags': :'Hash<String, Hash<String, Object>>',
@@ -86,11 +90,13 @@ module OCI
     # @option attributes [Array<OCI::LogAnalytics::Models::Schedule>] :schedules The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#schedules #schedules} proprety
     # @option attributes [OCI::LogAnalytics::Models::Action] :action The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#action #action} proprety
     # @option attributes [String] :task_status The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#task_status #task_status} proprety
+    # @option attributes [String] :pause_reason The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#pause_reason #pause_reason} proprety
     # @option attributes [String] :work_request_id The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#work_request_id #work_request_id} proprety
     # @option attributes [Integer] :num_occurrences The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#num_occurrences #num_occurrences} proprety
     # @option attributes [String] :compartment_id The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#compartment_id #compartment_id} proprety
     # @option attributes [DateTime] :time_created The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#time_created #time_created} proprety
     # @option attributes [DateTime] :time_updated The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#time_updated #time_updated} proprety
+    # @option attributes [DateTime] :time_of_next_execution The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#time_of_next_execution #time_of_next_execution} proprety
     # @option attributes [String] :lifecycle_state The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#lifecycle_state #lifecycle_state} proprety
     # @option attributes [Hash<String, String>] :freeform_tags The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#freeform_tags #freeform_tags} proprety
     # @option attributes [Hash<String, Hash<String, Object>>] :defined_tags The value to assign to the {OCI::LogAnalytics::Models::ScheduledTask#defined_tags #defined_tags} proprety
@@ -150,11 +156,13 @@ module OCI
         schedules == other.schedules &&
         action == other.action &&
         task_status == other.task_status &&
+        pause_reason == other.pause_reason &&
         work_request_id == other.work_request_id &&
         num_occurrences == other.num_occurrences &&
         compartment_id == other.compartment_id &&
         time_created == other.time_created &&
         time_updated == other.time_updated &&
+        time_of_next_execution == other.time_of_next_execution &&
         lifecycle_state == other.lifecycle_state &&
         freeform_tags == other.freeform_tags &&
         defined_tags == other.defined_tags &&
@@ -175,7 +183,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [kind, id, display_name, task_type, schedules, action, task_status, work_request_id, num_occurrences, compartment_id, time_created, time_updated, lifecycle_state, freeform_tags, defined_tags, last_execution_status, time_last_executed].hash
+      [kind, id, display_name, task_type, schedules, action, task_status, pause_reason, work_request_id, num_occurrences, compartment_id, time_created, time_updated, time_of_next_execution, lifecycle_state, freeform_tags, defined_tags, last_execution_status, time_last_executed].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/log_analytics/models/stream_action.rb

@@ -15,13 +15,40 @@ module OCI
     # @return [OCI::LogAnalytics::Models::MetricExtraction]
     attr_accessor :metric_extraction
 
+    # The duration of data to be searched for SAVED_SEARCH tasks,
+    # used when the task fires to calculate the query time range.
+    #
+    # Duration in ISO 8601 extended format as described in
+    # https://en.wikipedia.org/wiki/ISO_8601#Durations.
+    # The value should be positive.
+    # The largest supported unit (as opposed to value) is D, e.g.  P14D (not P2W).
+    #
+    # There are restrictions on the maximum duration value relative to the task schedule
+    # value as specified in the following table.
+    #    Schedule Interval Range          | Maximum Duration
+    # ----------------------------------- | -----------------
+    #   5 Minutes     to 30 Minutes       |   1 hour  \"PT60M\"
+    #  31 Minutes     to  1 Hour          |  12 hours \"PT720M\"
+    #  1 Hour+1Minute to  1 Day           |   1 day   \"P1D\"
+    #  1 Day+1Minute  to  1 Week-1Minute  |   7 days  \"P7D\"
+    #  1 Week         to  2 Weeks         |  14 days  \"P14D\"
+    #  greater than 2 Weeks               |  30 days  \"P30D\"
+    #
+    # If not specified, the duration will be based on the schedule. For example,
+    # if the schedule is every 5 minutes then the savedSearchDuration will be \"PT5M\";
+    # if the schedule is every 3 weeks then the savedSearchDuration will be \"P21D\".
+    #
+    # @return [String]
+    attr_accessor :saved_search_duration
+
     # Attribute mapping from ruby-style variable name to JSON key.
     def self.attribute_map
       {
         # rubocop:disable Style/SymbolLiteral
         'type': :'type',
         'saved_search_id': :'savedSearchId',
-        'metric_extraction': :'metricExtraction'
+        'metric_extraction': :'metricExtraction',
+        'saved_search_duration': :'savedSearchDuration'
         # rubocop:enable Style/SymbolLiteral
       }
     end
@@ -32,7 +59,8 @@ module OCI
         # rubocop:disable Style/SymbolLiteral
         'type': :'String',
         'saved_search_id': :'String',
-        'metric_extraction': :'OCI::LogAnalytics::Models::MetricExtraction'
+        'metric_extraction': :'OCI::LogAnalytics::Models::MetricExtraction',
+        'saved_search_duration': :'String'
         # rubocop:enable Style/SymbolLiteral
       }
     end
@@ -45,6 +73,7 @@ module OCI
     # @param [Hash] attributes Model attributes in the form of hash
     # @option attributes [String] :saved_search_id The value to assign to the {#saved_search_id} property
     # @option attributes [OCI::LogAnalytics::Models::MetricExtraction] :metric_extraction The value to assign to the {#metric_extraction} property
+    # @option attributes [String] :saved_search_duration The value to assign to the {#saved_search_duration} property
     def initialize(attributes = {})
       return unless attributes.is_a?(Hash)
 
@@ -66,6 +95,12 @@ module OCI
       raise 'You cannot provide both :metricExtraction and :metric_extraction' if attributes.key?(:'metricExtraction') && attributes.key?(:'metric_extraction')
 
       self.metric_extraction = attributes[:'metric_extraction'] if attributes[:'metric_extraction']
+
+      self.saved_search_duration = attributes[:'savedSearchDuration'] if attributes[:'savedSearchDuration']
+
+      raise 'You cannot provide both :savedSearchDuration and :saved_search_duration' if attributes.key?(:'savedSearchDuration') && attributes.key?(:'saved_search_duration')
+
+      self.saved_search_duration = attributes[:'saved_search_duration'] if attributes[:'saved_search_duration']
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity
     # rubocop:enable Metrics/MethodLength, Layout/EmptyLines, Style/SymbolLiteral
@@ -81,7 +116,8 @@ module OCI
       self.class == other.class &&
         type == other.type &&
         saved_search_id == other.saved_search_id &&
-        metric_extraction == other.metric_extraction
+        metric_extraction == other.metric_extraction &&
+        saved_search_duration == other.saved_search_duration
     end
     # rubocop:enable Metrics/CyclomaticComplexity, Metrics/AbcSize, Metrics/PerceivedComplexity, Layout/EmptyLines
 
@@ -97,7 +133,7 @@ module OCI
     # Calculates hash code according to all attributes.
     # @return [Fixnum] Hash code
     def hash
-      [type, saved_search_id, metric_extraction].hash
+      [type, saved_search_id, metric_extraction, saved_search_duration].hash
     end
     # rubocop:enable Metrics/AbcSize, Layout/EmptyLines
 

data/lib/oci/loggingingestion/logging_client.rb

@@ -107,7 +107,7 @@ module OCI
     # @option opts [OCI::Retry::RetryConfig] :retry_config The retry configuration to apply to this operation. If no key is provided then the service-level
     #   retry configuration defined by {#retry_config} will be used. If an explicit `nil` value is provided then the operation will not retry
     # @option opts [DateTime] :timestamp_opc_agent_processing Effective timestamp, for when the agent started processing the log
-    #   segment being sent. An RFC3339-formatted date-time string.
+    #   segment being sent. An RFC3339-formatted date-time string with milliseconds precision.
     #
     # @option opts [String] :opc_agent_version Version of the agent sending the request.
     # @option opts [String] :opc_request_id Unique Oracle-assigned identifier for the request. If you need to contact Oracle about

data/lib/oci/loggingingestion/models/log_entry.rb

@@ -20,7 +20,7 @@ module OCI
     # @return [String]
     attr_accessor :id
 
-    # Optional. The timestamp associated with the log entry. An RFC3339-formatted date-time string.
+    # Optional. The timestamp associated with the log entry. An RFC3339-formatted date-time string with milliseconds precision.
     # If unspecified, defaults to PutLogsDetails.defaultlogentrytime.
     #
     # @return [DateTime]

data/lib/oci/loggingingestion/models/log_entry_batch.rb

@@ -32,8 +32,8 @@ module OCI
 
     # **[Required]** The timestamp for all log entries in this batch. This can be
     # considered as the default timestamp for each entry, unless it is
-    # overwritten by the entry time. An RFC3339-formatted date-time
-    # string.
+    # overwritten by the entry time. An RFC3339-formatted date-time string
+    # with milliseconds precision.
     #
     # @return [DateTime]
     attr_accessor :defaultlogentrytime

data/lib/oci/management_dashboard/dashx_apis_client.rb

@@ -241,7 +241,11 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new dashboard.  Limit for number of saved searches in a dashboard is 20.
+    # Creates a new dashboard.  Limit for number of saved searches in a dashboard is 20. To get an example of what needs to be passed to CREATE, one can use GET API.
+    # oci management-dashboard dashboard get --management-dashboard-id  \"ocid1.managementdashboard.oc1..dashboardId1\" --query data > Create.json
+    #
+    # Modify the Create.json by removing \"id\" attribute and other desired changes, then do
+    # oci management-dashboard dashboard create  --from-json file://Create.json
     #
     # @param [OCI::ManagementDashboard::Models::CreateManagementDashboardDetails] create_management_dashboard_details JSON metadata for creating a new dashboard.
     # @param [Hash] opts the optional parameters
@@ -303,7 +307,11 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Creates a new saved search.
+    # Creates a new saved search. To get an example of what needs to be passed to CREATE, one can use GET API.
+    # oci management-dashboard saved-search get --management-saved-search-id ocid1.managementsavedsearch.oc1..savedsearchId1 --query data > Create.json
+    #
+    # Modify the Create.json by removing \"id\" attribute and other desired changes, then do
+    # oci management-dashboard saved-search create  --from-json file://Create.json
     #
     # @param [OCI::ManagementDashboard::Models::CreateManagementSavedSearchDetails] create_management_saved_search_details JSON metadata for the saved search.
     # @param [Hash] opts the optional parameters
@@ -485,8 +493,8 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Exports an array of dashboards and their saved searches.
-    # @param [String] export_dashboard_id {\"dashboardIds\":[\"dashboardId1\", \"dashboardId2\", ...]}
+    # Exports an array of dashboards and their saved searches. Export is designed to work with importDashboard. An example using OCI CLI is $oci management-dashboard dashboard export --query data --export-dashboard-id \"{\\\"dashboardIds\\\":[\\\"ocid1.managementdashboard.oc1..dashboardId1\\\"]}\"  > dashboards.json $oci management-dashboard dashboard import --from-json file://dashboards.json
+    # @param [String] export_dashboard_id List of dashboardIds in plain text. The syntaxt is '{\"dashboardIds\":[\"dashboardId1\", \"dashboardId2\", ...]}'. Escaping is needed when using in OCI CLI. For example, \"{\\\"dashboardIds\\\":[\\\"ocid1.managementdashboard.oc1..dashboardId1\\\"]}\" .
     # @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
@@ -671,7 +679,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Imports an array of dashboards and their saved searches.
+    # Imports an array of dashboards and their saved searches. Import is designed to work with exportDashboard. An example using OCI CLI is
+    #     $oci management-dashboard dashboard export --query data --export-dashboard-id \"{\\\"dashboardIds\\\":[\\\"ocid1.managementdashboard.oc1..dashboardId1\\\"]}\"  > dashboards.json
+    #     $oci management-dashboard dashboard import --from-json file://dashboards.json
     #
     # @param [OCI::ManagementDashboard::Models::ManagementDashboardImportDetails] management_dashboard_import_details JSON metadata for importing dashboards and their saved searches.
     # @param [Hash] opts the optional parameters
@@ -739,7 +749,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets the list of dashboards and their saved searches in a compartment with pagination.  Returned properties are the summary.
+    # Gets the list of dashboards in a compartment with pagination.  Returned properties are the summary.
     # @param [String] compartment_id The ID of the compartment in which to list resources.
     # @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