aws-sdk-rds 1.172.0 → 1.174.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +10 -0
- data/VERSION +1 -1
- data/lib/aws-sdk-rds/client.rb +164 -131
- data/lib/aws-sdk-rds/client_api.rb +9 -1
- data/lib/aws-sdk-rds/db_cluster.rb +33 -52
- data/lib/aws-sdk-rds/db_cluster_snapshot.rb +6 -10
- data/lib/aws-sdk-rds/db_instance.rb +43 -11
- data/lib/aws-sdk-rds/errors.rb +11 -0
- data/lib/aws-sdk-rds/resource.rb +22 -48
- data/lib/aws-sdk-rds/types.rb +144 -122
- data/lib/aws-sdk-rds.rb +1 -1
- metadata +2 -2
@@ -85,6 +85,7 @@ module Aws::RDS
|
|
85
85
|
CopyOptionGroupResult = Shapes::StructureShape.new(name: 'CopyOptionGroupResult')
|
86
86
|
CreateBlueGreenDeploymentRequest = Shapes::StructureShape.new(name: 'CreateBlueGreenDeploymentRequest')
|
87
87
|
CreateBlueGreenDeploymentResponse = Shapes::StructureShape.new(name: 'CreateBlueGreenDeploymentResponse')
|
88
|
+
CreateCustomDBEngineVersionFault = Shapes::StructureShape.new(name: 'CreateCustomDBEngineVersionFault')
|
88
89
|
CreateCustomDBEngineVersionMessage = Shapes::StructureShape.new(name: 'CreateCustomDBEngineVersionMessage')
|
89
90
|
CreateDBClusterEndpointMessage = Shapes::StructureShape.new(name: 'CreateDBClusterEndpointMessage')
|
90
91
|
CreateDBClusterMessage = Shapes::StructureShape.new(name: 'CreateDBClusterMessage')
|
@@ -877,6 +878,8 @@ module Aws::RDS
|
|
877
878
|
CreateBlueGreenDeploymentResponse.add_member(:blue_green_deployment, Shapes::ShapeRef.new(shape: BlueGreenDeployment, location_name: "BlueGreenDeployment"))
|
878
879
|
CreateBlueGreenDeploymentResponse.struct_class = Types::CreateBlueGreenDeploymentResponse
|
879
880
|
|
881
|
+
CreateCustomDBEngineVersionFault.struct_class = Types::CreateCustomDBEngineVersionFault
|
882
|
+
|
880
883
|
CreateCustomDBEngineVersionMessage.add_member(:engine, Shapes::ShapeRef.new(shape: CustomEngineName, required: true, location_name: "Engine"))
|
881
884
|
CreateCustomDBEngineVersionMessage.add_member(:engine_version, Shapes::ShapeRef.new(shape: CustomEngineVersion, required: true, location_name: "EngineVersion"))
|
882
885
|
CreateCustomDBEngineVersionMessage.add_member(:database_installation_files_s3_bucket_name, Shapes::ShapeRef.new(shape: BucketName, location_name: "DatabaseInstallationFilesS3BucketName"))
|
@@ -1026,7 +1029,7 @@ module Aws::RDS
|
|
1026
1029
|
CreateDBInstanceMessage.struct_class = Types::CreateDBInstanceMessage
|
1027
1030
|
|
1028
1031
|
CreateDBInstanceReadReplicaMessage.add_member(:db_instance_identifier, Shapes::ShapeRef.new(shape: String, required: true, location_name: "DBInstanceIdentifier"))
|
1029
|
-
CreateDBInstanceReadReplicaMessage.add_member(:source_db_instance_identifier, Shapes::ShapeRef.new(shape: String,
|
1032
|
+
CreateDBInstanceReadReplicaMessage.add_member(:source_db_instance_identifier, Shapes::ShapeRef.new(shape: String, location_name: "SourceDBInstanceIdentifier"))
|
1030
1033
|
CreateDBInstanceReadReplicaMessage.add_member(:db_instance_class, Shapes::ShapeRef.new(shape: String, location_name: "DBInstanceClass"))
|
1031
1034
|
CreateDBInstanceReadReplicaMessage.add_member(:availability_zone, Shapes::ShapeRef.new(shape: String, location_name: "AvailabilityZone"))
|
1032
1035
|
CreateDBInstanceReadReplicaMessage.add_member(:port, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "Port"))
|
@@ -1062,6 +1065,7 @@ module Aws::RDS
|
|
1062
1065
|
CreateDBInstanceReadReplicaMessage.add_member(:storage_throughput, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "StorageThroughput"))
|
1063
1066
|
CreateDBInstanceReadReplicaMessage.add_member(:enable_customer_owned_ip, Shapes::ShapeRef.new(shape: BooleanOptional, location_name: "EnableCustomerOwnedIp"))
|
1064
1067
|
CreateDBInstanceReadReplicaMessage.add_member(:allocated_storage, Shapes::ShapeRef.new(shape: IntegerOptional, location_name: "AllocatedStorage"))
|
1068
|
+
CreateDBInstanceReadReplicaMessage.add_member(:source_db_cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "SourceDBClusterIdentifier"))
|
1065
1069
|
CreateDBInstanceReadReplicaMessage.add_member(:source_region, Shapes::ShapeRef.new(shape: String, location_name: "SourceRegion"))
|
1066
1070
|
CreateDBInstanceReadReplicaMessage.struct_class = Types::CreateDBInstanceReadReplicaMessage
|
1067
1071
|
|
@@ -1521,6 +1525,7 @@ module Aws::RDS
|
|
1521
1525
|
DBInstance.add_member(:db_system_id, Shapes::ShapeRef.new(shape: String, location_name: "DBSystemId"))
|
1522
1526
|
DBInstance.add_member(:master_user_secret, Shapes::ShapeRef.new(shape: MasterUserSecret, location_name: "MasterUserSecret"))
|
1523
1527
|
DBInstance.add_member(:certificate_details, Shapes::ShapeRef.new(shape: CertificateDetails, location_name: "CertificateDetails"))
|
1528
|
+
DBInstance.add_member(:read_replica_source_db_cluster_identifier, Shapes::ShapeRef.new(shape: String, location_name: "ReadReplicaSourceDBClusterIdentifier"))
|
1524
1529
|
DBInstance.struct_class = Types::DBInstance
|
1525
1530
|
|
1526
1531
|
DBInstanceAlreadyExistsFault.struct_class = Types::DBInstanceAlreadyExistsFault
|
@@ -3852,6 +3857,7 @@ module Aws::RDS
|
|
3852
3857
|
o.errors << Shapes::ShapeRef.new(shape: CustomDBEngineVersionQuotaExceededFault)
|
3853
3858
|
o.errors << Shapes::ShapeRef.new(shape: Ec2ImagePropertiesNotSupportedFault)
|
3854
3859
|
o.errors << Shapes::ShapeRef.new(shape: KMSKeyNotAccessibleFault)
|
3860
|
+
o.errors << Shapes::ShapeRef.new(shape: CreateCustomDBEngineVersionFault)
|
3855
3861
|
end)
|
3856
3862
|
|
3857
3863
|
api.add_operation(:create_db_cluster, Seahorse::Model::Operation.new.tap do |o|
|
@@ -3959,7 +3965,9 @@ module Aws::RDS
|
|
3959
3965
|
o.errors << Shapes::ShapeRef.new(shape: InstanceQuotaExceededFault)
|
3960
3966
|
o.errors << Shapes::ShapeRef.new(shape: StorageQuotaExceededFault)
|
3961
3967
|
o.errors << Shapes::ShapeRef.new(shape: DBInstanceNotFoundFault)
|
3968
|
+
o.errors << Shapes::ShapeRef.new(shape: DBClusterNotFoundFault)
|
3962
3969
|
o.errors << Shapes::ShapeRef.new(shape: InvalidDBInstanceStateFault)
|
3970
|
+
o.errors << Shapes::ShapeRef.new(shape: InvalidDBClusterStateFault)
|
3963
3971
|
o.errors << Shapes::ShapeRef.new(shape: DBSubnetGroupNotFoundFault)
|
3964
3972
|
o.errors << Shapes::ShapeRef.new(shape: DBSubnetGroupDoesNotCoverEnoughAZs)
|
3965
3973
|
o.errors << Shapes::ShapeRef.new(shape: InvalidSubnet)
|
@@ -938,10 +938,7 @@ module Aws::RDS
|
|
938
938
|
#
|
939
939
|
# Valid Values:
|
940
940
|
#
|
941
|
-
# * `aurora`
|
942
|
-
#
|
943
|
-
# * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
|
944
|
-
# Aurora)
|
941
|
+
# * `aurora-mysql`
|
945
942
|
#
|
946
943
|
# * `aurora-postgresql`
|
947
944
|
#
|
@@ -953,18 +950,16 @@ module Aws::RDS
|
|
953
950
|
# @option options [String] :engine_version
|
954
951
|
# The version number of the database engine to use.
|
955
952
|
#
|
956
|
-
# To list all of the available engine versions for MySQL
|
957
|
-
#
|
958
|
-
#
|
959
|
-
# `aws rds describe-db-engine-versions --engine aurora --query
|
960
|
-
# "DBEngineVersions[].EngineVersion"`
|
961
|
-
#
|
962
|
-
# To list all of the available engine versions for MySQL 5.7-compatible
|
963
|
-
# and MySQL 8.0-compatible Aurora, use the following command:
|
953
|
+
# To list all of the available engine versions for Aurora MySQL version
|
954
|
+
# 2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use the
|
955
|
+
# following command:
|
964
956
|
#
|
965
957
|
# `aws rds describe-db-engine-versions --engine aurora-mysql --query
|
966
958
|
# "DBEngineVersions[].EngineVersion"`
|
967
959
|
#
|
960
|
+
# You can supply either `5.7` or `8.0` to use the default engine version
|
961
|
+
# for Aurora MySQL version 2 or version 3, respectively.
|
962
|
+
#
|
968
963
|
# To list all of the available engine versions for Aurora PostgreSQL,
|
969
964
|
# use the following command:
|
970
965
|
#
|
@@ -985,8 +980,8 @@ module Aws::RDS
|
|
985
980
|
#
|
986
981
|
# **Aurora MySQL**
|
987
982
|
#
|
988
|
-
# For information, see [
|
989
|
-
# Aurora User Guide*.
|
983
|
+
# For information, see [Database engine updates for Amazon Aurora
|
984
|
+
# MySQL][1] in the *Amazon Aurora User Guide*.
|
990
985
|
#
|
991
986
|
# **Aurora PostgreSQL**
|
992
987
|
#
|
@@ -995,13 +990,13 @@ module Aws::RDS
|
|
995
990
|
#
|
996
991
|
# **MySQL**
|
997
992
|
#
|
998
|
-
# For information, see [
|
999
|
-
#
|
993
|
+
# For information, see [Amazon RDS for MySQL][3] in the *Amazon RDS User
|
994
|
+
# Guide*.
|
1000
995
|
#
|
1001
996
|
# **PostgreSQL**
|
1002
997
|
#
|
1003
|
-
# For information, see [Amazon RDS for PostgreSQL
|
1004
|
-
#
|
998
|
+
# For information, see [Amazon RDS for PostgreSQL][4] in the *Amazon RDS
|
999
|
+
# User Guide*.
|
1005
1000
|
#
|
1006
1001
|
# Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
1007
1002
|
#
|
@@ -1107,8 +1102,7 @@ module Aws::RDS
|
|
1107
1102
|
# The Amazon Resource Name (ARN) of the source DB instance or DB cluster
|
1108
1103
|
# if this DB cluster is created as a read replica.
|
1109
1104
|
#
|
1110
|
-
# Valid for: Aurora DB clusters and
|
1111
|
-
# clusters
|
1105
|
+
# Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
1112
1106
|
# @option options [Array<Types::Tag>] :tags
|
1113
1107
|
# Tags to assign to the DB cluster.
|
1114
1108
|
#
|
@@ -1126,7 +1120,7 @@ module Aws::RDS
|
|
1126
1120
|
# different Amazon Web Services account, specify the key ARN or alias
|
1127
1121
|
# ARN.
|
1128
1122
|
#
|
1129
|
-
# When a KMS key isn't specified in `KmsKeyId
|
1123
|
+
# When a KMS key isn't specified in `KmsKeyId`:
|
1130
1124
|
#
|
1131
1125
|
# * If `ReplicationSourceIdentifier` identifies an encrypted source,
|
1132
1126
|
# then Amazon RDS will use the KMS key used to encrypt the source.
|
@@ -1261,40 +1255,23 @@ module Aws::RDS
|
|
1261
1255
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
|
1262
1256
|
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
|
1263
1257
|
# @option options [String] :engine_mode
|
1264
|
-
# The DB engine mode of the DB cluster, either `provisioned
|
1265
|
-
# `serverless
|
1266
|
-
#
|
1267
|
-
# The `parallelquery` engine mode isn't required for Aurora MySQL
|
1268
|
-
# version 1.23 and higher 1.x versions, and version 2.09 and higher 2.x
|
1269
|
-
# versions.
|
1270
|
-
#
|
1271
|
-
# The `global` engine mode isn't required for Aurora MySQL version 1.22
|
1272
|
-
# and higher 1.x versions, and `global` engine mode isn't required for
|
1273
|
-
# any 2.x versions.
|
1274
|
-
#
|
1275
|
-
# The `multimaster` engine mode only applies for DB clusters created
|
1276
|
-
# with Aurora MySQL version 5.6.10a.
|
1258
|
+
# The DB engine mode of the DB cluster, either `provisioned` or
|
1259
|
+
# `serverless`.
|
1277
1260
|
#
|
1278
1261
|
# The `serverless` engine mode only applies for Aurora Serverless v1 DB
|
1279
1262
|
# clusters.
|
1280
1263
|
#
|
1281
|
-
# For Aurora PostgreSQL, the `global` engine mode isn't required, and
|
1282
|
-
# both the `parallelquery` and the `multimaster` engine modes currently
|
1283
|
-
# aren't supported.
|
1284
|
-
#
|
1285
1264
|
# Limitations and requirements apply to some DB engine modes. For more
|
1286
1265
|
# information, see the following sections in the *Amazon Aurora User
|
1287
|
-
# Guide
|
1266
|
+
# Guide*:
|
1288
1267
|
#
|
1289
1268
|
# * [Limitations of Aurora Serverless v1][1]
|
1290
1269
|
#
|
1291
1270
|
# * [Requirements for Aurora Serverless v2][2]
|
1292
1271
|
#
|
1293
|
-
# * [Limitations of
|
1294
|
-
#
|
1295
|
-
# * [Limitations of Aurora Global Databases][4]
|
1272
|
+
# * [Limitations of parallel query][3]
|
1296
1273
|
#
|
1297
|
-
# * [Limitations of
|
1274
|
+
# * [Limitations of Aurora global databases][4]
|
1298
1275
|
#
|
1299
1276
|
# Valid for: Aurora DB clusters only
|
1300
1277
|
#
|
@@ -1304,7 +1281,6 @@ module Aws::RDS
|
|
1304
1281
|
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.requirements.html
|
1305
1282
|
# [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations
|
1306
1283
|
# [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations
|
1307
|
-
# [5]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations
|
1308
1284
|
# @option options [Types::ScalingConfiguration] :scaling_configuration
|
1309
1285
|
# For DB clusters in `serverless` DB engine mode, the scaling properties
|
1310
1286
|
# of the DB cluster.
|
@@ -1419,8 +1395,8 @@ module Aws::RDS
|
|
1419
1395
|
# be initially allocated for each DB instance in the Multi-AZ DB
|
1420
1396
|
# cluster.
|
1421
1397
|
#
|
1422
|
-
# For information about valid IOPS values, see [
|
1423
|
-
#
|
1398
|
+
# For information about valid IOPS values, see [Provisioned IOPS
|
1399
|
+
# storage][1] in the *Amazon RDS User Guide*.
|
1424
1400
|
#
|
1425
1401
|
# This setting is required to create a Multi-AZ DB cluster.
|
1426
1402
|
#
|
@@ -2003,16 +1979,21 @@ module Aws::RDS
|
|
2003
1979
|
# applied during the next maintenance window unless `ApplyImmediately`
|
2004
1980
|
# is enabled.
|
2005
1981
|
#
|
2006
|
-
#
|
2007
|
-
#
|
1982
|
+
# If the cluster that you're modifying has one or more read replicas,
|
1983
|
+
# all replicas must be running an engine version that's the same or
|
1984
|
+
# later than the version you specify.
|
2008
1985
|
#
|
2009
|
-
#
|
1986
|
+
# To list all of the available engine versions for Aurora MySQL version
|
1987
|
+
# 2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use the
|
1988
|
+
# following command:
|
1989
|
+
#
|
1990
|
+
# `aws rds describe-db-engine-versions --engine aurora-mysql --query
|
2010
1991
|
# "DBEngineVersions[].EngineVersion"`
|
2011
1992
|
#
|
2012
|
-
# To list all of the available engine versions for MySQL 5.
|
2013
|
-
#
|
1993
|
+
# To list all of the available engine versions for MySQL 5.6-compatible
|
1994
|
+
# Aurora, use the following command:
|
2014
1995
|
#
|
2015
|
-
# `aws rds describe-db-engine-versions --engine aurora
|
1996
|
+
# `aws rds describe-db-engine-versions --engine aurora --query
|
2016
1997
|
# "DBEngineVersions[].EngineVersion"`
|
2017
1998
|
#
|
2018
1999
|
# To list all of the available engine versions for Aurora PostgreSQL,
|
@@ -586,13 +586,9 @@ module Aws::RDS
|
|
586
586
|
#
|
587
587
|
# Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
588
588
|
# @option options [String] :engine_version
|
589
|
-
# The version of the database engine to use for the new DB cluster.
|
590
|
-
#
|
591
|
-
#
|
592
|
-
# Aurora, use the following command:
|
593
|
-
#
|
594
|
-
# `aws rds describe-db-engine-versions --engine aurora --query
|
595
|
-
# "DBEngineVersions[].EngineVersion"`
|
589
|
+
# The version of the database engine to use for the new DB cluster. If
|
590
|
+
# you don't specify an engine version, the default version for the
|
591
|
+
# database engine in the Amazon Web Services Region is used.
|
596
592
|
#
|
597
593
|
# To list all of the available engine versions for MySQL 5.7-compatible
|
598
594
|
# and MySQL 8.0-compatible Aurora, use the following command:
|
@@ -620,8 +616,8 @@ module Aws::RDS
|
|
620
616
|
#
|
621
617
|
# **Aurora MySQL**
|
622
618
|
#
|
623
|
-
# See [
|
624
|
-
# Guide*.
|
619
|
+
# See [Database engine updates for Amazon Aurora MySQL][1] in the
|
620
|
+
# *Amazon Aurora User Guide*.
|
625
621
|
#
|
626
622
|
# **Aurora PostgreSQL**
|
627
623
|
#
|
@@ -630,7 +626,7 @@ module Aws::RDS
|
|
630
626
|
#
|
631
627
|
# **MySQL**
|
632
628
|
#
|
633
|
-
# See [
|
629
|
+
# See [Amazon RDS for MySQL][3] in the *Amazon RDS User Guide.*
|
634
630
|
#
|
635
631
|
# **PostgreSQL**
|
636
632
|
#
|
@@ -771,6 +771,13 @@ module Aws::RDS
|
|
771
771
|
data[:certificate_details]
|
772
772
|
end
|
773
773
|
|
774
|
+
# Contains the identifier of the source DB cluster if this DB instance
|
775
|
+
# is a read replica.
|
776
|
+
# @return [String]
|
777
|
+
def read_replica_source_db_cluster_identifier
|
778
|
+
data[:read_replica_source_db_cluster_identifier]
|
779
|
+
end
|
780
|
+
|
774
781
|
# @!endgroup
|
775
782
|
|
776
783
|
# @return [Client]
|
@@ -2131,6 +2138,7 @@ module Aws::RDS
|
|
2131
2138
|
# storage_throughput: 1,
|
2132
2139
|
# enable_customer_owned_ip: false,
|
2133
2140
|
# allocated_storage: 1,
|
2141
|
+
# source_db_cluster_identifier: "String",
|
2134
2142
|
# source_region: "String",
|
2135
2143
|
# })
|
2136
2144
|
# @param [Hash] options ({})
|
@@ -2170,8 +2178,8 @@ module Aws::RDS
|
|
2170
2178
|
# You can create a read replica as a Multi-AZ DB instance. RDS creates a
|
2171
2179
|
# standby of your replica in another Availability Zone for failover
|
2172
2180
|
# support for the replica. Creating your read replica as a Multi-AZ DB
|
2173
|
-
# instance is independent of whether the source
|
2174
|
-
# DB
|
2181
|
+
# instance is independent of whether the source is a Multi-AZ DB
|
2182
|
+
# instance or a Multi-AZ DB cluster.
|
2175
2183
|
#
|
2176
2184
|
# This setting doesn't apply to RDS Custom.
|
2177
2185
|
# @option options [Boolean] :auto_minor_version_upgrade
|
@@ -2186,10 +2194,10 @@ module Aws::RDS
|
|
2186
2194
|
# be initially allocated for the DB instance.
|
2187
2195
|
# @option options [String] :option_group_name
|
2188
2196
|
# The option group the DB instance is associated with. If omitted, the
|
2189
|
-
# option group associated with the source instance is used.
|
2197
|
+
# option group associated with the source instance or cluster is used.
|
2190
2198
|
#
|
2191
2199
|
# <note markdown="1"> For SQL Server, you must use the option group associated with the
|
2192
|
-
# source
|
2200
|
+
# source.
|
2193
2201
|
#
|
2194
2202
|
# </note>
|
2195
2203
|
#
|
@@ -2314,10 +2322,10 @@ module Aws::RDS
|
|
2314
2322
|
# alias ARN, or alias name for the KMS key.
|
2315
2323
|
#
|
2316
2324
|
# If you create an encrypted read replica in the same Amazon Web
|
2317
|
-
# Services Region as the source DB instance
|
2318
|
-
# for this parameter. A read replica in the same
|
2319
|
-
# Region is always encrypted with the same KMS key
|
2320
|
-
# instance.
|
2325
|
+
# Services Region as the source DB instance or Multi-AZ DB cluster,
|
2326
|
+
# don't specify a value for this parameter. A read replica in the same
|
2327
|
+
# Amazon Web Services Region is always encrypted with the same KMS key
|
2328
|
+
# as the source DB instance or cluster.
|
2321
2329
|
#
|
2322
2330
|
# If you create an encrypted read replica in a different Amazon Web
|
2323
2331
|
# Services Region, then you must specify a KMS key identifier for the
|
@@ -2327,7 +2335,7 @@ module Aws::RDS
|
|
2327
2335
|
# Services Region.
|
2328
2336
|
#
|
2329
2337
|
# You can't create an encrypted read replica from an unencrypted DB
|
2330
|
-
# instance.
|
2338
|
+
# instance or Multi-AZ DB cluster.
|
2331
2339
|
#
|
2332
2340
|
# This setting doesn't apply to RDS Custom, which uses the same KMS key
|
2333
2341
|
# as the primary replica.
|
@@ -2343,6 +2351,10 @@ module Aws::RDS
|
|
2343
2351
|
# and China Amazon Web Services Regions. It's ignored in other Amazon
|
2344
2352
|
# Web Services Regions.
|
2345
2353
|
#
|
2354
|
+
# This setting applies only when replicating from a source DB
|
2355
|
+
# *instance*. Source DB clusters aren't supported in Amazon Web
|
2356
|
+
# Services GovCloud (US) Regions and China Amazon Web Services Regions.
|
2357
|
+
#
|
2346
2358
|
# You must specify this parameter when you create an encrypted read
|
2347
2359
|
# replica from another Amazon Web Services Region by using the Amazon
|
2348
2360
|
# RDS API. Don't specify `PreSignedUrl` when you are creating an
|
@@ -2512,8 +2524,8 @@ module Aws::RDS
|
|
2512
2524
|
#
|
2513
2525
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
|
2514
2526
|
# @option options [String] :domain_iam_role_name
|
2515
|
-
#
|
2516
|
-
#
|
2527
|
+
# The name of the IAM role to be used when making API calls to the
|
2528
|
+
# Directory Service.
|
2517
2529
|
#
|
2518
2530
|
# This setting doesn't apply to RDS Custom.
|
2519
2531
|
# @option options [String] :replica_mode
|
@@ -2627,6 +2639,22 @@ module Aws::RDS
|
|
2627
2639
|
# for future growth.
|
2628
2640
|
#
|
2629
2641
|
# </note>
|
2642
|
+
# @option options [String] :source_db_cluster_identifier
|
2643
|
+
# The identifier of the Multi-AZ DB cluster that will act as the source
|
2644
|
+
# for the read replica. Each DB cluster can have up to 15 read replicas.
|
2645
|
+
#
|
2646
|
+
# Constraints:
|
2647
|
+
#
|
2648
|
+
# * Must be the identifier of an existing Multi-AZ DB cluster.
|
2649
|
+
#
|
2650
|
+
# * Can't be specified if the `SourceDBInstanceIdentifier` parameter is
|
2651
|
+
# also specified.
|
2652
|
+
#
|
2653
|
+
# * The specified DB cluster must have automatic backups enabled, that
|
2654
|
+
# is, its backup retention period must be greater than 0.
|
2655
|
+
#
|
2656
|
+
# * The source DB cluster must be in the same Amazon Web Services Region
|
2657
|
+
# as the read replica. Cross-Region replication isn't supported.
|
2630
2658
|
# @option options [String] :source_region
|
2631
2659
|
# The source region of the snapshot. This is only needed when the
|
2632
2660
|
# shapshot is encrypted and in a different region.
|
@@ -3091,6 +3119,10 @@ module Aws::RDS
|
|
3091
3119
|
# lower. For information about valid engine versions, see
|
3092
3120
|
# `CreateDBInstance`, or call `DescribeDBEngineVersions`.
|
3093
3121
|
#
|
3122
|
+
# If the instance that you're modifying is acting as a read replica,
|
3123
|
+
# the engine version that you specify must be the same or later than the
|
3124
|
+
# version that the source DB instance or cluster is running.
|
3125
|
+
#
|
3094
3126
|
# In RDS Custom for Oracle, this parameter is supported for read
|
3095
3127
|
# replicas only if they are in the `PATCH_DB_FAILURE` lifecycle.
|
3096
3128
|
# @option options [Boolean] :allow_major_version_upgrade
|
data/lib/aws-sdk-rds/errors.rb
CHANGED
@@ -34,6 +34,7 @@ module Aws::RDS
|
|
34
34
|
# * {BlueGreenDeploymentAlreadyExistsFault}
|
35
35
|
# * {BlueGreenDeploymentNotFoundFault}
|
36
36
|
# * {CertificateNotFoundFault}
|
37
|
+
# * {CreateCustomDBEngineVersionFault}
|
37
38
|
# * {CustomAvailabilityZoneNotFoundFault}
|
38
39
|
# * {CustomDBEngineVersionAlreadyExistsFault}
|
39
40
|
# * {CustomDBEngineVersionNotFoundFault}
|
@@ -228,6 +229,16 @@ module Aws::RDS
|
|
228
229
|
end
|
229
230
|
end
|
230
231
|
|
232
|
+
class CreateCustomDBEngineVersionFault < ServiceError
|
233
|
+
|
234
|
+
# @param [Seahorse::Client::RequestContext] context
|
235
|
+
# @param [String] message
|
236
|
+
# @param [Aws::RDS::Types::CreateCustomDBEngineVersionFault] data
|
237
|
+
def initialize(context, message, data = Aws::EmptyStructure.new)
|
238
|
+
super(context, message, data)
|
239
|
+
end
|
240
|
+
end
|
241
|
+
|
231
242
|
class CustomAvailabilityZoneNotFoundFault < ServiceError
|
232
243
|
|
233
244
|
# @param [Seahorse::Client::RequestContext] context
|
data/lib/aws-sdk-rds/resource.rb
CHANGED
@@ -189,10 +189,7 @@ module Aws::RDS
|
|
189
189
|
#
|
190
190
|
# Valid Values:
|
191
191
|
#
|
192
|
-
# * `aurora`
|
193
|
-
#
|
194
|
-
# * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
|
195
|
-
# Aurora)
|
192
|
+
# * `aurora-mysql`
|
196
193
|
#
|
197
194
|
# * `aurora-postgresql`
|
198
195
|
#
|
@@ -204,18 +201,16 @@ module Aws::RDS
|
|
204
201
|
# @option options [String] :engine_version
|
205
202
|
# The version number of the database engine to use.
|
206
203
|
#
|
207
|
-
# To list all of the available engine versions for MySQL
|
208
|
-
#
|
209
|
-
#
|
210
|
-
# `aws rds describe-db-engine-versions --engine aurora --query
|
211
|
-
# "DBEngineVersions[].EngineVersion"`
|
212
|
-
#
|
213
|
-
# To list all of the available engine versions for MySQL 5.7-compatible
|
214
|
-
# and MySQL 8.0-compatible Aurora, use the following command:
|
204
|
+
# To list all of the available engine versions for Aurora MySQL version
|
205
|
+
# 2 (5.7-compatible) and version 3 (MySQL 8.0-compatible), use the
|
206
|
+
# following command:
|
215
207
|
#
|
216
208
|
# `aws rds describe-db-engine-versions --engine aurora-mysql --query
|
217
209
|
# "DBEngineVersions[].EngineVersion"`
|
218
210
|
#
|
211
|
+
# You can supply either `5.7` or `8.0` to use the default engine version
|
212
|
+
# for Aurora MySQL version 2 or version 3, respectively.
|
213
|
+
#
|
219
214
|
# To list all of the available engine versions for Aurora PostgreSQL,
|
220
215
|
# use the following command:
|
221
216
|
#
|
@@ -236,8 +231,8 @@ module Aws::RDS
|
|
236
231
|
#
|
237
232
|
# **Aurora MySQL**
|
238
233
|
#
|
239
|
-
# For information, see [
|
240
|
-
# Aurora User Guide*.
|
234
|
+
# For information, see [Database engine updates for Amazon Aurora
|
235
|
+
# MySQL][1] in the *Amazon Aurora User Guide*.
|
241
236
|
#
|
242
237
|
# **Aurora PostgreSQL**
|
243
238
|
#
|
@@ -246,13 +241,13 @@ module Aws::RDS
|
|
246
241
|
#
|
247
242
|
# **MySQL**
|
248
243
|
#
|
249
|
-
# For information, see [
|
250
|
-
#
|
244
|
+
# For information, see [Amazon RDS for MySQL][3] in the *Amazon RDS User
|
245
|
+
# Guide*.
|
251
246
|
#
|
252
247
|
# **PostgreSQL**
|
253
248
|
#
|
254
|
-
# For information, see [Amazon RDS for PostgreSQL
|
255
|
-
#
|
249
|
+
# For information, see [Amazon RDS for PostgreSQL][4] in the *Amazon RDS
|
250
|
+
# User Guide*.
|
256
251
|
#
|
257
252
|
# Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
258
253
|
#
|
@@ -358,8 +353,7 @@ module Aws::RDS
|
|
358
353
|
# The Amazon Resource Name (ARN) of the source DB instance or DB cluster
|
359
354
|
# if this DB cluster is created as a read replica.
|
360
355
|
#
|
361
|
-
# Valid for: Aurora DB clusters and
|
362
|
-
# clusters
|
356
|
+
# Valid for: Aurora DB clusters and Multi-AZ DB clusters
|
363
357
|
# @option options [Array<Types::Tag>] :tags
|
364
358
|
# Tags to assign to the DB cluster.
|
365
359
|
#
|
@@ -377,7 +371,7 @@ module Aws::RDS
|
|
377
371
|
# different Amazon Web Services account, specify the key ARN or alias
|
378
372
|
# ARN.
|
379
373
|
#
|
380
|
-
# When a KMS key isn't specified in `KmsKeyId
|
374
|
+
# When a KMS key isn't specified in `KmsKeyId`:
|
381
375
|
#
|
382
376
|
# * If `ReplicationSourceIdentifier` identifies an encrypted source,
|
383
377
|
# then Amazon RDS will use the KMS key used to encrypt the source.
|
@@ -512,40 +506,23 @@ module Aws::RDS
|
|
512
506
|
# [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
|
513
507
|
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_LogAccess.html#USER_LogAccess.Procedural.UploadtoCloudWatch
|
514
508
|
# @option options [String] :engine_mode
|
515
|
-
# The DB engine mode of the DB cluster, either `provisioned
|
516
|
-
# `serverless
|
517
|
-
#
|
518
|
-
# The `parallelquery` engine mode isn't required for Aurora MySQL
|
519
|
-
# version 1.23 and higher 1.x versions, and version 2.09 and higher 2.x
|
520
|
-
# versions.
|
521
|
-
#
|
522
|
-
# The `global` engine mode isn't required for Aurora MySQL version 1.22
|
523
|
-
# and higher 1.x versions, and `global` engine mode isn't required for
|
524
|
-
# any 2.x versions.
|
525
|
-
#
|
526
|
-
# The `multimaster` engine mode only applies for DB clusters created
|
527
|
-
# with Aurora MySQL version 5.6.10a.
|
509
|
+
# The DB engine mode of the DB cluster, either `provisioned` or
|
510
|
+
# `serverless`.
|
528
511
|
#
|
529
512
|
# The `serverless` engine mode only applies for Aurora Serverless v1 DB
|
530
513
|
# clusters.
|
531
514
|
#
|
532
|
-
# For Aurora PostgreSQL, the `global` engine mode isn't required, and
|
533
|
-
# both the `parallelquery` and the `multimaster` engine modes currently
|
534
|
-
# aren't supported.
|
535
|
-
#
|
536
515
|
# Limitations and requirements apply to some DB engine modes. For more
|
537
516
|
# information, see the following sections in the *Amazon Aurora User
|
538
|
-
# Guide
|
517
|
+
# Guide*:
|
539
518
|
#
|
540
519
|
# * [Limitations of Aurora Serverless v1][1]
|
541
520
|
#
|
542
521
|
# * [Requirements for Aurora Serverless v2][2]
|
543
522
|
#
|
544
|
-
# * [Limitations of
|
545
|
-
#
|
546
|
-
# * [Limitations of Aurora Global Databases][4]
|
523
|
+
# * [Limitations of parallel query][3]
|
547
524
|
#
|
548
|
-
# * [Limitations of
|
525
|
+
# * [Limitations of Aurora global databases][4]
|
549
526
|
#
|
550
527
|
# Valid for: Aurora DB clusters only
|
551
528
|
#
|
@@ -555,7 +532,6 @@ module Aws::RDS
|
|
555
532
|
# [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.requirements.html
|
556
533
|
# [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations
|
557
534
|
# [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations
|
558
|
-
# [5]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations
|
559
535
|
# @option options [Types::ScalingConfiguration] :scaling_configuration
|
560
536
|
# For DB clusters in `serverless` DB engine mode, the scaling properties
|
561
537
|
# of the DB cluster.
|
@@ -670,8 +646,8 @@ module Aws::RDS
|
|
670
646
|
# be initially allocated for each DB instance in the Multi-AZ DB
|
671
647
|
# cluster.
|
672
648
|
#
|
673
|
-
# For information about valid IOPS values, see [
|
674
|
-
#
|
649
|
+
# For information about valid IOPS values, see [Provisioned IOPS
|
650
|
+
# storage][1] in the *Amazon RDS User Guide*.
|
675
651
|
#
|
676
652
|
# This setting is required to create a Multi-AZ DB cluster.
|
677
653
|
#
|
@@ -2768,8 +2744,6 @@ module Aws::RDS
|
|
2768
2744
|
#
|
2769
2745
|
# Valid Values:
|
2770
2746
|
#
|
2771
|
-
# * `aurora` (for MySQL 5.6-compatible Aurora)
|
2772
|
-
#
|
2773
2747
|
# * `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
|
2774
2748
|
# Aurora)
|
2775
2749
|
#
|