oci 2.16.0 → 2.17.0

data/lib/oci/database_management/models/update_tablespace_details.rb

@@ -0,0 +1,303 @@
+# Copyright (c) 2016, 2022, 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'
+
+# rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
+module OCI
+  # The details required to update a tablespace.
+  class DatabaseManagement::Models::UpdateTablespaceDetails
+    TYPE_ENUM = [
+      TYPE_PERMANENT = 'PERMANENT'.freeze,
+      TYPE_TEMPORARY = 'TEMPORARY'.freeze
+    ].freeze
+
+    STATUS_ENUM = [
+      STATUS_READ_ONLY = 'READ_ONLY'.freeze,
+      STATUS_READ_WRITE = 'READ_WRITE'.freeze
+    ].freeze
+
+    # This attribute is required.
+    # @return [OCI::DatabaseManagement::Models::TablespaceAdminCredentialDetails]
+    attr_accessor :credential_details
+
+    # The name of the tablespace. It must be unique within a database.
+    #
+    # @return [String]
+    attr_accessor :name
+
+    # The type of tablespace.
+    #
+    # @return [String]
+    attr_reader :type
+
+    # The size of each data file or temp file.
+    #
+    # @return [OCI::DatabaseManagement::Models::TablespaceStorageSize]
+    attr_accessor :file_size
+
+    # The status of the tablespace.
+    #
+    # @return [String]
+    attr_reader :status
+
+    # Specifies whether the data file or temp file can be extended automatically.
+    #
+    # @return [BOOLEAN]
+    attr_accessor :is_auto_extensible
+
+    # The size of the next increment of disk space to be allocated automatically when more extents are required.
+    #
+    # @return [OCI::DatabaseManagement::Models::TablespaceStorageSize]
+    attr_accessor :auto_extend_next_size
+
+    # The maximum disk space allowed for automatic extension of the data files or temp files.
+    #
+    # @return [OCI::DatabaseManagement::Models::TablespaceStorageSize]
+    attr_accessor :auto_extend_max_size
+
+    # Specifies whether the disk space of the data file or temp file can be limited.
+    #
+    # @return [BOOLEAN]
+    attr_accessor :is_max_size_unlimited
+
+    # Specifies whether the tablespace is the default tablespace.
+    #
+    # @return [BOOLEAN]
+    attr_accessor :is_default
+
+    # Attribute mapping from ruby-style variable name to JSON key.
+    def self.attribute_map
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'credential_details': :'credentialDetails',
+        'name': :'name',
+        'type': :'type',
+        'file_size': :'fileSize',
+        'status': :'status',
+        'is_auto_extensible': :'isAutoExtensible',
+        'auto_extend_next_size': :'autoExtendNextSize',
+        'auto_extend_max_size': :'autoExtendMaxSize',
+        'is_max_size_unlimited': :'isMaxSizeUnlimited',
+        'is_default': :'isDefault'
+        # rubocop:enable Style/SymbolLiteral
+      }
+    end
+
+    # Attribute type mapping.
+    def self.swagger_types
+      {
+        # rubocop:disable Style/SymbolLiteral
+        'credential_details': :'OCI::DatabaseManagement::Models::TablespaceAdminCredentialDetails',
+        'name': :'String',
+        'type': :'String',
+        'file_size': :'OCI::DatabaseManagement::Models::TablespaceStorageSize',
+        'status': :'String',
+        'is_auto_extensible': :'BOOLEAN',
+        'auto_extend_next_size': :'OCI::DatabaseManagement::Models::TablespaceStorageSize',
+        'auto_extend_max_size': :'OCI::DatabaseManagement::Models::TablespaceStorageSize',
+        'is_max_size_unlimited': :'BOOLEAN',
+        'is_default': :'BOOLEAN'
+        # 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 [OCI::DatabaseManagement::Models::TablespaceAdminCredentialDetails] :credential_details The value to assign to the {#credential_details} property
+    # @option attributes [String] :name The value to assign to the {#name} property
+    # @option attributes [String] :type The value to assign to the {#type} property
+    # @option attributes [OCI::DatabaseManagement::Models::TablespaceStorageSize] :file_size The value to assign to the {#file_size} property
+    # @option attributes [String] :status The value to assign to the {#status} property
+    # @option attributes [BOOLEAN] :is_auto_extensible The value to assign to the {#is_auto_extensible} property
+    # @option attributes [OCI::DatabaseManagement::Models::TablespaceStorageSize] :auto_extend_next_size The value to assign to the {#auto_extend_next_size} property
+    # @option attributes [OCI::DatabaseManagement::Models::TablespaceStorageSize] :auto_extend_max_size The value to assign to the {#auto_extend_max_size} property
+    # @option attributes [BOOLEAN] :is_max_size_unlimited The value to assign to the {#is_max_size_unlimited} property
+    # @option attributes [BOOLEAN] :is_default The value to assign to the {#is_default} 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.credential_details = attributes[:'credentialDetails'] if attributes[:'credentialDetails']
+
+      raise 'You cannot provide both :credentialDetails and :credential_details' if attributes.key?(:'credentialDetails') && attributes.key?(:'credential_details')
+
+      self.credential_details = attributes[:'credential_details'] if attributes[:'credential_details']
+
+      self.name = attributes[:'name'] if attributes[:'name']
+
+      self.type = attributes[:'type'] if attributes[:'type']
+
+      self.file_size = attributes[:'fileSize'] if attributes[:'fileSize']
+
+      raise 'You cannot provide both :fileSize and :file_size' if attributes.key?(:'fileSize') && attributes.key?(:'file_size')
+
+      self.file_size = attributes[:'file_size'] if attributes[:'file_size']
+
+      self.status = attributes[:'status'] if attributes[:'status']
+
+      self.is_auto_extensible = attributes[:'isAutoExtensible'] unless attributes[:'isAutoExtensible'].nil?
+
+      raise 'You cannot provide both :isAutoExtensible and :is_auto_extensible' if attributes.key?(:'isAutoExtensible') && attributes.key?(:'is_auto_extensible')
+
+      self.is_auto_extensible = attributes[:'is_auto_extensible'] unless attributes[:'is_auto_extensible'].nil?
+
+      self.auto_extend_next_size = attributes[:'autoExtendNextSize'] if attributes[:'autoExtendNextSize']
+
+      raise 'You cannot provide both :autoExtendNextSize and :auto_extend_next_size' if attributes.key?(:'autoExtendNextSize') && attributes.key?(:'auto_extend_next_size')
+
+      self.auto_extend_next_size = attributes[:'auto_extend_next_size'] if attributes[:'auto_extend_next_size']
+
+      self.auto_extend_max_size = attributes[:'autoExtendMaxSize'] if attributes[:'autoExtendMaxSize']
+
+      raise 'You cannot provide both :autoExtendMaxSize and :auto_extend_max_size' if attributes.key?(:'autoExtendMaxSize') && attributes.key?(:'auto_extend_max_size')
+
+      self.auto_extend_max_size = attributes[:'auto_extend_max_size'] if attributes[:'auto_extend_max_size']
+
+      self.is_max_size_unlimited = attributes[:'isMaxSizeUnlimited'] unless attributes[:'isMaxSizeUnlimited'].nil?
+
+      raise 'You cannot provide both :isMaxSizeUnlimited and :is_max_size_unlimited' if attributes.key?(:'isMaxSizeUnlimited') && attributes.key?(:'is_max_size_unlimited')
+
+      self.is_max_size_unlimited = attributes[:'is_max_size_unlimited'] unless attributes[:'is_max_size_unlimited'].nil?
+
+      self.is_default = attributes[:'isDefault'] unless attributes[:'isDefault'].nil?
+
+      raise 'You cannot provide both :isDefault and :is_default' if attributes.key?(:'isDefault') && attributes.key?(:'is_default')
+
+      self.is_default = attributes[:'is_default'] unless attributes[:'is_default'].nil?
+    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] type Object to be assigned
+    def type=(type)
+      raise "Invalid value for 'type': this must be one of the values in TYPE_ENUM." if type && !TYPE_ENUM.include?(type)
+
+      @type = type
+    end
+
+    # Custom attribute writer method checking allowed values (enum).
+    # @param [Object] status Object to be assigned
+    def status=(status)
+      raise "Invalid value for 'status': this must be one of the values in STATUS_ENUM." if status && !STATUS_ENUM.include?(status)
+
+      @status = status
+    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 &&
+        credential_details == other.credential_details &&
+        name == other.name &&
+        type == other.type &&
+        file_size == other.file_size &&
+        status == other.status &&
+        is_auto_extensible == other.is_auto_extensible &&
+        auto_extend_next_size == other.auto_extend_next_size &&
+        auto_extend_max_size == other.auto_extend_max_size &&
+        is_max_size_unlimited == other.is_max_size_unlimited &&
+        is_default == other.is_default
+    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
+      [credential_details, name, type, file_size, status, is_auto_extensible, auto_extend_next_size, auto_extend_max_size, is_max_size_unlimited, is_default].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/database_management/models/user.rb

@@ -87,7 +87,7 @@ module OCI
     # @return [String]
     attr_accessor :name
 
-    # **[Required]** The account status of the User
+    # **[Required]** The status of the user account.
     # @return [String]
     attr_reader :status
 
@@ -95,7 +95,7 @@ module OCI
     # @return [DateTime]
     attr_accessor :time_locked
 
-    # The date of expiration of the account
+    # The date and time of the expiration of the user account.
     # @return [DateTime]
     attr_accessor :time_expiring
 
@@ -107,11 +107,11 @@ module OCI
     # @return [String]
     attr_accessor :temp_tablespace
 
-    # The default local temporary tablespace for the User.
+    # The default local temporary tablespace for the user.
     # @return [String]
     attr_accessor :local_temp_tablespace
 
-    # **[Required]** The User creation date.
+    # **[Required]** The date and time the user was created.
     # @return [DateTime]
     attr_accessor :time_created
 
@@ -123,19 +123,19 @@ module OCI
     # @return [String]
     attr_accessor :consumer_group
 
-    # The external name of User.
+    # The external name of the user.
     # @return [String]
     attr_accessor :external_name
 
-    # The list of versions of the password hashes (also known as \"verifiers\") existing for the account.
+    # The list of existing versions of the password hashes (also known as \"verifiers\") for the account.
     # @return [String]
     attr_accessor :password_versions
 
-    # Indicates whether editions have been enabled for the corresponding user (Y) or not (N)
+    # Indicates whether editions have been enabled for the corresponding user (Y) or not (N).
     # @return [String]
     attr_reader :editions_enabled
 
-    # The authentication mechanism for the user
+    # The authentication mechanism for the user.
     # @return [String]
     attr_reader :authentication
 
@@ -149,29 +149,29 @@ module OCI
     # @return [String]
     attr_reader :common
 
-    # The time of the last user login.
+    # The date and time of the last user login.
     # This column is not populated when a user connects to the database with administrative privileges, that is, AS { SYSASM | SYSBACKUP | SYSDBA | SYSDG | SYSOPER | SYSRAC | SYSKM }.
     #
     # @return [DateTime]
     attr_accessor :time_last_login
 
-    # Indicates whether the user was created, and is maintained, by Oracle-supplied scripts (such as catalog.sql or catproc.sql).
+    # Indicates whether the user was created and is maintained by Oracle-supplied scripts (such as catalog.sql or catproc.sql).
     # @return [String]
     attr_reader :oracle_maintained
 
-    # Indicates whether the user definition was inherited from another container (YES) or not (NO)
+    # Indicates whether the user definition is inherited from another container (YES) or not (NO).
     # @return [String]
     attr_reader :inherited
 
-    # The default collation for the user\u2019s schema.
+    # The default collation for the user schema.
     # @return [String]
     attr_accessor :default_collation
 
-    # Indicates whether this user is a common user created by an implicit application (YES) or not (NO)
+    # Indicates whether the user is a common user created by an implicit application (YES) or not (NO).
     # @return [String]
     attr_reader :implicit
 
-    # In a sharded database, the value in this column indicates whether the user was created with shard DDL enabled.
+    # In a sharded database, indicates whether the user is created with shard DDL enabled (YES) or not (NO).
     # @return [String]
     attr_reader :all_shared
 
@@ -179,7 +179,7 @@ module OCI
     # @return [String]
     attr_reader :external_shared
 
-    # The date on which the user's password was last set.
+    # The date and time when the user password was last set.
     # This column is populated only when the value of the AUTHENTICATION_TYPE column is PASSWORD. Otherwise, this column is null.
     #
     # @return [DateTime]

data/lib/oci/database_management/models/user_collection.rb

@@ -5,7 +5,7 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # A collection of Users for a specific database.
+  # A collection of users for a specific database.
   class DatabaseManagement::Models::UserCollection
     # **[Required]** An array of User resources.
     # @return [Array<OCI::DatabaseManagement::Models::UserSummary>]

data/lib/oci/database_management/models/user_summary.rb

@@ -31,11 +31,11 @@ module OCI
     # @return [String]
     attr_accessor :name
 
-    # **[Required]** The account status of the User
+    # **[Required]** The status of the user account.
     # @return [String]
     attr_reader :status
 
-    # The date of expiration of the account
+    # The date and time of the expiration of the user account.
     # @return [DateTime]
     attr_accessor :time_expiring
 
@@ -47,7 +47,7 @@ module OCI
     # @return [String]
     attr_accessor :temp_tablespace
 
-    # **[Required]** The User creation date.
+    # **[Required]** The date and time the user was created.
     # @return [DateTime]
     attr_accessor :time_created
 

data/lib/oci/database_management/sql_tuning_client.rb

@@ -100,10 +100,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Clone and start a SQL tuning task for a given SQL tuning task.
+    # Clones and runs a SQL tuning task in the database.
     #
     # @param [String] managed_database_id The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the Managed Database.
-    # @param [OCI::DatabaseManagement::Models::CloneSqlTuningTaskDetails] clone_sql_tuning_task_details Detail inputs for cloning a SQL tuning task
+    # @param [OCI::DatabaseManagement::Models::CloneSqlTuningTaskDetails] clone_sql_tuning_task_details The detailed inputs required to clone a SQL tuning task.
     # @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
@@ -165,10 +165,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Drop a SQL tuning task and its related results from the database.
+    # Drops a SQL tuning task and its related results from the database.
     #
     # @param [String] managed_database_id The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the Managed Database.
-    # @param [OCI::DatabaseManagement::Models::DropSqlTuningTaskDetails] drop_sql_tuning_task_details Detail inputs for dropping a SQL tuning task
+    # @param [OCI::DatabaseManagement::Models::DropSqlTuningTaskDetails] drop_sql_tuning_task_details The detailed inputs required to drop a SQL tuning task.
     # @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
@@ -229,13 +229,14 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # A SQL tuning task may suggest new execution plan for a SQL. The API returns the
-    # stats comparison report for the plans.
+    # Retrieves a comparison of the existing SQL execution plan and a new plan.
+    # A SQL tuning task may suggest a new execution plan for a SQL,
+    # and this API retrieves the comparison report of the statistics of the two plans.
     #
     # @param [String] managed_database_id The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the Managed Database.
     # @param [Integer] sql_tuning_advisor_task_id The SQL tuning task identifier. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
-    # @param [Integer] sql_object_id The SQL object id for the SQL tuning task. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
-    # @param [Integer] execution_id The execution id for an execution of a SQL tuning task. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    # @param [Integer] sql_object_id The SQL object ID for the SQL tuning task. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    # @param [Integer] execution_id The execution ID for an execution of a SQL tuning task. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
     #
     # @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
@@ -295,11 +296,11 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Retrieve a SQL execution plan for a SQL being tuned, for original or new plan
+    # Retrieves a SQL execution plan for the SQL being tuned.
     #
     # @param [String] managed_database_id The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the Managed Database.
     # @param [Integer] sql_tuning_advisor_task_id The SQL tuning task identifier. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
-    # @param [Integer] sql_object_id The SQL object id for the SQL tuning task. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    # @param [Integer] sql_object_id The SQL object ID for the SQL tuning task. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
     # @param [String] attribute The attribute of the SQL execution plan.
     #   Allowed values are: ORIGINAL, ORIGINAL_WITH_ADJUSTED_COST, USING_SQL_PROFILE, USING_NEW_INDICES
     # @param [Hash] opts the optional parameters
@@ -363,7 +364,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Gets the summary report for the specific SQL Tuning Advisor task.
+    # Gets the summary report for the specified SQL Tuning Advisor task.
     #
     # @param [String] managed_database_id The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the Managed Database.
     # @param [Integer] sql_tuning_advisor_task_id The SQL tuning task identifier. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
@@ -436,7 +437,7 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Takes in a task id, and a finding/object type filter and applies some SQLs to find return the output.
+    # Gets an array of the details of the findings that match specific filters.
     #
     # @param [String] managed_database_id The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the Managed Database.
     # @param [Integer] sql_tuning_advisor_task_id The SQL tuning task identifier. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
@@ -445,9 +446,11 @@ 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 [Integer] :begin_exec_id The optional greater than or equal to filter on the execution ID related to a specific SQL Tuning Advisor task.
     # @option opts [Integer] :end_exec_id The optional less than or equal to query parameter to filter on the execution ID related to a specific SQL Tuning Advisor task.
-    # @option opts [String] :search_period How far back the API will search for begin and end exec id, if not supplied. Unused if beginExecId and endExecId optional query params are both supplied. (default to ALL)
+    # @option opts [String] :search_period The search period during which the API will search for begin and end exec id, if not supplied.
+    #   Unused if beginExecId and endExecId optional query params are both supplied.
+    #    (default to ALL)
     #   Allowed values are: LAST_24HR, LAST_7DAY, LAST_31DAY, SINCE_LAST, ALL
-    # @option opts [String] :finding_filter Filters which findings get shown in the report (default to none)
+    # @option opts [String] :finding_filter The filter used to display specific findings in the report. (default to none)
     #   Allowed values are: none, FINDINGS, NOFINDINGS, ERRORS, PROFILES, INDICES, STATS, RESTRUCTURE, ALTERNATIVE, AUTO_PROFILES, OTHER_PROFILES
     # @option opts [String] :stats_hash_filter The hash value of the object for the statistic finding search.
     # @option opts [String] :index_hash_filter The hash value of the index table name.
@@ -535,12 +538,13 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Takes in a task id and object id and returns the recommendations/findings.
+    # Gets the findings and possible actions for a given object in a SQL tuning task.
+    # The task ID and object ID are used to retrieve the findings and recommendations.
     #
     # @param [String] managed_database_id The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the Managed Database.
     # @param [Integer] sql_tuning_advisor_task_id The SQL tuning task identifier. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
-    # @param [Integer] sql_object_id The SQL object id for the SQL tuning task. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
-    # @param [Integer] execution_id The execution id for an execution of a SQL tuning task. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    # @param [Integer] sql_object_id The SQL object ID for the SQL tuning task. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
+    # @param [Integer] execution_id The execution ID for an execution of a SQL tuning task. This is not the [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm).
     #
     # @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
@@ -634,7 +638,7 @@ module OCI
     #   are retrieved. This is usually retrieved from a previous list call.
     #
     # @option opts [Integer] :limit The maximum number of records returned in the paginated response. (default to 10)
-    # @option opts [String] :sort_by The option to sort the SQL Tuning advisor task summary data. (default to START_TIME)
+    # @option opts [String] :sort_by The option to sort the SQL Tuning Advisor task summary data. (default to START_TIME)
     #   Allowed values are: NAME, START_TIME
     # @option opts [String] :sort_order The option to sort information in ascending (\u2018ASC\u2019) or descending (\u2018DESC\u2019) order. Descending order is the default order. (default to DESC)
     # @option opts [String] :opc_request_id The client request ID for tracing.
@@ -706,11 +710,10 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Start a SQL tuning task for a given set of SQLs from active session history
-    # top SQLs.
+    # Starts a SQL tuning task for a given set of SQL statements from the active session history top SQL statements.
     #
     # @param [String] managed_database_id The [OCID](https://docs.cloud.oracle.com/Content/General/Concepts/identifiers.htm) of the Managed Database.
-    # @param [OCI::DatabaseManagement::Models::StartSqlTuningTaskDetails] start_sql_tuning_task_details Detail inputs for starting a SQL tuning task
+    # @param [OCI::DatabaseManagement::Models::StartSqlTuningTaskDetails] start_sql_tuning_task_details The detailed inputs required to start a SQL tuning task.
     # @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/loggingsearch/log_search_client.rb

@@ -100,6 +100,8 @@ module OCI
 
     # Submit a query to search logs.
     #
+    # See [Using the API](https://docs.cloud.oracle.com/Content/Logging/Concepts/using_the_api_searchlogs.htm) for SDK examples.
+    #
     # @param [OCI::Loggingsearch::Models::SearchLogsDetails] search_logs_details Search request.
     #
     # @param [Hash] opts the optional parameters
@@ -110,7 +112,8 @@ module OCI
     #
     # @option opts [Integer] :limit The maximum number of items to return in a response. Pagination is not supported in this API.
     #    (default to 100)
-    # @option opts [String] :page Reserved for future use. Pagination is not supported in this API.
+    # @option opts [String] :page For list pagination. The value of the opc-next-page response header from the previous \"Search\" call.
+    #   For important details about how pagination works, see [List Pagination](https://docs.cloud.oracle.com/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.

data/lib/oci/marketplace/account_client.rb

@@ -6,7 +6,7 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Manage applications in Oracle Cloud Infrastructure Marketplace.
+  # Use the Marketplace API to manage applications in Oracle Cloud Infrastructure Marketplace. For more information, see [Overview of Marketplace](/Content/Marketplace/Concepts/marketoverview.htm)
   class Marketplace::AccountClient
     # Client used to make HTTP requests.
     # @return [OCI::ApiClient]

data/lib/oci/marketplace/marketplace_client.rb

@@ -6,7 +6,7 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # Manage applications in Oracle Cloud Infrastructure Marketplace.
+  # Use the Marketplace API to manage applications in Oracle Cloud Infrastructure Marketplace. For more information, see [Overview of Marketplace](/Content/Marketplace/Concepts/marketoverview.htm)
   class Marketplace::MarketplaceClient
     # Client used to make HTTP requests.
     # @return [OCI::ApiClient]
@@ -1042,6 +1042,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 [Array<String>] :name The name of the listing.
     # @option opts [String] :listing_id The unique identifier for the listing.
+    # @option opts [String] :image_id Image ID of the listing
     # @option opts [String] :publisher_id Limit results to just this publisher.
     # @option opts [String] :package_type A filter to return only packages that match the given package type exactly.
     #
@@ -1113,6 +1114,7 @@ module OCI
       query_params = {}
       query_params[:name] = OCI::ApiClient.build_collection_params(opts[:name], :multi) if opts[:name] && !opts[:name].empty?
       query_params[:listingId] = opts[:listing_id] if opts[:listing_id]
+      query_params[:imageId] = opts[:image_id] if opts[:image_id]
       query_params[:publisherId] = opts[:publisher_id] if opts[:publisher_id]
       query_params[:packageType] = opts[:package_type] if opts[:package_type]
       query_params[:limit] = opts[:limit] if opts[:limit]
@@ -1555,7 +1557,8 @@ module OCI
 
     # Lists reports in the compartment that match the specified report type and date.
     # @param [String] report_type The type of the report.
-    # @param [DateTime] date Date, expressed in `YYYYMMDD` format, where `Y` represents the year, `M` represents the month, and `D` represents the day.
+    # @param [DateTime] date Date, expressed in [RFC 3339](https://tools.ietf.org/html/rfc3339) timestamp format. The service only interprets the year, month, and day parts in the input value, and ignores the hour, minute, and second parts.
+    #
     # @param [String] compartment_id The unique identifier for the compartment.
     # @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
@@ -1675,8 +1678,8 @@ module OCI
     # rubocop:disable Metrics/MethodLength, Layout/EmptyLines
 
 
-    # Find listings that match the specified criteria. The search query could be free text
-    # or structured.
+    # Queries all Marketplace Applications to find listings that match the specified criteria. To search
+    # for a listing, you can use a free text or structured search.
     #
     # @param [OCI::Marketplace::Models::SearchListingsDetails] search_listings_details Details related to the search query
     # @param [Hash] opts the optional parameters

data/lib/oci/marketplace/models/free_text_search_details.rb

@@ -6,7 +6,8 @@ require_relative 'search_listings_details'
 
 # rubocop:disable Lint/UnneededCopDisableDirective, Metrics/LineLength
 module OCI
-  # The model for a request that uses Search's Free text.
+  # A request containing arbitrary text that must be present in the Marketplace Applications.
+  #
   class Marketplace::Models::FreeTextSearchDetails < Marketplace::Models::SearchListingsDetails
     # **[Required]** The text to search for.
     # @return [String]