aws-sdk-rds 1.185.0 → 1.186.0

checksums.yaml

@@ -1,7 +1,7 @@
 ---
 SHA256:
-  metadata.gz: bea18a61eb6f0600ab2f5d8aa3d64d878198fe96ee37dc2044ad0d0b60cbd79e
-  data.tar.gz: 6cf9ee3babf8886dcb0895fac87531389e9627ab592ab0bce581eb18412681c6
+  metadata.gz: efd9d17718aa719882310f48c5d7da23605d2ceae9e83f8318a09a13f38c6ae4
+  data.tar.gz: 184eee7de899410e55afb514ae8a45505bb5b0a9f52e24867cf601a0b95caa40
 SHA512:
-  metadata.gz: 793af81fc241f9dea6834d994b11584f531b38a0211b0d8c3d856e0c26e113f2f807c007fbcd7450e1bf2f003c27e3e4ace20d916005b45b40b2d735b18f5a1d
-  data.tar.gz: 943a0396ab8269734e8099082e6f15e5c99e779e21d178d474d4fe5e07398948e5a38b75e77e9ed60ba501f1e00f33dfba725101dab2e9ea3e26b6d66222c9ef
+  metadata.gz: 524a549a2247761cf0e5f5107044f077e81b3875ff50e848e0d194d1d873e98e60a1c08b27ee34927861cd5a0022e011a66cdda5201e719787344c844badd013
+  data.tar.gz: ee219654f6a5580626b899a84ff68fc4f5906e6e15f05c0e7ceddf41249db26ff463540d9f4d0ba156b68cfa6998390813be8cd0c9f026732efa2aca6cd23dba

data/CHANGELOG.md

@@ -1,6 +1,11 @@
 Unreleased Changes
 ------------------
 
+1.186.0 (2023-07-21)
+------------------
+
+* Feature - Adds support for the DBSystemID parameter of CreateDBInstance to RDS Custom for Oracle.
+
 1.185.0 (2023-07-11)
 ------------------
 

data/VERSION

@@ -1 +1 @@
-1.185.0
+1.186.0

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

@@ -1820,6 +1820,7 @@ module Aws::RDS
     #   resp.db_snapshot.snapshot_database_time #=> Time
     #   resp.db_snapshot.snapshot_target #=> String
     #   resp.db_snapshot.storage_throughput #=> Integer
+    #   resp.db_snapshot.db_system_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBSnapshot AWS API Documentation
     #
@@ -4008,116 +4009,120 @@ module Aws::RDS
     # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html
     #
     # @option params [String] :db_name
-    #   The meaning of this parameter differs depending on the database
-    #   engine.
+    #   The meaning of this parameter differs according to the database engine
+    #   you use.
     #
-    #   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.
-    #
-    #     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 params [required, String] :db_instance_identifier
     #   The identifier for this DB instance. This parameter is stored as a
@@ -5164,6 +5169,14 @@ 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 params [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 [Types::CreateDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
     #   * {Types::CreateDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -5350,6 +5363,7 @@ module Aws::RDS
     #     manage_master_user_password: false,
     #     master_user_secret_kms_key_id: "String",
     #     ca_certificate_identifier: "String",
+    #     db_system_id: "String",
     #   })
     #
     # @example Response structure
@@ -7017,6 +7031,7 @@ module Aws::RDS
     #   resp.db_snapshot.snapshot_database_time #=> Time
     #   resp.db_snapshot.snapshot_target #=> String
     #   resp.db_snapshot.storage_throughput #=> Integer
+    #   resp.db_snapshot.db_system_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSnapshot AWS API Documentation
     #
@@ -7646,7 +7661,7 @@ module Aws::RDS
     # Deletes a blue/green deployment.
     #
     # For more information, see [Using Amazon RDS Blue/Green Deployments for
-    # database updates][1] in the *Amazon RDS User Guide* and [ Using Amazon
+    # database updates][1] in the *Amazon RDS User Guide* and [Using Amazon
     # RDS Blue/Green Deployments for database updates][2] in the *Amazon
     # Aurora User Guide*.
     #
@@ -7656,8 +7671,8 @@ module Aws::RDS
     # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html
     #
     # @option params [required, String] :blue_green_deployment_identifier
-    #   The blue/green deployment identifier of the deployment to be deleted.
-    #   This parameter isn't case-sensitive.
+    #   The unique identifier of the blue/green deployment to delete. This
+    #   parameter isn't case-sensitive.
     #
     #   Constraints:
     #
@@ -7666,9 +7681,9 @@ module Aws::RDS
     #   ^
     #
     # @option params [Boolean] :delete_target
-    #   A value that indicates whether to delete the resources in the green
-    #   environment. You can't specify this option if the blue/green
-    #   deployment [status][1] is `SWITCHOVER_COMPLETED`.
+    #   Specifies whether to delete the resources in the green environment.
+    #   You can't specify this option if the blue/green deployment
+    #   [status][1] is `SWITCHOVER_COMPLETED`.
     #
     #
     #
@@ -9163,6 +9178,7 @@ module Aws::RDS
     #   resp.db_snapshot.snapshot_database_time #=> Time
     #   resp.db_snapshot.snapshot_target #=> String
     #   resp.db_snapshot.storage_throughput #=> Integer
+    #   resp.db_snapshot.db_system_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSnapshot AWS API Documentation
     #
@@ -9550,7 +9566,7 @@ module Aws::RDS
       req.send_request(options)
     end
 
-    # Returns information about blue/green deployments.
+    # Describes one or more blue/green deployments.
     #
     # For more information, see [Using Amazon RDS Blue/Green Deployments for
     # database updates][1] in the *Amazon RDS User Guide* and [ Using Amazon
@@ -9563,14 +9579,13 @@ module Aws::RDS
     # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html
     #
     # @option params [String] :blue_green_deployment_identifier
-    #   The blue/green deployment identifier. If this parameter is specified,
-    #   information from only the specific blue/green deployment is returned.
-    #   This parameter isn't case-sensitive.
+    #   The blue/green deployment identifier. If you specify this parameter,
+    #   the response only includes information about the specific blue/green
+    #   deployment. This parameter isn't case-sensitive.
     #
     #   Constraints:
     #
-    #   * If supplied, must match an existing blue/green deployment
-    #     identifier.
+    #   * Must match an existing blue/green deployment identifier.
     #
     #   ^
     #
@@ -9578,7 +9593,7 @@ module Aws::RDS
     #   A filter that specifies one or more blue/green deployments to
     #   describe.
     #
-    #   Supported filters:
+    #   Valid Values:
     #
     #   * `blue-green-deployment-identifier` - Accepts system-generated
     #     identifiers for blue/green deployments. The results list only
@@ -9599,9 +9614,9 @@ module Aws::RDS
     #
     # @option params [String] :marker
     #   An optional pagination token provided by a previous
-    #   `DescribeBlueGreenDeployments` request. If this parameter is
-    #   specified, the response includes only records beyond the marker, up to
-    #   the value specified by `MaxRecords`.
+    #   `DescribeBlueGreenDeployments` request. If you specify this parameter,
+    #   the response only includes records beyond the marker, up to the value
+    #   specified by `MaxRecords`.
     #
     # @option params [Integer] :max_records
     #   The maximum number of records to include in the response. If more
@@ -9611,7 +9626,11 @@ module Aws::RDS
     #
     #   Default: 100
     #
-    #   Constraints: Minimum 20, maximum 100.
+    #   Constraints:
+    #
+    #   * Must be a minimum of 20.
+    #
+    #   * Can't exceed 100.
     #
     # @return [Types::DescribeBlueGreenDeploymentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
     #
@@ -13027,6 +13046,7 @@ module Aws::RDS
     #   resp.db_snapshots[0].snapshot_database_time #=> Time
     #   resp.db_snapshots[0].snapshot_target #=> String
     #   resp.db_snapshots[0].storage_throughput #=> Integer
+    #   resp.db_snapshots[0].db_system_id #=> String
     #
     #
     # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -19426,6 +19446,7 @@ module Aws::RDS
     #   resp.db_snapshot.snapshot_database_time #=> Time
     #   resp.db_snapshot.snapshot_target #=> String
     #   resp.db_snapshot.storage_throughput #=> Integer
+    #   resp.db_snapshot.db_system_id #=> String
     #
     # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshot AWS API Documentation
     #
@@ -27441,7 +27462,7 @@ module Aws::RDS
     # routed to the databases in the green environment.
     #
     # For more information, see [Using Amazon RDS Blue/Green Deployments for
-    # database updates][1] in the *Amazon RDS User Guide* and [ Using Amazon
+    # database updates][1] in the *Amazon RDS User Guide* and [Using Amazon
     # RDS Blue/Green Deployments for database updates][2] in the *Amazon
     # Aurora User Guide*.
     #
@@ -27451,7 +27472,7 @@ module Aws::RDS
     # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html
     #
     # @option params [required, String] :blue_green_deployment_identifier
-    #   The blue/green deployment identifier.
+    #   The unique identifier of the blue/green deployment.
     #
     #   Constraints:
     #
@@ -27460,8 +27481,9 @@ module Aws::RDS
     #   ^
     #
     # @option params [Integer] :switchover_timeout
-    #   The amount of time, in seconds, for the switchover to complete. The
-    #   default is 300.
+    #   The amount of time, in seconds, for the switchover to complete.
+    #
+    #   Default: 300
     #
     #   If the switchover takes longer than the specified duration, then any
     #   changes are rolled back, and no changes are made to the environments.
@@ -27844,7 +27866,7 @@ module Aws::RDS
         params: params,
         config: config)
       context[:gem_name] = 'aws-sdk-rds'
-      context[:gem_version] = '1.185.0'
+      context[:gem_version] = '1.186.0'
       Seahorse::Client::Request.new(handlers, context)
     end
 

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

@@ -1032,6 +1032,7 @@ module Aws::RDS
     CreateDBInstanceMessage.add_member(:manage_master_user_password, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "ManageMasterUserPassword"))
     CreateDBInstanceMessage.add_member(:master_user_secret_kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "MasterUserSecretKmsKeyId"))
     CreateDBInstanceMessage.add_member(:ca_certificate_identifier, Shapes::ShapeRef.new(shape: String, location_name: "CACertificateIdentifier"))
+    CreateDBInstanceMessage.add_member(:db_system_id, Shapes::ShapeRef.new(shape: String, location_name: "DBSystemId"))
     CreateDBInstanceMessage.struct_class = Types::CreateDBInstanceMessage
 
     CreateDBInstanceReadReplicaMessage.add_member(:db_instance_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBInstanceIdentifier"))
@@ -1785,6 +1786,7 @@ module Aws::RDS
     DBSnapshot.add_member(:snapshot_database_time, Shapes::ShapeRef.new(shape: TStamp, location_name: "SnapshotDatabaseTime"))
     DBSnapshot.add_member(:snapshot_target, Shapes::ShapeRef.new(shape: String, location_name: "SnapshotTarget"))
     DBSnapshot.add_member(:storage_throughput, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "StorageThroughput"))
+    DBSnapshot.add_member(:db_system_id, Shapes::ShapeRef.new(shape: String, location_name: "DBSystemId"))
     DBSnapshot.struct_class = Types::DBSnapshot
 
     DBSnapshotAlreadyExistsFault.struct_class = Types::DBSnapshotAlreadyExistsFault

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]
@@ -967,119 +960,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:
-    #
-    #     * 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 [Integer] :allocated_storage
     #   The amount of storage in gibibytes (GiB) to allocate for the DB
     #   instance.
@@ -2054,6 +2052,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)