aws-sdk-rds 1.185.0 → 1.187.0

data/lib/aws-sdk-rds/db_instance.rb

@@ -72,17 +72,10 @@ module Aws::RDS
       data[:master_username]
     end
 
-    # The meaning of this parameter differs depending on the database
-    # engine.
-    #
-    # * For RDS for MariaDB, Microsoft SQL Server, MySQL, and PostgreSQL -
-    #   The name of the initial database specified for this DB instance when
-    #   it was created, if one was provided. This same name is returned for
-    #   the life of the DB instance.
-    #
-    # * For RDS for Oracle - The Oracle System ID (SID) of the created DB
-    #   instance. This value is only returned when the object returned is an
-    #   Oracle DB instance.
+    # Contains the initial database name that you provided (if required)
+    # when you created the DB instance. This name is returned for the life
+    # of your DB instance. For an RDS for Oracle CDB instance, the name
+    # identifies the PDB rather than the CDB.
     # @return [String]
     def db_name
       data[:db_name]
@@ -758,6 +751,12 @@ module Aws::RDS
       data[:read_replica_source_db_cluster_identifier]
     end
 
+    # The progress of the storage optimization operation as a percentage.
+    # @return [String]
+    def percent_progress
+      data[:percent_progress]
+    end
+
     # @!endgroup
 
     # @return [Client]
@@ -967,119 +966,124 @@ module Aws::RDS
     #     manage_master_user_password: false,
     #     master_user_secret_kms_key_id: "String",
     #     ca_certificate_identifier: "String",
+    #     db_system_id: "String",
     #   })
     # @param [Hash] options ({})
     # @option options [String] :db_name
-    #   The meaning of this parameter differs depending on the database
-    #   engine.
-    #
-    #   Amazon Aurora MySQL
+    #   The meaning of this parameter differs according to the database engine
+    #   you use.
     #
-    #   : The name of the database to create when the primary DB instance of
-    #     the Aurora MySQL DB cluster is created. If you don't specify a
-    #     value, Amazon RDS doesn't create a database in the DB cluster.
+    #   **MySQL**
     #
-    #     Constraints:
+    #   The name of the database to create when the DB instance is created. If
+    #   this parameter isn't specified, no database is created in the DB
+    #   instance.
     #
-    #     * Must contain 1 to 64 alphanumeric characters.
+    #   Constraints:
     #
-    #     * Can't be a word reserved by the database engine.
+    #   * Must contain 1 to 64 letters or numbers.
     #
-    #   Amazon Aurora PostgreSQL
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
     #
-    #   : The name of the database to create when the primary DB instance of
-    #     the Aurora PostgreSQL DB cluster is created.
+    #   * Can't be a word reserved by the specified database engine
     #
-    #     Default: `postgres`
+    #   **MariaDB**
     #
-    #     Constraints:
+    #   The name of the database to create when the DB instance is created. If
+    #   this parameter isn't specified, no database is created in the DB
+    #   instance.
     #
-    #     * Must contain 1 to 63 alphanumeric characters.
+    #   Constraints:
     #
-    #     * Must begin with a letter. Subsequent characters can be letters,
-    #       underscores, or digits (0 to 9).
+    #   * Must contain 1 to 64 letters or numbers.
     #
-    #     * Can't be a word reserved by the database engine.
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
     #
-    #   Amazon RDS Custom for Oracle
+    #   * Can't be a word reserved by the specified database engine
     #
-    #   : The Oracle System ID (SID) of the created RDS Custom DB instance.
+    #   **PostgreSQL**
     #
-    #     Default: `ORCL`
+    #   The name of the database to create when the DB instance is created. If
+    #   this parameter isn't specified, a database named `postgres` is
+    #   created in the DB instance.
     #
-    #     Constraints:
+    #   Constraints:
     #
-    #     * Must contain 1 to 8 alphanumeric characters.
+    #   * Must contain 1 to 63 letters, numbers, or underscores.
     #
-    #     * Must contain a letter.
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
     #
-    #     * Can't be a word reserved by the database engine.
+    #   * Can't be a word reserved by the specified database engine
     #
-    #   Amazon RDS Custom for SQL Server
+    #   **Oracle**
     #
-    #   : Not applicable. Must be null.
+    #   The Oracle System ID (SID) of the created DB instance. If you don't
+    #   specify a value, the default value is `ORCL`. You can't specify the
+    #   string `null`, or any other reserved word, for `DBName`.
     #
-    #   RDS for MariaDB
+    #   Default: `ORCL`
     #
-    #   : The name of the database to create when the DB instance is created.
-    #     If you don't specify a value, Amazon RDS doesn't create a database
-    #     in the DB instance.
-    #
-    #     Constraints:
+    #   Constraints:
     #
-    #     * Must contain 1 to 64 letters or numbers.
+    #   * Can't be longer than 8 characters
     #
-    #     * Must begin with a letter. Subsequent characters can be letters,
-    #       underscores, or digits (0-9).
+    #   ^
     #
-    #     * Can't be a word reserved by the database engine.
+    #   **Amazon RDS Custom for Oracle**
     #
-    #   RDS for MySQL
+    #   The Oracle System ID (SID) of the created RDS Custom DB instance. If
+    #   you don't specify a value, the default value is `ORCL` for non-CDBs
+    #   and `RDSCDB` for CDBs.
     #
-    #   : The name of the database to create when the DB instance is created.
-    #     If you don't specify a value, Amazon RDS doesn't create a database
-    #     in the DB instance.
+    #   Default: `ORCL`
     #
-    #     Constraints:
+    #   Constraints:
     #
-    #     * Must contain 1 to 64 letters or numbers.
+    #   * It must contain 1 to 8 alphanumeric characters.
     #
-    #     * Must begin with a letter. Subsequent characters can be letters,
-    #       underscores, or digits (0-9).
+    #   * It must contain a letter.
     #
-    #     * Can't be a word reserved by the database engine.
+    #   * It can't be a word reserved by the database engine.
     #
-    #   RDS for Oracle
+    #   **Amazon RDS Custom for SQL Server**
     #
-    #   : The Oracle System ID (SID) of the created DB instance.
+    #   Not applicable. Must be null.
     #
-    #     Default: `ORCL`
+    #   **SQL Server**
     #
-    #     Constraints:
+    #   Not applicable. Must be null.
     #
-    #     * Can't be longer than 8 characters.
+    #   **Amazon Aurora MySQL**
     #
-    #     * Can't be a word reserved by the database engine, such as the
-    #       string `NULL`.
+    #   The name of the database to create when the primary DB instance of the
+    #   Aurora MySQL DB cluster is created. If this parameter isn't specified
+    #   for an Aurora MySQL DB cluster, no database is created in the DB
+    #   cluster.
     #
-    #   RDS for PostgreSQL
+    #   Constraints:
     #
-    #   : The name of the database to create when the DB instance is created.
+    #   * It must contain 1 to 64 alphanumeric characters.
     #
-    #     Default: `postgres`
+    #   * It can't be a word reserved by the database engine.
     #
-    #     Constraints:
+    #   **Amazon Aurora PostgreSQL**
     #
-    #     * Must contain 1 to 63 letters, numbers, or underscores.
+    #   The name of the database to create when the primary DB instance of the
+    #   Aurora PostgreSQL DB cluster is created. If this parameter isn't
+    #   specified for an Aurora PostgreSQL DB cluster, a database named
+    #   `postgres` is created in the DB cluster.
     #
-    #     * Must begin with a letter. Subsequent characters can be letters,
-    #       underscores, or digits (0-9).
+    #   Constraints:
     #
-    #     * Can't be a word reserved by the database engine.
+    #   * It must contain 1 to 63 alphanumeric characters.
     #
-    #   RDS for SQL Server
+    #   * It must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0 to 9).
     #
-    #   : Not applicable. Must be null.
+    #   * It can't be a word reserved by the database engine.
     # @option options [Integer] :allocated_storage
     #   The amount of storage in gibibytes (GiB) to allocate for the DB
     #   instance.
@@ -2054,6 +2058,13 @@ module Aws::RDS
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html
     #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html
+    # @option options [String] :db_system_id
+    #   The Oracle system identifier (SID), which is the name of the Oracle
+    #   database instance that manages your database files. In this context,
+    #   the term "Oracle database instance" refers exclusively to the system
+    #   global area (SGA) and Oracle background processes. If you don't
+    #   specify a SID, the value defaults to `RDSCDB`. The Oracle SID is also
+    #   the name of your CDB.
     # @return [DBInstance]
     def create(options = {})
       options = options.merge(db_instance_identifier: @id)
@@ -3314,7 +3325,7 @@ module Aws::RDS
     #
     #   This setting doesn't apply to RDS Custom DB instances.
     # @option options [String] :ca_certificate_identifier
-    #   The CA certificate identifier to use for the DB instance6's server
+    #   The CA certificate identifier to use for the DB instance's server
     #   certificate.
     #
     #   This setting doesn't apply to RDS Custom DB instances.

data/lib/aws-sdk-rds/db_snapshot.rb

@@ -265,6 +265,14 @@ module Aws::RDS
       data[:storage_throughput]
     end
 
+    # The Oracle system identifier (SID), which is the name of the Oracle
+    # database instance that manages your database files. The Oracle SID is
+    # also the name of your CDB.
+    # @return [String]
+    def db_system_id
+      data[:db_system_id]
+    end
+
     # @!endgroup
 
     # @return [Client]

data/lib/aws-sdk-rds/resource.rb

@@ -1022,119 +1022,124 @@ module Aws::RDS
     #     manage_master_user_password: false,
     #     master_user_secret_kms_key_id: "String",
     #     ca_certificate_identifier: "String",
+    #     db_system_id: "String",
     #   })
     # @param [Hash] options ({})
     # @option options [String] :db_name
-    #   The meaning of this parameter differs depending on the database
-    #   engine.
-    #
-    #   Amazon Aurora MySQL
-    #
-    #   : The name of the database to create when the primary DB instance of
-    #     the Aurora MySQL DB cluster is created. If you don't specify a
-    #     value, Amazon RDS doesn't create a database in the DB cluster.
+    #   The meaning of this parameter differs according to the database engine
+    #   you use.
     #
-    #     Constraints:
+    #   **MySQL**
     #
-    #     * Must contain 1 to 64 alphanumeric characters.
+    #   The name of the database to create when the DB instance is created. If
+    #   this parameter isn't specified, no database is created in the DB
+    #   instance.
     #
-    #     * Can't be a word reserved by the database engine.
+    #   Constraints:
     #
-    #   Amazon Aurora PostgreSQL
+    #   * Must contain 1 to 64 letters or numbers.
     #
-    #   : The name of the database to create when the primary DB instance of
-    #     the Aurora PostgreSQL DB cluster is created.
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
     #
-    #     Default: `postgres`
+    #   * Can't be a word reserved by the specified database engine
     #
-    #     Constraints:
+    #   **MariaDB**
     #
-    #     * Must contain 1 to 63 alphanumeric characters.
+    #   The name of the database to create when the DB instance is created. If
+    #   this parameter isn't specified, no database is created in the DB
+    #   instance.
     #
-    #     * Must begin with a letter. Subsequent characters can be letters,
-    #       underscores, or digits (0 to 9).
+    #   Constraints:
     #
-    #     * Can't be a word reserved by the database engine.
+    #   * Must contain 1 to 64 letters or numbers.
     #
-    #   Amazon RDS Custom for Oracle
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
     #
-    #   : The Oracle System ID (SID) of the created RDS Custom DB instance.
+    #   * Can't be a word reserved by the specified database engine
     #
-    #     Default: `ORCL`
+    #   **PostgreSQL**
     #
-    #     Constraints:
+    #   The name of the database to create when the DB instance is created. If
+    #   this parameter isn't specified, a database named `postgres` is
+    #   created in the DB instance.
     #
-    #     * Must contain 1 to 8 alphanumeric characters.
+    #   Constraints:
     #
-    #     * Must contain a letter.
+    #   * Must contain 1 to 63 letters, numbers, or underscores.
     #
-    #     * Can't be a word reserved by the database engine.
+    #   * Must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0-9).
     #
-    #   Amazon RDS Custom for SQL Server
+    #   * Can't be a word reserved by the specified database engine
     #
-    #   : Not applicable. Must be null.
+    #   **Oracle**
     #
-    #   RDS for MariaDB
+    #   The Oracle System ID (SID) of the created DB instance. If you don't
+    #   specify a value, the default value is `ORCL`. You can't specify the
+    #   string `null`, or any other reserved word, for `DBName`.
     #
-    #   : The name of the database to create when the DB instance is created.
-    #     If you don't specify a value, Amazon RDS doesn't create a database
-    #     in the DB instance.
+    #   Default: `ORCL`
     #
-    #     Constraints:
+    #   Constraints:
     #
-    #     * Must contain 1 to 64 letters or numbers.
+    #   * Can't be longer than 8 characters
     #
-    #     * Must begin with a letter. Subsequent characters can be letters,
-    #       underscores, or digits (0-9).
+    #   ^
     #
-    #     * Can't be a word reserved by the database engine.
+    #   **Amazon RDS Custom for Oracle**
     #
-    #   RDS for MySQL
+    #   The Oracle System ID (SID) of the created RDS Custom DB instance. If
+    #   you don't specify a value, the default value is `ORCL` for non-CDBs
+    #   and `RDSCDB` for CDBs.
     #
-    #   : The name of the database to create when the DB instance is created.
-    #     If you don't specify a value, Amazon RDS doesn't create a database
-    #     in the DB instance.
+    #   Default: `ORCL`
     #
-    #     Constraints:
+    #   Constraints:
     #
-    #     * Must contain 1 to 64 letters or numbers.
+    #   * It must contain 1 to 8 alphanumeric characters.
     #
-    #     * Must begin with a letter. Subsequent characters can be letters,
-    #       underscores, or digits (0-9).
+    #   * It must contain a letter.
     #
-    #     * Can't be a word reserved by the database engine.
+    #   * It can't be a word reserved by the database engine.
     #
-    #   RDS for Oracle
+    #   **Amazon RDS Custom for SQL Server**
     #
-    #   : The Oracle System ID (SID) of the created DB instance.
+    #   Not applicable. Must be null.
     #
-    #     Default: `ORCL`
+    #   **SQL Server**
     #
-    #     Constraints:
+    #   Not applicable. Must be null.
     #
-    #     * Can't be longer than 8 characters.
+    #   **Amazon Aurora MySQL**
     #
-    #     * Can't be a word reserved by the database engine, such as the
-    #       string `NULL`.
+    #   The name of the database to create when the primary DB instance of the
+    #   Aurora MySQL DB cluster is created. If this parameter isn't specified
+    #   for an Aurora MySQL DB cluster, no database is created in the DB
+    #   cluster.
     #
-    #   RDS for PostgreSQL
+    #   Constraints:
     #
-    #   : The name of the database to create when the DB instance is created.
+    #   * It must contain 1 to 64 alphanumeric characters.
     #
-    #     Default: `postgres`
+    #   * It can't be a word reserved by the database engine.
     #
-    #     Constraints:
+    #   **Amazon Aurora PostgreSQL**
     #
-    #     * Must contain 1 to 63 letters, numbers, or underscores.
+    #   The name of the database to create when the primary DB instance of the
+    #   Aurora PostgreSQL DB cluster is created. If this parameter isn't
+    #   specified for an Aurora PostgreSQL DB cluster, a database named
+    #   `postgres` is created in the DB cluster.
     #
-    #     * Must begin with a letter. Subsequent characters can be letters,
-    #       underscores, or digits (0-9).
+    #   Constraints:
     #
-    #     * Can't be a word reserved by the database engine.
+    #   * It must contain 1 to 63 alphanumeric characters.
     #
-    #   RDS for SQL Server
+    #   * It must begin with a letter. Subsequent characters can be letters,
+    #     underscores, or digits (0 to 9).
     #
-    #   : Not applicable. Must be null.
+    #   * It can't be a word reserved by the database engine.
     # @option options [required, String] :db_instance_identifier
     #   The identifier for this DB instance. This parameter is stored as a
     #   lowercase string.
@@ -2122,6 +2127,13 @@ module Aws::RDS
     #
     #   [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html
     #   [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html
+    # @option options [String] :db_system_id
+    #   The Oracle system identifier (SID), which is the name of the Oracle
+    #   database instance that manages your database files. In this context,
+    #   the term "Oracle database instance" refers exclusively to the system
+    #   global area (SGA) and Oracle background processes. If you don't
+    #   specify a SID, the value defaults to `RDSCDB`. The Oracle SID is also
+    #   the name of your CDB.
     # @return [DBInstance]
     def create_db_instance(options = {})
       resp = Aws::Plugins::UserAgent.feature('resource') do