oci 2.3.5 → 2.3.6

data/lib/oci/database/models/autonomous_data_warehouse_backup_summary.rb

@@ -8,6 +8,8 @@ module OCI
   # An Autonomous Data Warehouse backup.
   # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator. If you're an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::AutonomousDataWarehouseBackupSummary # rubocop:disable Metrics/LineLength
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_CREATING = 'CREATING'.freeze,
@@ -28,7 +30,7 @@ module OCI
     # @return [String]
     attr_accessor :autonomous_data_warehouse_id
 
-    # **[Required]** The OCID of the compartment.
+    # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/database/models/autonomous_data_warehouse_summary.rb

@@ -7,6 +7,8 @@ require 'logger'
 module OCI
   # An Oracle Autonomous Data Warehouse.
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::AutonomousDataWarehouseSummary # rubocop:disable Metrics/LineLength
     LICENSE_MODEL_ENUM = [
       LICENSE_MODEL_LICENSE_INCLUDED = 'LICENSE_INCLUDED'.freeze,
@@ -30,7 +32,7 @@ module OCI
       LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # **[Required]** The OCID of the compartment.
+    # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/database/models/autonomous_database.rb

@@ -7,6 +7,8 @@ require 'logger'
 module OCI
   # An Oracle Autonomous Database.
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::AutonomousDatabase # rubocop:disable Metrics/LineLength
     LICENSE_MODEL_ENUM = [
       LICENSE_MODEL_LICENSE_INCLUDED = 'LICENSE_INCLUDED'.freeze,
@@ -30,7 +32,7 @@ module OCI
       LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # **[Required]** The OCID of the compartment.
+    # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/database/models/autonomous_database_backup.rb

@@ -8,6 +8,8 @@ module OCI
   # An Autonomous Database backup.
   # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator. If you're an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::AutonomousDatabaseBackup # rubocop:disable Metrics/LineLength
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_CREATING = 'CREATING'.freeze,
@@ -28,7 +30,7 @@ module OCI
     # @return [String]
     attr_accessor :autonomous_database_id
 
-    # **[Required]** The OCID of the compartment.
+    # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/database/models/autonomous_database_backup_summary.rb

@@ -8,6 +8,8 @@ module OCI
   # An Autonomous Database backup.
   # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator. If you're an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::AutonomousDatabaseBackupSummary # rubocop:disable Metrics/LineLength
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_CREATING = 'CREATING'.freeze,
@@ -28,7 +30,7 @@ module OCI
     # @return [String]
     attr_accessor :autonomous_database_id
 
-    # **[Required]** The OCID of the compartment.
+    # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/database/models/autonomous_database_summary.rb

@@ -7,6 +7,8 @@ require 'logger'
 module OCI
   # An Oracle Autonomous Database.
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::AutonomousDatabaseSummary # rubocop:disable Metrics/LineLength
     LICENSE_MODEL_ENUM = [
       LICENSE_MODEL_LICENSE_INCLUDED = 'LICENSE_INCLUDED'.freeze,
@@ -30,7 +32,7 @@ module OCI
       LIFECYCLE_STATE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # **[Required]** The OCID of the compartment.
+    # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/database/models/backup.rb

@@ -5,9 +5,11 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
-  # A database backup
+  # A database backup.
   # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator. If you're an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::Backup # rubocop:disable Metrics/LineLength
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_CREATING = 'CREATING'.freeze,
@@ -25,33 +27,33 @@ module OCI
       TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # The name of the Availability Domain that the backup is located in.
+    # The name of the availability domain where the database backup is stored.
     # @return [String]
     attr_accessor :availability_domain
 
-    # The OCID of the compartment.
+    # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment.
     # @return [String]
     attr_accessor :compartment_id
 
-    # The Oracle Database Edition of the DbSystem on which the backup was taken.
+    # The Oracle Database edition of the DB system from which the database backup was taken.
     #
     # @return [String]
     attr_accessor :database_edition
 
-    # The OCID of the database.
+    # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the database.
     # @return [String]
     attr_accessor :database_id
 
-    # Size of the database in mega-bytes at the time the backup was taken.
+    # Size of the database in megabytes (MB) at the time the backup was taken.
     #
     # @return [Integer]
     attr_accessor :db_data_size_in_mbs
 
-    # The user-friendly name for the backup. It does not have to be unique.
+    # The user-friendly name for the backup. The name does not have to be unique.
     # @return [String]
     attr_accessor :display_name
 
-    # The OCID of the backup.
+    # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the backup.
     # @return [String]
     attr_accessor :id
 
@@ -67,7 +69,7 @@ module OCI
     # @return [DateTime]
     attr_accessor :time_ended
 
-    # The date and time the backup starts.
+    # The date and time the backup started.
     # @return [DateTime]
     attr_accessor :time_started
 

data/lib/oci/database/models/backup_summary.rb

@@ -5,9 +5,11 @@ require 'logger'
 
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
-  # A database backup
+  # A database backup.
   # To use any of the API operations, you must be authorized in an IAM policy. If you're not authorized, talk to an administrator. If you're an administrator who needs to write policies to give users access, see [Getting Started with Policies](https://docs.us-phoenix-1.oraclecloud.com/Content/Identity/Concepts/policygetstarted.htm).
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::BackupSummary # rubocop:disable Metrics/LineLength
     LIFECYCLE_STATE_ENUM = [
       LIFECYCLE_STATE_CREATING = 'CREATING'.freeze,
@@ -25,33 +27,33 @@ module OCI
       TYPE_UNKNOWN_ENUM_VALUE = 'UNKNOWN_ENUM_VALUE'.freeze
     ].freeze
 
-    # The name of the Availability Domain that the backup is located in.
+    # The name of the availability domain where the database backup is stored.
     # @return [String]
     attr_accessor :availability_domain
 
-    # The OCID of the compartment.
+    # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment.
     # @return [String]
     attr_accessor :compartment_id
 
-    # The Oracle Database Edition of the DbSystem on which the backup was taken.
+    # The Oracle Database edition of the DB system from which the database backup was taken.
     #
     # @return [String]
     attr_accessor :database_edition
 
-    # The OCID of the database.
+    # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the database.
     # @return [String]
     attr_accessor :database_id
 
-    # Size of the database in mega-bytes at the time the backup was taken.
+    # Size of the database in megabytes (MB) at the time the backup was taken.
     #
     # @return [Integer]
     attr_accessor :db_data_size_in_mbs
 
-    # The user-friendly name for the backup. It does not have to be unique.
+    # The user-friendly name for the backup. The name does not have to be unique.
     # @return [String]
     attr_accessor :display_name
 
-    # The OCID of the backup.
+    # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the backup.
     # @return [String]
     attr_accessor :id
 
@@ -67,7 +69,7 @@ module OCI
     # @return [DateTime]
     attr_accessor :time_ended
 
-    # The date and time the backup starts.
+    # The date and time the backup started.
     # @return [DateTime]
     attr_accessor :time_started
 

data/lib/oci/database/models/create_autonomous_data_warehouse_backup_details.rb

@@ -6,6 +6,8 @@ require 'date'
 module OCI
   # Details to create an Oracle Autonomous Data Warehouse backup.
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::CreateAutonomousDataWarehouseBackupDetails # rubocop:disable Metrics/LineLength
     # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the Autonomous Data Warehouse backup.
     # @return [String]

data/lib/oci/database/models/create_autonomous_data_warehouse_details.rb

@@ -6,6 +6,8 @@ require 'date'
 module OCI
   # Details to create an Oracle Autonomous Data Warehouse.
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::CreateAutonomousDataWarehouseDetails # rubocop:disable Metrics/LineLength
     LICENSE_MODEL_ENUM = [
       LICENSE_MODEL_LICENSE_INCLUDED = 'LICENSE_INCLUDED'.freeze,
@@ -16,7 +18,7 @@ module OCI
     # @return [String]
     attr_accessor :admin_password
 
-    # **[Required]** The Oracle Cloud ID (OCID) of the compartment of the DB system.
+    # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment of the Autonomous Data Warehouse.
     # @return [String]
     attr_accessor :compartment_id
 

data/lib/oci/database/models/create_autonomous_database_backup_details.rb

@@ -6,6 +6,8 @@ require 'date'
 module OCI
   # Details to create an Oracle Autonomous Database backup.
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::CreateAutonomousDatabaseBackupDetails # rubocop:disable Metrics/LineLength
     # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the Autonomous Database backup.
     # @return [String]

data/lib/oci/database/models/create_autonomous_database_details.rb

@@ -6,6 +6,8 @@ require 'date'
 module OCI
   # Details to create an Oracle Autonomous Database.
   #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::CreateAutonomousDatabaseDetails # rubocop:disable Metrics/LineLength
     LICENSE_MODEL_ENUM = [
       LICENSE_MODEL_LICENSE_INCLUDED = 'LICENSE_INCLUDED'.freeze,
@@ -16,7 +18,7 @@ module OCI
     # @return [String]
     attr_accessor :admin_password
 
-    # **[Required]** The Oracle Cloud ID (OCID) of the compartment of the DB system.
+    # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the compartment of the autonomous database.
     # @return [String]
     attr_accessor :compartment_id
 
@@ -24,7 +26,7 @@ module OCI
     # @return [Integer]
     attr_accessor :cpu_core_count
 
-    # **[Required]** Size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed.
+    # **[Required]** The size, in terabytes, of the data volume that will be created and attached to the database. This storage can later be scaled up if needed.
     #
     # @return [Integer]
     attr_accessor :data_storage_size_in_tbs

data/lib/oci/database/models/create_backup_details.rb

@@ -4,13 +4,16 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
-  # CreateBackupDetails model.
+  # Details for creating a database backup.
+  #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::CreateBackupDetails # rubocop:disable Metrics/LineLength
-    # **[Required]** The OCID of the database.
+    # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the database.
     # @return [String]
     attr_accessor :database_id
 
-    # **[Required]** The user-friendly name for the backup. It does not have to be unique.
+    # **[Required]** The user-friendly name for the backup. The name does not have to be unique.
     # @return [String]
     attr_accessor :display_name
 

data/lib/oci/database/models/create_data_guard_association_to_existing_db_system_details.rb

@@ -7,7 +7,7 @@ require_relative 'create_data_guard_association_details'
 module OCI
   # The configuration details for creating a Data Guard association to an existing database.
   class Database::Models::CreateDataGuardAssociationToExistingDbSystemDetails < Database::Models::CreateDataGuardAssociationDetails # rubocop:disable Metrics/LineLength
-    # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the DB System to create the standby database on.
+    # The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the DB system to create the standby database on.
     #
     # @return [String]
     attr_accessor :peer_db_system_id

data/lib/oci/database/models/create_database_details.rb

@@ -4,7 +4,10 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
-  # CreateDatabaseDetails model.
+  # Details for creating a database backup.
+  #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::CreateDatabaseDetails # rubocop:disable Metrics/LineLength
     DB_WORKLOAD_ENUM = [
       DB_WORKLOAD_OLTP = 'OLTP'.freeze,
@@ -17,7 +20,7 @@ module OCI
 
     # The character set for the database.  The default is AL32UTF8. Allowed values are:
     #
-    # AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
+    # AL32UTF8, AR8ADOS710, AR8ADOS720, AR8APTEC715, AR8ARABICMACS, AR8ASMO8X, AR8ISO8859P6, AR8MSWIN1256, AR8MUSSAD768, AR8NAFITHA711, AR8NAFITHA721, AR8SAKHR706, AR8SAKHR707, AZ8ISO8859P9E, BG8MSWIN, BG8PC437S, BLT8CP921, BLT8ISO8859P13, BLT8MSWIN1257, BLT8PC775, BN8BSCII, CDN8PC863, CEL8ISO8859P14, CL8ISO8859P5, CL8ISOIR111, CL8KOI8R, CL8KOI8U, CL8MACCYRILLICS, CL8MSWIN1251, EE8ISO8859P2, EE8MACCES, EE8MACCROATIANS, EE8MSWIN1250, EE8PC852, EL8DEC, EL8ISO8859P7, EL8MACGREEKS, EL8MSWIN1253, EL8PC437S, EL8PC851, EL8PC869, ET8MSWIN923, HU8ABMOD, HU8CWI2, IN8ISCII, IS8PC861, IW8ISO8859P8, IW8MACHEBREWS, IW8MSWIN1255, IW8PC1507, JA16EUC, JA16EUCTILDE, JA16SJIS, JA16SJISTILDE, JA16VMS, KO16KSC5601, KO16KSCCS, KO16MSWIN949, LA8ISO6937, LA8PASSPORT, LT8MSWIN921, LT8PC772, LT8PC774, LV8PC1117, LV8PC8LR, LV8RST104090, N8PC865, NE8ISO8859P10, NEE8ISO8859P4, RU8BESTA, RU8PC855, RU8PC866, SE8ISO8859P3, TH8MACTHAIS, TH8TISASCII, TR8DEC, TR8MACTURKISHS, TR8MSWIN1254, TR8PC857, US7ASCII, US8PC437, UTF8, VN8MSWIN1258, VN8VN3, WE8DEC, WE8DG, WE8ISO8859P1, WE8ISO8859P15, WE8ISO8859P9, WE8MACROMAN8S, WE8MSWIN1252, WE8NCR4970, WE8NEXTSTEP, WE8PC850, WE8PC858, WE8PC860, WE8ROMAN8, ZHS16CGB231280, ZHS16GBK, ZHT16BIG5, ZHT16CCDC, ZHT16DBT, ZHT16HKSCS, ZHT16MSWIN950, ZHT32EUC, ZHT32SOPS, ZHT32TRIS
     #
     # @return [String]
     attr_accessor :character_set
@@ -25,11 +28,11 @@ module OCI
     # @return [OCI::Database::Models::DbBackupConfig]
     attr_accessor :db_backup_config
 
-    # **[Required]** The database name. It must begin with an alphabetic character and can contain a maximum of eight alphanumeric characters. Special characters are not permitted.
+    # **[Required]** The database name. The name must begin with an alphabetic character and can contain a maximum of eight alphanumeric characters. Special characters are not permitted.
     # @return [String]
     attr_accessor :db_name
 
-    # Database workload type.
+    # The database workload type.
     # @return [String]
     attr_reader :db_workload
 
@@ -49,13 +52,13 @@ module OCI
     # @return [Hash<String, String>]
     attr_accessor :freeform_tags
 
-    # National character set for the database.  The default is AL16UTF16. Allowed values are:
+    # The national character set for the database.  The default is AL16UTF16. Allowed values are:
     # AL16UTF16 or UTF8.
     #
     # @return [String]
     attr_accessor :ncharacter_set
 
-    # Pluggable database name. It must begin with an alphabetic character and can contain a maximum of eight alphanumeric characters. Special characters are not permitted. Pluggable database should not be same as database name.
+    # The name of the pluggable database. The name must begin with an alphabetic character and can contain a maximum of eight alphanumeric characters. Special characters are not permitted. Pluggable database should not be same as database name.
     # @return [String]
     attr_accessor :pdb_name
 

data/lib/oci/database/models/create_database_from_backup_details.rb

@@ -10,7 +10,7 @@ module OCI
     # @return [String]
     attr_accessor :admin_password
 
-    # **[Required]** The backup OCID.
+    # **[Required]** The backup [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm).
     # @return [String]
     attr_accessor :backup_id
 

data/lib/oci/database/models/create_db_home_details.rb

@@ -4,13 +4,16 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
-  # CreateDbHomeDetails model.
+  # Details for creating a database home.
+  #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::CreateDbHomeDetails # rubocop:disable Metrics/LineLength
     # This attribute is required.
     # @return [OCI::Database::Models::CreateDatabaseDetails]
     attr_accessor :database
 
-    # **[Required]** A valid Oracle database version. To get a list of supported versions, use the {#list_db_versions list_db_versions} operation.
+    # **[Required]** A valid Oracle Database version. To get a list of supported versions, use the {#list_db_versions list_db_versions} operation.
     # @return [String]
     attr_accessor :db_version
 

data/lib/oci/database/models/create_db_home_from_backup_details.rb

@@ -4,7 +4,10 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
-  # CreateDbHomeFromBackupDetails model.
+  # Details for creating a database home if you are creating a database by restoring from a database backup.
+  #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   class Database::Models::CreateDbHomeFromBackupDetails # rubocop:disable Metrics/LineLength
     # This attribute is required.
     # @return [OCI::Database::Models::CreateDatabaseFromBackupDetails]

data/lib/oci/database/models/create_db_home_with_db_system_id_base.rb

@@ -4,7 +4,10 @@ require 'date'
 
 # rubocop:disable Lint/UnneededCopDisableDirective
 module OCI
-  # CreateDbHomeWithDbSystemIdBase model.
+  # Details for creating a database home.
+  #
+  # **Warning:** Oracle recommends that you avoid using any confidential information when you supply string values using the API.
+  #
   # This class has direct subclasses. If you are using this class as input to a service operations then you should favor using a subclass over the base class
   class Database::Models::CreateDbHomeWithDbSystemIdBase # rubocop:disable Metrics/LineLength
     SOURCE_ENUM = [
@@ -12,7 +15,7 @@ module OCI
       SOURCE_DB_BACKUP = 'DB_BACKUP'.freeze
     ].freeze
 
-    # **[Required]** The OCID of the DB System.
+    # **[Required]** The [OCID](https://docs.us-phoenix-1.oraclecloud.com/Content/General/Concepts/identifiers.htm) of the DB system.
     # @return [String]
     attr_accessor :db_system_id
 
@@ -20,9 +23,7 @@ module OCI
     # @return [String]
     attr_accessor :display_name
 
-    # Source of database:
-    #   NONE for creating a new database
-    #   DB_BACKUP for creating a new database by restoring a backup
+    # The source of database: NONE for creating a new database. DB_BACKUP for creating a new database by restoring from a database backup.
     #
     # @return [String]
     attr_reader :source