oci 2.10.0 → 2.11.0

data/lib/oci/logging/models/update_unified_agent_configuration_details.rb

@@ -5,9 +5,9 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Update Object for Unified Agent configuration.
+  # Update Object for the Unified Agent configuration.
   class Logging::Models::UpdateUnifiedAgentConfigurationDetails
-    # **[Required]** The display name of a user-friendly name. It has to be unique within enclosing resource,
+    # **[Required]** The user-friendly display name. This must be unique within the enclosing resource,
     # and it's changeable. Avoid entering confidential information.
     #
     # @return [String]

data/lib/oci/logging/models/work_request.rb

@@ -34,7 +34,7 @@ module OCI
       STATUS_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # **[Required]** The OCID of the work request.
+    # **[Required]** The work request OCID.
     # @return [String]
     attr_accessor :id
 
@@ -46,7 +46,7 @@ module OCI
     # @return [String]
     attr_reader :status
 
-    # **[Required]** The OCID of the work request\u2019s compartment.
+    # **[Required]** The work request\u2019s compartment OCID.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/logging/models/work_request_error.rb

@@ -8,8 +8,8 @@ require 'logger'
 module OCI
   # An error encountered while executing a work request.
   class Logging::Models::WorkRequestError
-    # **[Required]** A machine-usable code for the error that occured. Error codes are listed on
-    # (https://docs.cloud.oracle.com/Content/API/References/apierrors.htm)
+    # **[Required]** A machine-usable code for the error that occured. Error codes are listed at
+    # https://docs.cloud.oracle.com/Content/API/References/apierrors.htm.
     #
     # @return [String]
     attr_accessor :code
@@ -18,7 +18,7 @@ module OCI
     # @return [String]
     attr_accessor :message
 
-    # **[Required]** The time the error occured. An RFC3339 formatted datetime string.
+    # **[Required]** The time the error occured. An RFC3339-formatted date and time string.
     # @return [DateTime]
     attr_accessor :timestamp
 

data/lib/oci/logging/models/work_request_log.rb

@@ -11,7 +11,7 @@ module OCI
     # @return [String]
     attr_accessor :message
 
-    # **[Required]** The time the log message was written. An RFC3339 formatted datetime string
+    # **[Required]** The time the log message was written. An RFC3339-formatted date and time string.
     # @return [DateTime]
     attr_accessor :timestamp
 

data/lib/oci/logging/models/work_request_resource.rb

@@ -23,17 +23,17 @@ module OCI
 
     # **[Required]** The way in which this resource is affected by the work tracked in the work request.
     # A resource being created, updated, or deleted will remain in the IN_PROGRESS state until
-    # work is complete for that resource at which point it will transition to CREATED, UPDATED,
+    # work is complete for that resource, at which point it will transition to CREATED, UPDATED,
     # or DELETED, respectively.
     #
     # @return [String]
     attr_reader :action_type
 
-    # **[Required]** The identifier of the resource the work request affects.
+    # **[Required]** The resource identifier the work request affects.
     # @return [String]
     attr_accessor :identifier
 
-    # The URI path that the user can do a GET on to access the resource metadata
+    # The URI path that the user can do a GET on to access the resource metadata.
     # @return [String]
     attr_accessor :entity_uri
 

data/lib/oci/loggingingestion/logging_client.rb

@@ -6,7 +6,7 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # PublicLoggingDataplane API specification
+  # Use the Logging Ingestion API to ingest your application logs.
   class Loggingingestion::LoggingClient
     # Client used to make HTTP requests.
     # @return [OCI::ApiClient]
@@ -98,7 +98,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # This Api allows ingesting logs associated with a logId. Success
+    # This API allows ingesting logs associated with a logId. A success
     # response implies the data has been accepted.
     #
     # @param [String] log_id OCID of a log to work with.
@@ -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 datetime string.
+    #   segment being sent. An RFC3339-formatted date-time string.
     #
     # @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

@@ -6,11 +6,11 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Contains the content of the log with associated timestamp and id. Each
+  # Contains the log content with the associated timestamp and ID. Each
   # entry should be less than 1 MB size.
   #
   class Loggingingestion::Models::LogEntry
-    # **[Required]** The content of the log entry.
+    # **[Required]** The log entry content.
     # @return [String]
     attr_accessor :data
 
@@ -20,9 +20,8 @@ module OCI
     # @return [String]
     attr_accessor :id
 
-    # Optional. The timestamp associated with the log entry. Defaults to
-    # PutLogsDetails.defaultlogentrytime if unspecified. An RFC3339 formatted
-    # datetime string.
+    # Optional. The timestamp associated with the log entry. An RFC3339-formatted date-time string.
+    # If unspecified, defaults to PutLogsDetails.defaultlogentrytime.
     #
     # @return [DateTime]
     attr_accessor :time

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

@@ -11,28 +11,28 @@ module OCI
     # @return [Array<OCI::Loggingingestion::Models::LogEntry>]
     attr_accessor :entries
 
-    # **[Required]** Source of the logs that generated the message. It could be the
-    # instance name, hostname or the source used to read the event.
+    # **[Required]** Source of the logs that generated the message. This could be the
+    # instance name, hostname, or the source used to read the event. For example, \"ServerA\".
     #
     # @return [String]
     attr_accessor :source
 
     # **[Required]** This field signifies the type of logs being ingested.
-    # For example: ServerA.requestLogs
+    # For example: ServerA.requestLogs.
     #
     # @return [String]
     attr_accessor :type
 
-    # This optional field is useful for specifying the specific subresource
+    # This optional field is useful for specifying the specific sub-resource
     # or input file used to read the event.
-    # For example: \"/var/log/application.log\"
+    # For example: \"/var/log/application.log\".
     #
     # @return [String]
     attr_accessor :subject
 
-    # **[Required]** The timestamp for all log entries in this request. This can be
+    # **[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 datetime
+    # overwritten by the entry time. An RFC3339-formatted date-time
     # string.
     #
     # @return [DateTime]

data/lib/oci/loggingsearch/log_search_client.rb

@@ -6,7 +6,7 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Search for logs in your compartements / log groups / log objects.
+  # Search for logs in your compartments, log groups, and log objects.
   class Loggingsearch::LogSearchClient
     # Client used to make HTTP requests.
     # @return [OCI::ApiClient]
@@ -109,10 +109,10 @@ module OCI
     #   a particular request, please provide the request ID.
     #
     # @option opts [Integer] :limit The maximum number of items to return in a paginated \"List\" call. For information about pagination, see
-    #   [List Pagination](https://docs.cloud.oracle.com/#API/Concepts/usingapi.htm#List_Pagination).
+    #   [List Pagination](https://docs.cloud.oracle.com/iaas/Content/API/Concepts/usingapi.htm#nine).
     #    (default to 100)
     # @option opts [String] :page The value of the `opc-next-page` response header from the previous \"List\" call. For information about
-    #   pagination, see [List Pagination](https://docs.cloud.oracle.com/#API/Concepts/usingapi.htm#List_Pagination).
+    #   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}
     def search_logs(search_logs_details, opts = {})

data/lib/oci/loggingsearch/models/field_info.rb

@@ -22,7 +22,7 @@ module OCI
 
     # **[Required]** Field type -
     # * `STRING`: A sequence of characters.
-    # * `NUMBER`: Numeric type which can be integer or floating point.
+    # * `NUMBER`: Numeric type which can be an integer or floating point.
     # * `BOOLEAN`: Either true or false.
     # * `ARRAY`: An ordered collection of values.
     #

data/lib/oci/loggingsearch/models/search_logs_details.rb

@@ -18,8 +18,8 @@ module OCI
     attr_accessor :time_end
 
     # **[Required]** Query corresponding to the search operation. This query is parsed and validated before execution and
-    # should follow the spec. For query language specification see:
-    # https://docs.cloud.oracle.com/iaas/Content/Logging/Reference/query_language_specification.htm
+    # should follow the specification. For more information on the query language specification, see
+    # [Logging Query Language Specification](https://docs.cloud.oracle.com/Content/Logging/Reference/query_language_specification.htm).
     #
     # @return [String]
     attr_accessor :search_query

data/lib/oci/loggingsearch/models/search_result.rb

@@ -5,9 +5,9 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A log search result entry
+  # A log search result entry.
   class Loggingsearch::Models::SearchResult
-    # **[Required]** JSON blob containing the search entry with projected fields.
+    # **[Required]** JSON blob containing the search entry with the projected fields.
     # @return [Object]
     attr_accessor :data
 

data/lib/oci/management_dashboard/dashx_apis_client.rb

@@ -6,8 +6,7 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Management Dashboard micro-service provides a set of CRUD, import, export, and compartment related APIs (such as change compartment)   to support dashboard and saved search metadata preservation.  These APIs are mainly for client UIs, for various UI activities such as get list of all saved searches in a compartment, create a dashboard, open a saved search, etc.  Use export to retrieve  dashboards and their saved searches, then edit the Json if necessary (for example change compartmentIds), then import the result to  destination dashboard service.
-  # APIs validate all required properties to ensure properties are present and have correct type and values.
+  # API for the Management Dashboard micro-service. Use this API for dashboard and saved search metadata preservation and to perform  tasks such as creating a dashboard, creating a saved search, and obtaining a list of dashboards and saved searches in a compartment.
   #
   class ManagementDashboard::DashxApisClient
     # Client used to make HTTP requests.
@@ -100,10 +99,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Move the dashboard from existing compartment to a new compartment.
+    # Moves the dashboard from the existing compartment to a new compartment.
     #
-    # @param [String] management_dashboard_id unique dashboard identifier
-    # @param [OCI::ManagementDashboard::Models::ChangeManagementDashboardsCompartmentDetails] change_management_dashboards_compartment_details Id for dashboard to be moved.
+    # @param [String] management_dashboard_id A unique dashboard identifier.
+    # @param [OCI::ManagementDashboard::Models::ChangeManagementDashboardsCompartmentDetails] change_management_dashboards_compartment_details ID of the dashboard that is being moved.
     # @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
@@ -170,10 +169,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Move the saved search from existing compartment to a new compartment.
+    # Moves the saved search from the existing compartment to a new compartment.
     #
-    # @param [String] management_saved_search_id unique saved search identifier
-    # @param [OCI::ManagementDashboard::Models::ChangeManagementSavedSearchesCompartmentDetails] change_management_saved_searches_compartment_details Compartment id to move the saved search to.
+    # @param [String] management_saved_search_id A unique saved search identifier.
+    # @param [OCI::ManagementDashboard::Models::ChangeManagementSavedSearchesCompartmentDetails] change_management_saved_searches_compartment_details ID of the saved search that is being moved.
     # @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
@@ -242,7 +241,7 @@ module OCI
 
     # Creates a new dashboard.  Limit for number of saved searches in a dashboard is 20.
     #
-    # @param [OCI::ManagementDashboard::Models::CreateManagementDashboardDetails] create_management_dashboard_details Json metadata for creating a new dashboard.
+    # @param [OCI::ManagementDashboard::Models::CreateManagementDashboardDetails] create_management_dashboard_details JSON metadata for creating a new dashboard.
     # @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
@@ -303,7 +302,7 @@ module OCI
 
     # Creates a new saved search.
     #
-    # @param [OCI::ManagementDashboard::Models::CreateManagementSavedSearchDetails] create_management_saved_search_details Json metadata for the saved search.
+    # @param [OCI::ManagementDashboard::Models::CreateManagementSavedSearchDetails] create_management_saved_search_details JSON metadata for the saved search.
     # @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
@@ -362,8 +361,8 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes a Dashboard by id.
-    # @param [String] management_dashboard_id unique dashboard identifier
+    # Deletes a Dashboard by ID.
+    # @param [String] management_dashboard_id A unique dashboard 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
@@ -421,8 +420,8 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Deletes a saved search by Id
-    # @param [String] management_saved_search_id unique saved search identifier
+    # Deletes a saved search by ID.
+    # @param [String] management_saved_search_id A unique saved search 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
@@ -541,8 +540,8 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Get a Dashboard and its saved searches by id.  Deleted or unauthorized saved searches are marked by tile's state property.
-    # @param [String] management_dashboard_id unique dashboard identifier
+    # Gets a dashboard and its saved searches by ID.  Deleted or unauthorized saved searches are marked by tile's state property.
+    # @param [String] management_dashboard_id A unique dashboard 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
@@ -602,8 +601,8 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Get a saved search by Id.
-    # @param [String] management_saved_search_id unique saved search identifier
+    # Gets a saved search by ID.
+    # @param [String] management_saved_search_id A unique saved search 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
@@ -663,9 +662,9 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Import an array of dashboards and their saved searches.
+    # Imports an array of dashboards and their saved searches.
     #
-    # @param [OCI::ManagementDashboard::Models::ManagementDashboardImportDetails] management_dashboard_import_details Json metadata for dashboards and their saved searches to import.
+    # @param [OCI::ManagementDashboard::Models::ManagementDashboardImportDetails] management_dashboard_import_details JSON metadata for importing dashboards and their saved searches.
     # @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
@@ -730,7 +729,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets list of dashboards and their saved searches for compartment with pagination.  Returned properties are a summary.
+    # Gets the list of dashboards and their saved searches 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
@@ -738,9 +737,9 @@ module OCI
     # @option opts [String] :display_name A filter to return only resources that match the entire display name given.
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @option opts [Integer] :limit The maximum number of items to return. (default to 100)
-    # @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] :page The page token representing the page on 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 ASC)
-    # @option opts [String] :sort_by The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending. If no value is specified timeCreated is default.
+    # @option opts [String] :sort_by The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending. If no value is specified timeCreated is the default.
     #    (default to timeCreated)
     #   Allowed values are: timeCreated, displayName
     # @return [Response] A Response object with data of type {OCI::ManagementDashboard::Models::ManagementDashboardCollection ManagementDashboardCollection}
@@ -803,7 +802,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets list of saved searches with pagination.  Returned properties are a summary.
+    # Gets the list of saved searches 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
@@ -811,9 +810,9 @@ module OCI
     # @option opts [String] :display_name A filter to return only resources that match the entire display name given.
     # @option opts [String] :opc_request_id The client request ID for tracing.
     # @option opts [Integer] :limit The maximum number of items to return. (default to 100)
-    # @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] :page The page token representing the page on 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 ASC)
-    # @option opts [String] :sort_by The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending. If no value is specified timeCreated is default.
+    # @option opts [String] :sort_by The field to sort by. Only one sort order may be provided. Default order for timeCreated is descending. Default order for displayName is ascending. If no value is specified timeCreated is the default.
     #    (default to timeCreated)
     #   Allowed values are: timeCreated, displayName
     # @return [Response] A Response object with data of type {OCI::ManagementDashboard::Models::ManagementSavedSearchCollection ManagementSavedSearchCollection}
@@ -876,10 +875,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Updates an existing dashboard identified by id path parameter.  Limit for number of saved searches in a dashboard is 20.
+    # Updates an existing dashboard identified by ID path parameter.  CompartmentId can be modified only by the changeCompartment API. Limit for number of saved searches in a dashboard is 20.
     #
-    # @param [String] management_dashboard_id unique dashboard identifier
-    # @param [OCI::ManagementDashboard::Models::UpdateManagementDashboardDetails] update_management_dashboard_details Json Metadata for changed dashboard properties.
+    # @param [String] management_dashboard_id A unique dashboard identifier.
+    # @param [OCI::ManagementDashboard::Models::UpdateManagementDashboardDetails] update_management_dashboard_details JSON metadata for changed dashboard properties.
     # @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
@@ -947,10 +946,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Update an existing saved search.  Id cannot be updated.
+    # Updates an existing saved search identified by ID path parameter.  CompartmentId can be modified only by the changeCompartment API.
     #
-    # @param [String] management_saved_search_id unique saved search identifier
-    # @param [OCI::ManagementDashboard::Models::UpdateManagementSavedSearchDetails] update_management_saved_search_details Json metadata for changed properties in existing saved search.
+    # @param [String] management_saved_search_id A unique saved search identifier.
+    # @param [OCI::ManagementDashboard::Models::UpdateManagementSavedSearchDetails] update_management_saved_search_details JSON metadata for changed saved search properties.
     # @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

data/lib/oci/management_dashboard/models/change_management_dashboards_compartment_details.rb

@@ -5,9 +5,9 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Compartment to move the dashboard to.
+  # Compartment to which the dashboard is being moved.
   class ManagementDashboard::Models::ChangeManagementDashboardsCompartmentDetails
-    # **[Required]** Compartment Identifier
+    # **[Required]** OCID of the compartment to which the dashboard is being moved.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/management_dashboard/models/change_management_saved_searches_compartment_details.rb

@@ -5,9 +5,9 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Details required for changing the compartment of saved search.
+  # Compartment to which the saved search is being moved.
   class ManagementDashboard::Models::ChangeManagementSavedSearchesCompartmentDetails
-    # **[Required]** Compartment Identifier
+    # **[Required]** OCID of the compartment to which the saved search is being moved.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/management_dashboard/models/create_management_dashboard_details.rb

@@ -5,45 +5,45 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Properties for a dashboard.  Id is not required if not Out Of the Box dashboard.
+  # Properties of a dashboard.  ID of the dashboard must only be provided for Out-of-the-Box (OOB) dashboards.
   class ManagementDashboard::Models::CreateManagementDashboardDetails
-    # Dashboard Id. Must be providied if OOB, otherwise must not be provided.
+    # ID of the dashboard, which must only be provided for Out-of-the-Box (OOB) dashboards.
     # @return [String]
     attr_accessor :dashboard_id
 
-    # **[Required]** Provider Id.
+    # **[Required]** ID of the service (for example, log-analytics) that owns the dashboard. Each service has a unique ID.
     # @return [String]
     attr_accessor :provider_id
 
-    # **[Required]** Provider name.
+    # **[Required]** Name of the service (for example, Logging Analytics) that owns the dashboard.
     # @return [String]
     attr_accessor :provider_name
 
-    # **[Required]** Provider version.
+    # **[Required]** Version of the service that owns the dashboard.
     # @return [String]
     attr_accessor :provider_version
 
-    # **[Required]** Dashboard tiles array.
+    # **[Required]** Array of dashboard tiles.
     # @return [Array<OCI::ManagementDashboard::Models::ManagementDashboardTileDetails>]
     attr_accessor :tiles
 
-    # **[Required]** Display name for dashboard.
+    # **[Required]** Display name of the dashboard.
     # @return [String]
     attr_accessor :display_name
 
-    # **[Required]** Dashboard's description.
+    # **[Required]** Description of the dashboard.
     # @return [String]
     attr_accessor :description
 
-    # **[Required]** The ocid of the compartment that owns the dashboard.
+    # **[Required]** OCID of the compartment in which the dashboard resides.
     # @return [String]
     attr_accessor :compartment_id
 
-    # **[Required]** String boolean (\"true\" or \"false\").  OOB (Out of the Box) dashboards are only provided by Oracle.  They cannot be modified by non-Oracle.
+    # **[Required]** Determines whether the dashboard is an Out-of-the-Box (OOB) dashboard. Note that OOB dashboards are only provided by Oracle and cannot be modified.
     # @return [BOOLEAN]
     attr_accessor :is_oob_dashboard
 
-    # **[Required]** String boolean (\"true\" or \"false\").  When false, dashboard is not shown in dashboard home.
+    # **[Required]** Determines whether the dashboard will be displayed in Dashboard Home.
     # @return [BOOLEAN]
     attr_accessor :is_show_in_home
 
@@ -51,31 +51,31 @@ module OCI
     # @return [String]
     attr_accessor :metadata_version
 
-    # **[Required]** String boolean (\"true\" or \"false\").  Whether to show the dashboard description.
+    # **[Required]** Determines whether the description of the dashboard is displayed.
     # @return [BOOLEAN]
     attr_accessor :is_show_description
 
-    # **[Required]** screen image.
+    # **[Required]** Screen image of the dashboard.
     # @return [String]
     attr_accessor :screen_image
 
-    # **[Required]** Json for internationalization.
+    # **[Required]** JSON that contains internationalization options.
     # @return [Object]
     attr_accessor :nls
 
-    # **[Required]** Json to contain options for UI.
+    # **[Required]** JSON that contains user interface options.
     # @return [Object]
     attr_accessor :ui_config
 
-    # **[Required]** Array of Json to contain options for source of data.
+    # **[Required]** Array of JSON that contain data source options.
     # @return [Array<Object>]
     attr_accessor :data_config
 
-    # **[Required]** NORMAL means single dashboard, or SET means dashboard set.
+    # **[Required]** Type of dashboard. NORMAL denotes a single dashboard and SET denotes a dashboard set.
     # @return [String]
     attr_accessor :type
 
-    # **[Required]** String boolean (\"true\" or \"false\").
+    # **[Required]** Determines whether the dashboard is set as favorite.
     # @return [BOOLEAN]
     attr_accessor :is_favorite