aws-sdk-rds 1.185.0 → 1.186.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
checksums.yaml CHANGED
@@ -1,7 +1,7 @@
1
1
  ---
2
2
  SHA256:
3
- metadata.gz: bea18a61eb6f0600ab2f5d8aa3d64d878198fe96ee37dc2044ad0d0b60cbd79e
4
- data.tar.gz: 6cf9ee3babf8886dcb0895fac87531389e9627ab592ab0bce581eb18412681c6
3
+ metadata.gz: efd9d17718aa719882310f48c5d7da23605d2ceae9e83f8318a09a13f38c6ae4
4
+ data.tar.gz: 184eee7de899410e55afb514ae8a45505bb5b0a9f52e24867cf601a0b95caa40
5
5
  SHA512:
6
- metadata.gz: 793af81fc241f9dea6834d994b11584f531b38a0211b0d8c3d856e0c26e113f2f807c007fbcd7450e1bf2f003c27e3e4ace20d916005b45b40b2d735b18f5a1d
7
- data.tar.gz: 943a0396ab8269734e8099082e6f15e5c99e779e21d178d474d4fe5e07398948e5a38b75e77e9ed60ba501f1e00f33dfba725101dab2e9ea3e26b6d66222c9ef
6
+ metadata.gz: 524a549a2247761cf0e5f5107044f077e81b3875ff50e848e0d194d1d873e98e60a1c08b27ee34927861cd5a0022e011a66cdda5201e719787344c844badd013
7
+ data.tar.gz: ee219654f6a5580626b899a84ff68fc4f5906e6e15f05c0e7ceddf41249db26ff463540d9f4d0ba156b68cfa6998390813be8cd0c9f026732efa2aca6cd23dba
data/CHANGELOG.md CHANGED
@@ -1,6 +1,11 @@
1
1
  Unreleased Changes
2
2
  ------------------
3
3
 
4
+ 1.186.0 (2023-07-21)
5
+ ------------------
6
+
7
+ * Feature - Adds support for the DBSystemID parameter of CreateDBInstance to RDS Custom for Oracle.
8
+
4
9
  1.185.0 (2023-07-11)
5
10
  ------------------
6
11
 
data/VERSION CHANGED
@@ -1 +1 @@
1
- 1.185.0
1
+ 1.186.0
@@ -1820,6 +1820,7 @@ module Aws::RDS
1820
1820
  # resp.db_snapshot.snapshot_database_time #=> Time
1821
1821
  # resp.db_snapshot.snapshot_target #=> String
1822
1822
  # resp.db_snapshot.storage_throughput #=> Integer
1823
+ # resp.db_snapshot.db_system_id #=> String
1823
1824
  #
1824
1825
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CopyDBSnapshot AWS API Documentation
1825
1826
  #
@@ -4008,116 +4009,120 @@ module Aws::RDS
4008
4009
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html
4009
4010
  #
4010
4011
  # @option params [String] :db_name
4011
- # The meaning of this parameter differs depending on the database
4012
- # engine.
4012
+ # The meaning of this parameter differs according to the database engine
4013
+ # you use.
4013
4014
  #
4014
- # Amazon Aurora MySQL
4015
- #
4016
- # : The name of the database to create when the primary DB instance of
4017
- # the Aurora MySQL DB cluster is created. If you don't specify a
4018
- # value, Amazon RDS doesn't create a database in the DB cluster.
4019
- #
4020
- # Constraints:
4015
+ # **MySQL**
4021
4016
  #
4022
- # * Must contain 1 to 64 alphanumeric characters.
4017
+ # The name of the database to create when the DB instance is created. If
4018
+ # this parameter isn't specified, no database is created in the DB
4019
+ # instance.
4023
4020
  #
4024
- # * Can't be a word reserved by the database engine.
4021
+ # Constraints:
4025
4022
  #
4026
- # Amazon Aurora PostgreSQL
4023
+ # * Must contain 1 to 64 letters or numbers.
4027
4024
  #
4028
- # : The name of the database to create when the primary DB instance of
4029
- # the Aurora PostgreSQL DB cluster is created.
4025
+ # * Must begin with a letter. Subsequent characters can be letters,
4026
+ # underscores, or digits (0-9).
4030
4027
  #
4031
- # Default: `postgres`
4028
+ # * Can't be a word reserved by the specified database engine
4032
4029
  #
4033
- # Constraints:
4030
+ # **MariaDB**
4034
4031
  #
4035
- # * Must contain 1 to 63 alphanumeric characters.
4032
+ # The name of the database to create when the DB instance is created. If
4033
+ # this parameter isn't specified, no database is created in the DB
4034
+ # instance.
4036
4035
  #
4037
- # * Must begin with a letter. Subsequent characters can be letters,
4038
- # underscores, or digits (0 to 9).
4036
+ # Constraints:
4039
4037
  #
4040
- # * Can't be a word reserved by the database engine.
4038
+ # * Must contain 1 to 64 letters or numbers.
4041
4039
  #
4042
- # Amazon RDS Custom for Oracle
4040
+ # * Must begin with a letter. Subsequent characters can be letters,
4041
+ # underscores, or digits (0-9).
4043
4042
  #
4044
- # : The Oracle System ID (SID) of the created RDS Custom DB instance.
4043
+ # * Can't be a word reserved by the specified database engine
4045
4044
  #
4046
- # Default: `ORCL`
4045
+ # **PostgreSQL**
4047
4046
  #
4048
- # Constraints:
4047
+ # The name of the database to create when the DB instance is created. If
4048
+ # this parameter isn't specified, a database named `postgres` is
4049
+ # created in the DB instance.
4049
4050
  #
4050
- # * Must contain 1 to 8 alphanumeric characters.
4051
+ # Constraints:
4051
4052
  #
4052
- # * Must contain a letter.
4053
+ # * Must contain 1 to 63 letters, numbers, or underscores.
4053
4054
  #
4054
- # * Can't be a word reserved by the database engine.
4055
+ # * Must begin with a letter. Subsequent characters can be letters,
4056
+ # underscores, or digits (0-9).
4055
4057
  #
4056
- # Amazon RDS Custom for SQL Server
4058
+ # * Can't be a word reserved by the specified database engine
4057
4059
  #
4058
- # : Not applicable. Must be null.
4060
+ # **Oracle**
4059
4061
  #
4060
- # RDS for MariaDB
4062
+ # The Oracle System ID (SID) of the created DB instance. If you don't
4063
+ # specify a value, the default value is `ORCL`. You can't specify the
4064
+ # string `null`, or any other reserved word, for `DBName`.
4061
4065
  #
4062
- # : The name of the database to create when the DB instance is created.
4063
- # If you don't specify a value, Amazon RDS doesn't create a database
4064
- # in the DB instance.
4066
+ # Default: `ORCL`
4065
4067
  #
4066
- # Constraints:
4068
+ # Constraints:
4067
4069
  #
4068
- # * Must contain 1 to 64 letters or numbers.
4070
+ # * Can't be longer than 8 characters
4069
4071
  #
4070
- # * Must begin with a letter. Subsequent characters can be letters,
4071
- # underscores, or digits (0-9).
4072
+ # ^
4072
4073
  #
4073
- # * Can't be a word reserved by the database engine.
4074
+ # **Amazon RDS Custom for Oracle**
4074
4075
  #
4075
- # RDS for MySQL
4076
+ # The Oracle System ID (SID) of the created RDS Custom DB instance. If
4077
+ # you don't specify a value, the default value is `ORCL` for non-CDBs
4078
+ # and `RDSCDB` for CDBs.
4076
4079
  #
4077
- # : The name of the database to create when the DB instance is created.
4078
- # If you don't specify a value, Amazon RDS doesn't create a database
4079
- # in the DB instance.
4080
+ # Default: `ORCL`
4080
4081
  #
4081
- # Constraints:
4082
+ # Constraints:
4082
4083
  #
4083
- # * Must contain 1 to 64 letters or numbers.
4084
+ # * It must contain 1 to 8 alphanumeric characters.
4084
4085
  #
4085
- # * Must begin with a letter. Subsequent characters can be letters,
4086
- # underscores, or digits (0-9).
4086
+ # * It must contain a letter.
4087
4087
  #
4088
- # * Can't be a word reserved by the database engine.
4088
+ # * It can't be a word reserved by the database engine.
4089
4089
  #
4090
- # RDS for Oracle
4090
+ # **Amazon RDS Custom for SQL Server**
4091
4091
  #
4092
- # : The Oracle System ID (SID) of the created DB instance.
4092
+ # Not applicable. Must be null.
4093
4093
  #
4094
- # Default: `ORCL`
4094
+ # **SQL Server**
4095
4095
  #
4096
- # Constraints:
4096
+ # Not applicable. Must be null.
4097
4097
  #
4098
- # * Can't be longer than 8 characters.
4098
+ # **Amazon Aurora MySQL**
4099
4099
  #
4100
- # * Can't be a word reserved by the database engine, such as the
4101
- # string `NULL`.
4100
+ # The name of the database to create when the primary DB instance of the
4101
+ # Aurora MySQL DB cluster is created. If this parameter isn't specified
4102
+ # for an Aurora MySQL DB cluster, no database is created in the DB
4103
+ # cluster.
4102
4104
  #
4103
- # RDS for PostgreSQL
4105
+ # Constraints:
4104
4106
  #
4105
- # : The name of the database to create when the DB instance is created.
4107
+ # * It must contain 1 to 64 alphanumeric characters.
4106
4108
  #
4107
- # Default: `postgres`
4109
+ # * It can't be a word reserved by the database engine.
4108
4110
  #
4109
- # Constraints:
4111
+ # **Amazon Aurora PostgreSQL**
4110
4112
  #
4111
- # * Must contain 1 to 63 letters, numbers, or underscores.
4113
+ # The name of the database to create when the primary DB instance of the
4114
+ # Aurora PostgreSQL DB cluster is created. If this parameter isn't
4115
+ # specified for an Aurora PostgreSQL DB cluster, a database named
4116
+ # `postgres` is created in the DB cluster.
4112
4117
  #
4113
- # * Must begin with a letter. Subsequent characters can be letters,
4114
- # underscores, or digits (0-9).
4118
+ # Constraints:
4115
4119
  #
4116
- # * Can't be a word reserved by the database engine.
4120
+ # * It must contain 1 to 63 alphanumeric characters.
4117
4121
  #
4118
- # RDS for SQL Server
4122
+ # * It must begin with a letter. Subsequent characters can be letters,
4123
+ # underscores, or digits (0 to 9).
4119
4124
  #
4120
- # : Not applicable. Must be null.
4125
+ # * It can't be a word reserved by the database engine.
4121
4126
  #
4122
4127
  # @option params [required, String] :db_instance_identifier
4123
4128
  # The identifier for this DB instance. This parameter is stored as a
@@ -5164,6 +5169,14 @@ module Aws::RDS
5164
5169
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html
5165
5170
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html
5166
5171
  #
5172
+ # @option params [String] :db_system_id
5173
+ # The Oracle system identifier (SID), which is the name of the Oracle
5174
+ # database instance that manages your database files. In this context,
5175
+ # the term "Oracle database instance" refers exclusively to the system
5176
+ # global area (SGA) and Oracle background processes. If you don't
5177
+ # specify a SID, the value defaults to `RDSCDB`. The Oracle SID is also
5178
+ # the name of your CDB.
5179
+ #
5167
5180
  # @return [Types::CreateDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
5168
5181
  #
5169
5182
  # * {Types::CreateDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -5350,6 +5363,7 @@ module Aws::RDS
5350
5363
  # manage_master_user_password: false,
5351
5364
  # master_user_secret_kms_key_id: "String",
5352
5365
  # ca_certificate_identifier: "String",
5366
+ # db_system_id: "String",
5353
5367
  # })
5354
5368
  #
5355
5369
  # @example Response structure
@@ -7017,6 +7031,7 @@ module Aws::RDS
7017
7031
  # resp.db_snapshot.snapshot_database_time #=> Time
7018
7032
  # resp.db_snapshot.snapshot_target #=> String
7019
7033
  # resp.db_snapshot.storage_throughput #=> Integer
7034
+ # resp.db_snapshot.db_system_id #=> String
7020
7035
  #
7021
7036
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSnapshot AWS API Documentation
7022
7037
  #
@@ -7646,7 +7661,7 @@ module Aws::RDS
7646
7661
  # Deletes a blue/green deployment.
7647
7662
  #
7648
7663
  # For more information, see [Using Amazon RDS Blue/Green Deployments for
7649
- # database updates][1] in the *Amazon RDS User Guide* and [ Using Amazon
7664
+ # database updates][1] in the *Amazon RDS User Guide* and [Using Amazon
7650
7665
  # RDS Blue/Green Deployments for database updates][2] in the *Amazon
7651
7666
  # Aurora User Guide*.
7652
7667
  #
@@ -7656,8 +7671,8 @@ module Aws::RDS
7656
7671
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html
7657
7672
  #
7658
7673
  # @option params [required, String] :blue_green_deployment_identifier
7659
- # The blue/green deployment identifier of the deployment to be deleted.
7660
- # This parameter isn't case-sensitive.
7674
+ # The unique identifier of the blue/green deployment to delete. This
7675
+ # parameter isn't case-sensitive.
7661
7676
  #
7662
7677
  # Constraints:
7663
7678
  #
@@ -7666,9 +7681,9 @@ module Aws::RDS
7666
7681
  # ^
7667
7682
  #
7668
7683
  # @option params [Boolean] :delete_target
7669
- # A value that indicates whether to delete the resources in the green
7670
- # environment. You can't specify this option if the blue/green
7671
- # deployment [status][1] is `SWITCHOVER_COMPLETED`.
7684
+ # Specifies whether to delete the resources in the green environment.
7685
+ # You can't specify this option if the blue/green deployment
7686
+ # [status][1] is `SWITCHOVER_COMPLETED`.
7672
7687
  #
7673
7688
  #
7674
7689
  #
@@ -9163,6 +9178,7 @@ module Aws::RDS
9163
9178
  # resp.db_snapshot.snapshot_database_time #=> Time
9164
9179
  # resp.db_snapshot.snapshot_target #=> String
9165
9180
  # resp.db_snapshot.storage_throughput #=> Integer
9181
+ # resp.db_snapshot.db_system_id #=> String
9166
9182
  #
9167
9183
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBSnapshot AWS API Documentation
9168
9184
  #
@@ -9550,7 +9566,7 @@ module Aws::RDS
9550
9566
  req.send_request(options)
9551
9567
  end
9552
9568
 
9553
- # Returns information about blue/green deployments.
9569
+ # Describes one or more blue/green deployments.
9554
9570
  #
9555
9571
  # For more information, see [Using Amazon RDS Blue/Green Deployments for
9556
9572
  # database updates][1] in the *Amazon RDS User Guide* and [ Using Amazon
@@ -9563,14 +9579,13 @@ module Aws::RDS
9563
9579
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html
9564
9580
  #
9565
9581
  # @option params [String] :blue_green_deployment_identifier
9566
- # The blue/green deployment identifier. If this parameter is specified,
9567
- # information from only the specific blue/green deployment is returned.
9568
- # This parameter isn't case-sensitive.
9582
+ # The blue/green deployment identifier. If you specify this parameter,
9583
+ # the response only includes information about the specific blue/green
9584
+ # deployment. This parameter isn't case-sensitive.
9569
9585
  #
9570
9586
  # Constraints:
9571
9587
  #
9572
- # * If supplied, must match an existing blue/green deployment
9573
- # identifier.
9588
+ # * Must match an existing blue/green deployment identifier.
9574
9589
  #
9575
9590
  # ^
9576
9591
  #
@@ -9578,7 +9593,7 @@ module Aws::RDS
9578
9593
  # A filter that specifies one or more blue/green deployments to
9579
9594
  # describe.
9580
9595
  #
9581
- # Supported filters:
9596
+ # Valid Values:
9582
9597
  #
9583
9598
  # * `blue-green-deployment-identifier` - Accepts system-generated
9584
9599
  # identifiers for blue/green deployments. The results list only
@@ -9599,9 +9614,9 @@ module Aws::RDS
9599
9614
  #
9600
9615
  # @option params [String] :marker
9601
9616
  # An optional pagination token provided by a previous
9602
- # `DescribeBlueGreenDeployments` request. If this parameter is
9603
- # specified, the response includes only records beyond the marker, up to
9604
- # the value specified by `MaxRecords`.
9617
+ # `DescribeBlueGreenDeployments` request. If you specify this parameter,
9618
+ # the response only includes records beyond the marker, up to the value
9619
+ # specified by `MaxRecords`.
9605
9620
  #
9606
9621
  # @option params [Integer] :max_records
9607
9622
  # The maximum number of records to include in the response. If more
@@ -9611,7 +9626,11 @@ module Aws::RDS
9611
9626
  #
9612
9627
  # Default: 100
9613
9628
  #
9614
- # Constraints: Minimum 20, maximum 100.
9629
+ # Constraints:
9630
+ #
9631
+ # * Must be a minimum of 20.
9632
+ #
9633
+ # * Can't exceed 100.
9615
9634
  #
9616
9635
  # @return [Types::DescribeBlueGreenDeploymentsResponse] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
9617
9636
  #
@@ -13027,6 +13046,7 @@ module Aws::RDS
13027
13046
  # resp.db_snapshots[0].snapshot_database_time #=> Time
13028
13047
  # resp.db_snapshots[0].snapshot_target #=> String
13029
13048
  # resp.db_snapshots[0].storage_throughput #=> Integer
13049
+ # resp.db_snapshots[0].db_system_id #=> String
13030
13050
  #
13031
13051
  #
13032
13052
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -19426,6 +19446,7 @@ module Aws::RDS
19426
19446
  # resp.db_snapshot.snapshot_database_time #=> Time
19427
19447
  # resp.db_snapshot.snapshot_target #=> String
19428
19448
  # resp.db_snapshot.storage_throughput #=> Integer
19449
+ # resp.db_snapshot.db_system_id #=> String
19429
19450
  #
19430
19451
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSnapshot AWS API Documentation
19431
19452
  #
@@ -27441,7 +27462,7 @@ module Aws::RDS
27441
27462
  # routed to the databases in the green environment.
27442
27463
  #
27443
27464
  # For more information, see [Using Amazon RDS Blue/Green Deployments for
27444
- # database updates][1] in the *Amazon RDS User Guide* and [ Using Amazon
27465
+ # database updates][1] in the *Amazon RDS User Guide* and [Using Amazon
27445
27466
  # RDS Blue/Green Deployments for database updates][2] in the *Amazon
27446
27467
  # Aurora User Guide*.
27447
27468
  #
@@ -27451,7 +27472,7 @@ module Aws::RDS
27451
27472
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/blue-green-deployments.html
27452
27473
  #
27453
27474
  # @option params [required, String] :blue_green_deployment_identifier
27454
- # The blue/green deployment identifier.
27475
+ # The unique identifier of the blue/green deployment.
27455
27476
  #
27456
27477
  # Constraints:
27457
27478
  #
@@ -27460,8 +27481,9 @@ module Aws::RDS
27460
27481
  # ^
27461
27482
  #
27462
27483
  # @option params [Integer] :switchover_timeout
27463
- # The amount of time, in seconds, for the switchover to complete. The
27464
- # default is 300.
27484
+ # The amount of time, in seconds, for the switchover to complete.
27485
+ #
27486
+ # Default: 300
27465
27487
  #
27466
27488
  # If the switchover takes longer than the specified duration, then any
27467
27489
  # changes are rolled back, and no changes are made to the environments.
@@ -27844,7 +27866,7 @@ module Aws::RDS
27844
27866
  params: params,
27845
27867
  config: config)
27846
27868
  context[:gem_name] = 'aws-sdk-rds'
27847
- context[:gem_version] = '1.185.0'
27869
+ context[:gem_version] = '1.186.0'
27848
27870
  Seahorse::Client::Request.new(handlers, context)
27849
27871
  end
27850
27872
 
@@ -1032,6 +1032,7 @@ module Aws::RDS
1032
1032
  CreateDBInstanceMessage.add_member(:manage_master_user_password, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "ManageMasterUserPassword"))
1033
1033
  CreateDBInstanceMessage.add_member(:master_user_secret_kms_key_id, Shapes::ShapeRef.new(shape: String, location_name: "MasterUserSecretKmsKeyId"))
1034
1034
  CreateDBInstanceMessage.add_member(:ca_certificate_identifier, Shapes::ShapeRef.new(shape: String, location_name: "CACertificateIdentifier"))
1035
+ CreateDBInstanceMessage.add_member(:db_system_id, Shapes::ShapeRef.new(shape: String, location_name: "DBSystemId"))
1035
1036
  CreateDBInstanceMessage.struct_class = Types::CreateDBInstanceMessage
1036
1037
 
1037
1038
  CreateDBInstanceReadReplicaMessage.add_member(:db_instance_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBInstanceIdentifier"))
@@ -1785,6 +1786,7 @@ module Aws::RDS
1785
1786
  DBSnapshot.add_member(:snapshot_database_time, Shapes::ShapeRef.new(shape: TStamp, location_name: "SnapshotDatabaseTime"))
1786
1787
  DBSnapshot.add_member(:snapshot_target, Shapes::ShapeRef.new(shape: String, location_name: "SnapshotTarget"))
1787
1788
  DBSnapshot.add_member(:storage_throughput, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "StorageThroughput"))
1789
+ DBSnapshot.add_member(:db_system_id, Shapes::ShapeRef.new(shape: String, location_name: "DBSystemId"))
1788
1790
  DBSnapshot.struct_class = Types::DBSnapshot
1789
1791
 
1790
1792
  DBSnapshotAlreadyExistsFault.struct_class = Types::DBSnapshotAlreadyExistsFault
@@ -72,17 +72,10 @@ module Aws::RDS
72
72
  data[:master_username]
73
73
  end
74
74
 
75
- # The meaning of this parameter differs depending on the database
76
- # engine.
77
- #
78
- # * For RDS for MariaDB, Microsoft SQL Server, MySQL, and PostgreSQL -
79
- # The name of the initial database specified for this DB instance when
80
- # it was created, if one was provided. This same name is returned for
81
- # the life of the DB instance.
82
- #
83
- # * For RDS for Oracle - The Oracle System ID (SID) of the created DB
84
- # instance. This value is only returned when the object returned is an
85
- # Oracle DB instance.
75
+ # Contains the initial database name that you provided (if required)
76
+ # when you created the DB instance. This name is returned for the life
77
+ # of your DB instance. For an RDS for Oracle CDB instance, the name
78
+ # identifies the PDB rather than the CDB.
86
79
  # @return [String]
87
80
  def db_name
88
81
  data[:db_name]
@@ -967,119 +960,124 @@ module Aws::RDS
967
960
  # manage_master_user_password: false,
968
961
  # master_user_secret_kms_key_id: "String",
969
962
  # ca_certificate_identifier: "String",
963
+ # db_system_id: "String",
970
964
  # })
971
965
  # @param [Hash] options ({})
972
966
  # @option options [String] :db_name
973
- # The meaning of this parameter differs depending on the database
974
- # engine.
975
- #
976
- # Amazon Aurora MySQL
967
+ # The meaning of this parameter differs according to the database engine
968
+ # you use.
977
969
  #
978
- # : The name of the database to create when the primary DB instance of
979
- # the Aurora MySQL DB cluster is created. If you don't specify a
980
- # value, Amazon RDS doesn't create a database in the DB cluster.
970
+ # **MySQL**
981
971
  #
982
- # Constraints:
983
- #
984
- # * Must contain 1 to 64 alphanumeric characters.
972
+ # The name of the database to create when the DB instance is created. If
973
+ # this parameter isn't specified, no database is created in the DB
974
+ # instance.
985
975
  #
986
- # * Can't be a word reserved by the database engine.
976
+ # Constraints:
987
977
  #
988
- # Amazon Aurora PostgreSQL
978
+ # * Must contain 1 to 64 letters or numbers.
989
979
  #
990
- # : The name of the database to create when the primary DB instance of
991
- # the Aurora PostgreSQL DB cluster is created.
980
+ # * Must begin with a letter. Subsequent characters can be letters,
981
+ # underscores, or digits (0-9).
992
982
  #
993
- # Default: `postgres`
983
+ # * Can't be a word reserved by the specified database engine
994
984
  #
995
- # Constraints:
985
+ # **MariaDB**
996
986
  #
997
- # * Must contain 1 to 63 alphanumeric characters.
987
+ # The name of the database to create when the DB instance is created. If
988
+ # this parameter isn't specified, no database is created in the DB
989
+ # instance.
998
990
  #
999
- # * Must begin with a letter. Subsequent characters can be letters,
1000
- # underscores, or digits (0 to 9).
991
+ # Constraints:
1001
992
  #
1002
- # * Can't be a word reserved by the database engine.
993
+ # * Must contain 1 to 64 letters or numbers.
1003
994
  #
1004
- # Amazon RDS Custom for Oracle
995
+ # * Must begin with a letter. Subsequent characters can be letters,
996
+ # underscores, or digits (0-9).
1005
997
  #
1006
- # : The Oracle System ID (SID) of the created RDS Custom DB instance.
998
+ # * Can't be a word reserved by the specified database engine
1007
999
  #
1008
- # Default: `ORCL`
1000
+ # **PostgreSQL**
1009
1001
  #
1010
- # Constraints:
1002
+ # The name of the database to create when the DB instance is created. If
1003
+ # this parameter isn't specified, a database named `postgres` is
1004
+ # created in the DB instance.
1011
1005
  #
1012
- # * Must contain 1 to 8 alphanumeric characters.
1006
+ # Constraints:
1013
1007
  #
1014
- # * Must contain a letter.
1008
+ # * Must contain 1 to 63 letters, numbers, or underscores.
1015
1009
  #
1016
- # * Can't be a word reserved by the database engine.
1010
+ # * Must begin with a letter. Subsequent characters can be letters,
1011
+ # underscores, or digits (0-9).
1017
1012
  #
1018
- # Amazon RDS Custom for SQL Server
1013
+ # * Can't be a word reserved by the specified database engine
1019
1014
  #
1020
- # : Not applicable. Must be null.
1015
+ # **Oracle**
1021
1016
  #
1022
- # RDS for MariaDB
1017
+ # The Oracle System ID (SID) of the created DB instance. If you don't
1018
+ # specify a value, the default value is `ORCL`. You can't specify the
1019
+ # string `null`, or any other reserved word, for `DBName`.
1023
1020
  #
1024
- # : The name of the database to create when the DB instance is created.
1025
- # If you don't specify a value, Amazon RDS doesn't create a database
1026
- # in the DB instance.
1021
+ # Default: `ORCL`
1027
1022
  #
1028
- # Constraints:
1023
+ # Constraints:
1029
1024
  #
1030
- # * Must contain 1 to 64 letters or numbers.
1025
+ # * Can't be longer than 8 characters
1031
1026
  #
1032
- # * Must begin with a letter. Subsequent characters can be letters,
1033
- # underscores, or digits (0-9).
1027
+ # ^
1034
1028
  #
1035
- # * Can't be a word reserved by the database engine.
1029
+ # **Amazon RDS Custom for Oracle**
1036
1030
  #
1037
- # RDS for MySQL
1031
+ # The Oracle System ID (SID) of the created RDS Custom DB instance. If
1032
+ # you don't specify a value, the default value is `ORCL` for non-CDBs
1033
+ # and `RDSCDB` for CDBs.
1038
1034
  #
1039
- # : The name of the database to create when the DB instance is created.
1040
- # If you don't specify a value, Amazon RDS doesn't create a database
1041
- # in the DB instance.
1035
+ # Default: `ORCL`
1042
1036
  #
1043
- # Constraints:
1037
+ # Constraints:
1044
1038
  #
1045
- # * Must contain 1 to 64 letters or numbers.
1039
+ # * It must contain 1 to 8 alphanumeric characters.
1046
1040
  #
1047
- # * Must begin with a letter. Subsequent characters can be letters,
1048
- # underscores, or digits (0-9).
1041
+ # * It must contain a letter.
1049
1042
  #
1050
- # * Can't be a word reserved by the database engine.
1043
+ # * It can't be a word reserved by the database engine.
1051
1044
  #
1052
- # RDS for Oracle
1045
+ # **Amazon RDS Custom for SQL Server**
1053
1046
  #
1054
- # : The Oracle System ID (SID) of the created DB instance.
1047
+ # Not applicable. Must be null.
1055
1048
  #
1056
- # Default: `ORCL`
1049
+ # **SQL Server**
1057
1050
  #
1058
- # Constraints:
1051
+ # Not applicable. Must be null.
1059
1052
  #
1060
- # * Can't be longer than 8 characters.
1053
+ # **Amazon Aurora MySQL**
1061
1054
  #
1062
- # * Can't be a word reserved by the database engine, such as the
1063
- # string `NULL`.
1055
+ # The name of the database to create when the primary DB instance of the
1056
+ # Aurora MySQL DB cluster is created. If this parameter isn't specified
1057
+ # for an Aurora MySQL DB cluster, no database is created in the DB
1058
+ # cluster.
1064
1059
  #
1065
- # RDS for PostgreSQL
1060
+ # Constraints:
1066
1061
  #
1067
- # : The name of the database to create when the DB instance is created.
1062
+ # * It must contain 1 to 64 alphanumeric characters.
1068
1063
  #
1069
- # Default: `postgres`
1064
+ # * It can't be a word reserved by the database engine.
1070
1065
  #
1071
- # Constraints:
1066
+ # **Amazon Aurora PostgreSQL**
1072
1067
  #
1073
- # * Must contain 1 to 63 letters, numbers, or underscores.
1068
+ # The name of the database to create when the primary DB instance of the
1069
+ # Aurora PostgreSQL DB cluster is created. If this parameter isn't
1070
+ # specified for an Aurora PostgreSQL DB cluster, a database named
1071
+ # `postgres` is created in the DB cluster.
1074
1072
  #
1075
- # * Must begin with a letter. Subsequent characters can be letters,
1076
- # underscores, or digits (0-9).
1073
+ # Constraints:
1077
1074
  #
1078
- # * Can't be a word reserved by the database engine.
1075
+ # * It must contain 1 to 63 alphanumeric characters.
1079
1076
  #
1080
- # RDS for SQL Server
1077
+ # * It must begin with a letter. Subsequent characters can be letters,
1078
+ # underscores, or digits (0 to 9).
1081
1079
  #
1082
- # : Not applicable. Must be null.
1080
+ # * It can't be a word reserved by the database engine.
1083
1081
  # @option options [Integer] :allocated_storage
1084
1082
  # The amount of storage in gibibytes (GiB) to allocate for the DB
1085
1083
  # instance.
@@ -2054,6 +2052,13 @@ module Aws::RDS
2054
2052
  #
2055
2053
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.SSL.html
2056
2054
  # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.SSL.html
2055
+ # @option options [String] :db_system_id
2056
+ # The Oracle system identifier (SID), which is the name of the Oracle
2057
+ # database instance that manages your database files. In this context,
2058
+ # the term "Oracle database instance" refers exclusively to the system
2059
+ # global area (SGA) and Oracle background processes. If you don't
2060
+ # specify a SID, the value defaults to `RDSCDB`. The Oracle SID is also
2061
+ # the name of your CDB.
2057
2062
  # @return [DBInstance]
2058
2063
  def create(options = {})
2059
2064
  options = options.merge(db_instance_identifier: @id)