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.
@@ -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, required: true, location_name: "SourceDBInstanceIdentifier"))
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` (for MySQL 5.6-compatible 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 5.6-compatible
957
- # Aurora, use the following command:
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 [MySQL on Amazon RDS Versions][1] in the *Amazon
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 [MySQL on Amazon RDS Versions][3] in the *Amazon
999
- # RDS User Guide*.
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 versions and
1004
- # extensions][4] in the *Amazon RDS User Guide*.
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 RDS for PostgreSQL Multi-AZ DB
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`, `parallelquery`, `global`, or `multimaster`.
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 Parallel Query][3]
1294
- #
1295
- # * [Limitations of Aurora Global Databases][4]
1272
+ # * [Limitations of parallel query][3]
1296
1273
  #
1297
- # * [Limitations of Multi-Master Clusters][5]
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 [Amazon RDS Provisioned
1423
- # IOPS storage][1] in the *Amazon RDS User Guide*.
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
- # To list all of the available engine versions for MySQL 5.6-compatible
2007
- # Aurora, use the following command:
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
- # `aws rds describe-db-engine-versions --engine aurora --query
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.7-compatible
2013
- # and MySQL 8.0-compatible Aurora, use the following command:
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-mysql --query
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
- # To list all of the available engine versions for MySQL 5.6-compatible
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 [MySQL on Amazon RDS Versions][1] in the *Amazon Aurora User
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 [MySQL on Amazon RDS Versions][3] in the *Amazon RDS User Guide.*
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 database is a Multi-AZ
2174
- # DB instance.
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 instance.
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, then do not specify a value
2318
- # for this parameter. A read replica in the same Amazon Web Services
2319
- # Region is always encrypted with the same KMS key as the source DB
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
- # Specify the name of the IAM role to be used when making API calls to
2516
- # the Directory Service.
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
@@ -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
@@ -189,10 +189,7 @@ module Aws::RDS
189
189
  #
190
190
  # Valid Values:
191
191
  #
192
- # * `aurora` (for MySQL 5.6-compatible 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 5.6-compatible
208
- # Aurora, use the following command:
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 [MySQL on Amazon RDS Versions][1] in the *Amazon
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 [MySQL on Amazon RDS Versions][3] in the *Amazon
250
- # RDS User Guide*.
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 versions and
255
- # extensions][4] in the *Amazon RDS User Guide*.
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 RDS for PostgreSQL Multi-AZ DB
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`, `parallelquery`, `global`, or `multimaster`.
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 Parallel Query][3]
545
- #
546
- # * [Limitations of Aurora Global Databases][4]
523
+ # * [Limitations of parallel query][3]
547
524
  #
548
- # * [Limitations of Multi-Master Clusters][5]
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 [Amazon RDS Provisioned
674
- # IOPS storage][1] in the *Amazon RDS User Guide*.
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
  #