aws-sdk-rds 1.144.0 → 1.147.0

Sign up to get free protection for your applications and to get access to all the features.
@@ -765,7 +765,7 @@ module Aws::RDS
765
765
  # For more information on backtracking, see [ Backtracking an Aurora DB
766
766
  # Cluster][1] in the *Amazon Aurora User Guide*.
767
767
  #
768
- # <note markdown="1"> This action only applies to Aurora MySQL DB clusters.
768
+ # <note markdown="1"> This action applies only to Aurora MySQL DB clusters.
769
769
  #
770
770
  # </note>
771
771
  #
@@ -1020,60 +1020,16 @@ module Aws::RDS
1020
1020
  #
1021
1021
  # You can copy an encrypted DB cluster snapshot from another Amazon Web
1022
1022
  # Services Region. In that case, the Amazon Web Services Region where
1023
- # you call the `CopyDBClusterSnapshot` action is the destination Amazon
1024
- # Web Services Region for the encrypted DB cluster snapshot to be copied
1025
- # to. To copy an encrypted DB cluster snapshot from another Amazon Web
1026
- # Services Region, you must provide the following values:
1023
+ # you call the `CopyDBClusterSnapshot` operation is the destination
1024
+ # Amazon Web Services Region for the encrypted DB cluster snapshot to be
1025
+ # copied to. To copy an encrypted DB cluster snapshot from another
1026
+ # Amazon Web Services Region, you must provide the following values:
1027
1027
  #
1028
1028
  # * `KmsKeyId` - The Amazon Web Services Key Management System (Amazon
1029
1029
  # Web Services KMS) key identifier for the key to use to encrypt the
1030
1030
  # copy of the DB cluster snapshot in the destination Amazon Web
1031
1031
  # Services Region.
1032
1032
  #
1033
- # * `PreSignedUrl` - A URL that contains a Signature Version 4 signed
1034
- # request for the `CopyDBClusterSnapshot` action to be called in the
1035
- # source Amazon Web Services Region where the DB cluster snapshot is
1036
- # copied from. The pre-signed URL must be a valid request for the
1037
- # `CopyDBClusterSnapshot` API action that can be executed in the
1038
- # source Amazon Web Services Region that contains the encrypted DB
1039
- # cluster snapshot to be copied.
1040
- #
1041
- # The pre-signed URL request must contain the following parameter
1042
- # values:
1043
- #
1044
- # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the
1045
- # KMS key to use to encrypt the copy of the DB cluster snapshot in
1046
- # the destination Amazon Web Services Region. This is the same
1047
- # identifier for both the `CopyDBClusterSnapshot` action that is
1048
- # called in the destination Amazon Web Services Region, and the
1049
- # action contained in the pre-signed URL.
1050
- #
1051
- # * `DestinationRegion` - The name of the Amazon Web Services Region
1052
- # that the DB cluster snapshot is to be created in.
1053
- #
1054
- # * `SourceDBClusterSnapshotIdentifier` - The DB cluster snapshot
1055
- # identifier for the encrypted DB cluster snapshot to be copied.
1056
- # This identifier must be in the Amazon Resource Name (ARN) format
1057
- # for the source Amazon Web Services Region. For example, if you are
1058
- # copying an encrypted DB cluster snapshot from the us-west-2 Amazon
1059
- # Web Services Region, then your `SourceDBClusterSnapshotIdentifier`
1060
- # looks like the following example:
1061
- # `arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115`.
1062
- #
1063
- # To learn how to generate a Signature Version 4 signed request, see [
1064
- # Authenticating Requests: Using Query Parameters (Amazon Web Services
1065
- # Signature Version 4)][1] and [ Signature Version 4 Signing
1066
- # Process][2].
1067
- #
1068
- # <note markdown="1"> If you are using an Amazon Web Services SDK tool or the CLI, you can
1069
- # specify `SourceRegion` (or `--source-region` for the CLI) instead of
1070
- # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
1071
- # autogenerates a pre-signed URL that is a valid request for the
1072
- # operation that can be executed in the source Amazon Web Services
1073
- # Region.
1074
- #
1075
- # </note>
1076
- #
1077
1033
  # * `TargetDBClusterSnapshotIdentifier` - The identifier for the new
1078
1034
  # copy of the DB cluster snapshot in the destination Amazon Web
1079
1035
  # Services Region.
@@ -1082,7 +1038,7 @@ module Aws::RDS
1082
1038
  # identifier for the encrypted DB cluster snapshot to be copied. This
1083
1039
  # identifier must be in the ARN format for the source Amazon Web
1084
1040
  # Services Region and is the same value as the
1085
- # `SourceDBClusterSnapshotIdentifier` in the pre-signed URL.
1041
+ # `SourceDBClusterSnapshotIdentifier` in the presigned URL.
1086
1042
  #
1087
1043
  # To cancel the copy operation once it is in progress, delete the target
1088
1044
  # DB cluster snapshot identified by `TargetDBClusterSnapshotIdentifier`
@@ -1090,22 +1046,20 @@ module Aws::RDS
1090
1046
  #
1091
1047
  # For more information on copying encrypted Amazon Aurora DB cluster
1092
1048
  # snapshots from one Amazon Web Services Region to another, see [
1093
- # Copying a Snapshot][3] in the *Amazon Aurora User Guide*.
1049
+ # Copying a Snapshot][1] in the *Amazon Aurora User Guide*.
1094
1050
  #
1095
1051
  # For more information on Amazon Aurora DB clusters, see [ What is
1096
- # Amazon Aurora?][4] in the *Amazon Aurora User Guide*.
1052
+ # Amazon Aurora?][2] in the *Amazon Aurora User Guide*.
1097
1053
  #
1098
1054
  # For more information on Multi-AZ DB clusters, see [ Multi-AZ
1099
- # deployments with two readable standby DB instances][5] in the *Amazon
1055
+ # deployments with two readable standby DB instances][3] in the *Amazon
1100
1056
  # RDS User Guide*.
1101
1057
  #
1102
1058
  #
1103
1059
  #
1104
- # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
1105
- # [2]: https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html
1106
- # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CopySnapshot.html
1107
- # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
1108
- # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
1060
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_CopySnapshot.html
1061
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html
1062
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/multi-az-db-clusters-concepts.html
1109
1063
  #
1110
1064
  # @option params [required, String] :source_db_cluster_snapshot_identifier
1111
1065
  # The identifier of the DB cluster snapshot to copy. This parameter
@@ -1173,26 +1127,30 @@ module Aws::RDS
1173
1127
  # the `KmsKeyId` parameter, an error is returned.
1174
1128
  #
1175
1129
  # @option params [String] :pre_signed_url
1176
- # The URL that contains a Signature Version 4 signed request for the
1177
- # `CopyDBClusterSnapshot` API action in the Amazon Web Services Region
1178
- # that contains the source DB cluster snapshot to copy. The
1179
- # `PreSignedUrl` parameter must be used when copying an encrypted DB
1180
- # cluster snapshot from another Amazon Web Services Region. Don't
1181
- # specify `PreSignedUrl` when you are copying an encrypted DB cluster
1182
- # snapshot in the same Amazon Web Services Region.
1130
+ # When you are copying a DB cluster snapshot from one Amazon Web
1131
+ # Services GovCloud (US) Region to another, the URL that contains a
1132
+ # Signature Version 4 signed request for the `CopyDBClusterSnapshot` API
1133
+ # operation in the Amazon Web Services Region that contains the source
1134
+ # DB cluster snapshot to copy. Use the `PreSignedUrl` parameter when
1135
+ # copying an encrypted DB cluster snapshot from another Amazon Web
1136
+ # Services Region. Don't specify `PreSignedUrl` when copying an
1137
+ # encrypted DB cluster snapshot in the same Amazon Web Services Region.
1138
+ #
1139
+ # This setting applies only to Amazon Web Services GovCloud (US)
1140
+ # Regions. It's ignored in other Amazon Web Services Regions.
1183
1141
  #
1184
- # The pre-signed URL must be a valid request for the
1185
- # `CopyDBClusterSnapshot` API action that can be executed in the source
1142
+ # The presigned URL must be a valid request for the
1143
+ # `CopyDBClusterSnapshot` API operation that can run in the source
1186
1144
  # Amazon Web Services Region that contains the encrypted DB cluster
1187
- # snapshot to be copied. The pre-signed URL request must contain the
1188
- # following parameter values:
1145
+ # snapshot to copy. The presigned URL request must contain the following
1146
+ # parameter values:
1189
1147
  #
1190
- # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
1191
- # key to use to encrypt the copy of the DB cluster snapshot in the
1192
- # destination Amazon Web Services Region. This is the same identifier
1193
- # for both the `CopyDBClusterSnapshot` action that is called in the
1194
- # destination Amazon Web Services Region, and the action contained in
1195
- # the pre-signed URL.
1148
+ # * `KmsKeyId` - The KMS key identifier for the KMS key to use to
1149
+ # encrypt the copy of the DB cluster snapshot in the destination
1150
+ # Amazon Web Services Region. This is the same identifier for both the
1151
+ # `CopyDBClusterSnapshot` operation that is called in the destination
1152
+ # Amazon Web Services Region, and the operation contained in the
1153
+ # presigned URL.
1196
1154
  #
1197
1155
  # * `DestinationRegion` - The name of the Amazon Web Services Region
1198
1156
  # that the DB cluster snapshot is to be created in.
@@ -1214,9 +1172,8 @@ module Aws::RDS
1214
1172
  # <note markdown="1"> If you are using an Amazon Web Services SDK tool or the CLI, you can
1215
1173
  # specify `SourceRegion` (or `--source-region` for the CLI) instead of
1216
1174
  # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
1217
- # autogenerates a pre-signed URL that is a valid request for the
1218
- # operation that can be executed in the source Amazon Web Services
1219
- # Region.
1175
+ # autogenerates a presigned URL that is a valid request for the
1176
+ # operation that can run in the source Amazon Web Services Region.
1220
1177
  #
1221
1178
  # </note>
1222
1179
  #
@@ -1415,7 +1372,7 @@ module Aws::RDS
1415
1372
  #
1416
1373
  # You can copy a snapshot from one Amazon Web Services Region to
1417
1374
  # another. In that case, the Amazon Web Services Region where you call
1418
- # the `CopyDBSnapshot` action is the destination Amazon Web Services
1375
+ # the `CopyDBSnapshot` operation is the destination Amazon Web Services
1419
1376
  # Region for the DB snapshot copy.
1420
1377
  #
1421
1378
  # This command doesn't apply to RDS Custom.
@@ -1443,8 +1400,7 @@ module Aws::RDS
1443
1400
  # must be the Amazon Resource Name (ARN) of the shared DB snapshot.
1444
1401
  #
1445
1402
  # If you are copying an encrypted snapshot this parameter must be in the
1446
- # ARN format for the source Amazon Web Services Region, and must match
1447
- # the `SourceDBSnapshotIdentifier` in the `PreSignedUrl` parameter.
1403
+ # ARN format for the source Amazon Web Services Region.
1448
1404
  #
1449
1405
  # Constraints:
1450
1406
  #
@@ -1510,39 +1466,46 @@ module Aws::RDS
1510
1466
  # snapshot to the target DB snapshot. By default, tags are not copied.
1511
1467
  #
1512
1468
  # @option params [String] :pre_signed_url
1513
- # The URL that contains a Signature Version 4 signed request for the
1514
- # `CopyDBSnapshot` API action in the source Amazon Web Services Region
1515
- # that contains the source DB snapshot to copy.
1469
+ # When you are copying a snapshot from one Amazon Web Services GovCloud
1470
+ # (US) Region to another, the URL that contains a Signature Version 4
1471
+ # signed request for the `CopyDBSnapshot` API operation in the source
1472
+ # Amazon Web Services Region that contains the source DB snapshot to
1473
+ # copy.
1474
+ #
1475
+ # This setting applies only to Amazon Web Services GovCloud (US)
1476
+ # Regions. It's ignored in other Amazon Web Services Regions.
1516
1477
  #
1517
1478
  # You must specify this parameter when you copy an encrypted DB snapshot
1518
1479
  # from another Amazon Web Services Region by using the Amazon RDS API.
1519
1480
  # Don't specify `PreSignedUrl` when you are copying an encrypted DB
1520
1481
  # snapshot in the same Amazon Web Services Region.
1521
1482
  #
1522
- # The presigned URL must be a valid request for the `CopyDBSnapshot` API
1523
- # action that can be executed in the source Amazon Web Services Region
1524
- # that contains the encrypted DB snapshot to be copied. The presigned
1525
- # URL request must contain the following parameter values:
1483
+ # The presigned URL must be a valid request for the
1484
+ # `CopyDBClusterSnapshot` API operation that can run in the source
1485
+ # Amazon Web Services Region that contains the encrypted DB cluster
1486
+ # snapshot to copy. The presigned URL request must contain the following
1487
+ # parameter values:
1526
1488
  #
1527
1489
  # * `DestinationRegion` - The Amazon Web Services Region that the
1528
1490
  # encrypted DB snapshot is copied to. This Amazon Web Services Region
1529
- # is the same one where the `CopyDBSnapshot` action is called that
1491
+ # is the same one where the `CopyDBSnapshot` operation is called that
1530
1492
  # contains this presigned URL.
1531
1493
  #
1532
1494
  # For example, if you copy an encrypted DB snapshot from the us-west-2
1533
1495
  # Amazon Web Services Region to the us-east-1 Amazon Web Services
1534
- # Region, then you call the `CopyDBSnapshot` action in the us-east-1
1535
- # Amazon Web Services Region and provide a presigned URL that contains
1536
- # a call to the `CopyDBSnapshot` action in the us-west-2 Amazon Web
1537
- # Services Region. For this example, the `DestinationRegion` in the
1538
- # presigned URL must be set to the us-east-1 Amazon Web Services
1539
- # Region.
1540
- #
1541
- # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
1542
- # key to use to encrypt the copy of the DB snapshot in the destination
1543
- # Amazon Web Services Region. This is the same identifier for both the
1544
- # `CopyDBSnapshot` action that is called in the destination Amazon Web
1545
- # Services Region, and the action contained in the presigned URL.
1496
+ # Region, then you call the `CopyDBSnapshot` operation in the
1497
+ # us-east-1 Amazon Web Services Region and provide a presigned URL
1498
+ # that contains a call to the `CopyDBSnapshot` operation in the
1499
+ # us-west-2 Amazon Web Services Region. For this example, the
1500
+ # `DestinationRegion` in the presigned URL must be set to the
1501
+ # us-east-1 Amazon Web Services Region.
1502
+ #
1503
+ # * `KmsKeyId` - The KMS key identifier for the KMS key to use to
1504
+ # encrypt the copy of the DB snapshot in the destination Amazon Web
1505
+ # Services Region. This is the same identifier for both the
1506
+ # `CopyDBSnapshot` operation that is called in the destination Amazon
1507
+ # Web Services Region, and the operation contained in the presigned
1508
+ # URL.
1546
1509
  #
1547
1510
  # * `SourceDBSnapshotIdentifier` - The DB snapshot identifier for the
1548
1511
  # encrypted snapshot to be copied. This identifier must be in the
@@ -1559,9 +1522,8 @@ module Aws::RDS
1559
1522
  # <note markdown="1"> If you are using an Amazon Web Services SDK tool or the CLI, you can
1560
1523
  # specify `SourceRegion` (or `--source-region` for the CLI) instead of
1561
1524
  # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
1562
- # autogenerates a pre-signed URL that is a valid request for the
1563
- # operation that can be executed in the source Amazon Web Services
1564
- # Region.
1525
+ # autogenerates a presigned URL that is a valid request for the
1526
+ # operation that can run in the source Amazon Web Services Region.
1565
1527
  #
1566
1528
  # </note>
1567
1529
  #
@@ -2040,10 +2002,7 @@ module Aws::RDS
2040
2002
  #
2041
2003
  # You can use the `ReplicationSourceIdentifier` parameter to create an
2042
2004
  # Amazon Aurora DB cluster as a read replica of another DB cluster or
2043
- # Amazon RDS MySQL or PostgreSQL DB instance. For cross-Region
2044
- # replication where the DB cluster identified by
2045
- # `ReplicationSourceIdentifier` is encrypted, also specify the
2046
- # `PreSignedUrl` parameter.
2005
+ # Amazon RDS MySQL or PostgreSQL DB instance.
2047
2006
  #
2048
2007
  # For more information on Amazon Aurora, see [ What is Amazon
2049
2008
  # Aurora?][1] in the *Amazon Aurora User Guide*.
@@ -2366,25 +2325,25 @@ module Aws::RDS
2366
2325
  # Valid for: Aurora DB clusters and Multi-AZ DB clusters
2367
2326
  #
2368
2327
  # @option params [String] :pre_signed_url
2369
- # A URL that contains a Signature Version 4 signed request for the
2370
- # `CreateDBCluster` action to be called in the source Amazon Web
2371
- # Services Region where the DB cluster is replicated from. Specify
2372
- # `PreSignedUrl` only when you are performing cross-Region replication
2373
- # from an encrypted DB cluster.
2374
- #
2375
- # The pre-signed URL must be a valid request for the `CreateDBCluster`
2376
- # API action that can be executed in the source Amazon Web Services
2377
- # Region that contains the encrypted DB cluster to be copied.
2378
- #
2379
- # The pre-signed URL request must contain the following parameter
2380
- # values:
2381
- #
2382
- # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the KMS
2383
- # key to use to encrypt the copy of the DB cluster in the destination
2384
- # Amazon Web Services Region. This should refer to the same KMS key
2385
- # for both the `CreateDBCluster` action that is called in the
2386
- # destination Amazon Web Services Region, and the action contained in
2387
- # the pre-signed URL.
2328
+ # When you are replicating a DB cluster from one Amazon Web Services
2329
+ # GovCloud (US) Region to another, an URL that contains a Signature
2330
+ # Version 4 signed request for the `CreateDBCluster` operation to be
2331
+ # called in the source Amazon Web Services Region where the DB cluster
2332
+ # is replicated from. Specify `PreSignedUrl` only when you are
2333
+ # performing cross-Region replication from an encrypted DB cluster.
2334
+ #
2335
+ # The presigned URL must be a valid request for the `CreateDBCluster`
2336
+ # API operation that can run in the source Amazon Web Services Region
2337
+ # that contains the encrypted DB cluster to copy.
2338
+ #
2339
+ # The presigned URL request must contain the following parameter values:
2340
+ #
2341
+ # * `KmsKeyId` - The KMS key identifier for the KMS key to use to
2342
+ # encrypt the copy of the DB cluster in the destination Amazon Web
2343
+ # Services Region. This should refer to the same KMS key for both the
2344
+ # `CreateDBCluster` operation that is called in the destination Amazon
2345
+ # Web Services Region, and the operation contained in the presigned
2346
+ # URL.
2388
2347
  #
2389
2348
  # * `DestinationRegion` - The name of the Amazon Web Services Region
2390
2349
  # that Aurora read replica will be created in.
@@ -2405,9 +2364,8 @@ module Aws::RDS
2405
2364
  # <note markdown="1"> If you are using an Amazon Web Services SDK tool or the CLI, you can
2406
2365
  # specify `SourceRegion` (or `--source-region` for the CLI) instead of
2407
2366
  # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
2408
- # autogenerates a pre-signed URL that is a valid request for the
2409
- # operation that can be executed in the source Amazon Web Services
2410
- # Region.
2367
+ # autogenerates a presigned URL that is a valid request for the
2368
+ # operation that can run in the source Amazon Web Services Region.
2411
2369
  #
2412
2370
  # </note>
2413
2371
  #
@@ -2424,7 +2382,7 @@ module Aws::RDS
2424
2382
  # accounts. By default, mapping isn't enabled.
2425
2383
  #
2426
2384
  # For more information, see [ IAM Database Authentication][1] in the
2427
- # *Amazon Aurora User Guide.*.
2385
+ # *Amazon Aurora User Guide*.
2428
2386
  #
2429
2387
  # Valid for: Aurora DB clusters only
2430
2388
  #
@@ -2498,6 +2456,9 @@ module Aws::RDS
2498
2456
  # The `multimaster` engine mode only applies for DB clusters created
2499
2457
  # with Aurora MySQL version 5.6.10a.
2500
2458
  #
2459
+ # The `serverless` engine mode only applies for Aurora Serverless v1 DB
2460
+ # clusters.
2461
+ #
2501
2462
  # For Aurora PostgreSQL, the `global` engine mode isn't required, and
2502
2463
  # both the `parallelquery` and the `multimaster` engine modes currently
2503
2464
  # aren't supported.
@@ -2506,22 +2467,25 @@ module Aws::RDS
2506
2467
  # information, see the following sections in the *Amazon Aurora User
2507
2468
  # Guide*\:
2508
2469
  #
2509
- # * [ Limitations of Aurora Serverless v1][1]
2470
+ # * [Limitations of Aurora Serverless v1][1]
2510
2471
  #
2511
- # * [ Limitations of Parallel Query][2]
2472
+ # * [Requirements for Aurora Serverless v2][2]
2512
2473
  #
2513
- # * [ Limitations of Aurora Global Databases][3]
2474
+ # * [Limitations of Parallel Query][3]
2514
2475
  #
2515
- # * [ Limitations of Multi-Master Clusters][4]
2476
+ # * [Limitations of Aurora Global Databases][4]
2477
+ #
2478
+ # * [Limitations of Multi-Master Clusters][5]
2516
2479
  #
2517
2480
  # Valid for: Aurora DB clusters only
2518
2481
  #
2519
2482
  #
2520
2483
  #
2521
2484
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html#aurora-serverless.limitations
2522
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations
2523
- # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations
2524
- # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations
2485
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.requirements.html
2486
+ # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations
2487
+ # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations
2488
+ # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations
2525
2489
  #
2526
2490
  # @option params [Types::ScalingConfiguration] :scaling_configuration
2527
2491
  # For DB clusters in `serverless` DB engine mode, the scaling properties
@@ -2763,8 +2727,27 @@ module Aws::RDS
2763
2727
  # Valid for: Multi-AZ DB clusters only
2764
2728
  #
2765
2729
  # @option params [Integer] :performance_insights_retention_period
2766
- # The amount of time, in days, to retain Performance Insights data.
2767
- # Valid values are 7 or 731 (2 years).
2730
+ # The number of days to retain Performance Insights data. The default is
2731
+ # 7 days. The following values are valid:
2732
+ #
2733
+ # * 7
2734
+ #
2735
+ # * *month* * 31, where *month* is a number of months from 1-23
2736
+ #
2737
+ # * 731
2738
+ #
2739
+ # For example, the following values are valid:
2740
+ #
2741
+ # * 93 (3 months * 31)
2742
+ #
2743
+ # * 341 (11 months * 31)
2744
+ #
2745
+ # * 589 (19 months * 31)
2746
+ #
2747
+ # * 731
2748
+ #
2749
+ # If you specify a retention period such as 94, which isn't a valid
2750
+ # value, RDS issues an error.
2768
2751
  #
2769
2752
  # Valid for: Multi-AZ DB clusters only
2770
2753
  #
@@ -2997,7 +2980,7 @@ module Aws::RDS
2997
2980
  # Creates a new custom endpoint and associates it with an Amazon Aurora
2998
2981
  # DB cluster.
2999
2982
  #
3000
- # <note markdown="1"> This action only applies to Aurora DB clusters.
2983
+ # <note markdown="1"> This action applies only to Aurora DB clusters.
3001
2984
  #
3002
2985
  # </note>
3003
2986
  #
@@ -3109,8 +3092,9 @@ module Aws::RDS
3109
3092
  # the default database for a DB cluster, such as the character set for
3110
3093
  # the default database defined by the `character_set_database`
3111
3094
  # parameter. You can use the *Parameter Groups* option of the [Amazon
3112
- # RDS console][1] or the `DescribeDBClusterParameters` action to verify
3113
- # that your DB cluster parameter group has been created or modified.
3095
+ # RDS console][1] or the `DescribeDBClusterParameters` operation to
3096
+ # verify that your DB cluster parameter group has been created or
3097
+ # modified.
3114
3098
  #
3115
3099
  # For more information on Amazon Aurora, see [ What is Amazon
3116
3100
  # Aurora?][2] in the *Amazon Aurora User Guide*.
@@ -3363,6 +3347,23 @@ module Aws::RDS
3363
3347
 
3364
3348
  # Creates a new DB instance.
3365
3349
  #
3350
+ # The new DB instance can be an RDS DB instance, or it can be a DB
3351
+ # instance in an Aurora DB cluster. For an Aurora DB cluster, you can
3352
+ # call this operation multiple times to add more than one DB instance to
3353
+ # the cluster.
3354
+ #
3355
+ # For more information about creating an RDS DB instance, see [ Creating
3356
+ # an Amazon RDS DB instance][1] in the *Amazon RDS User Guide*.
3357
+ #
3358
+ # For more information about creating a DB instance in an Aurora DB
3359
+ # cluster, see [ Creating an Amazon Aurora DB cluster][2] in the *Amazon
3360
+ # Aurora User Guide*.
3361
+ #
3362
+ #
3363
+ #
3364
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html
3365
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html
3366
+ #
3366
3367
  # @option params [String] :db_name
3367
3368
  # The meaning of this parameter differs according to the database engine
3368
3369
  # you use.
@@ -3596,14 +3597,16 @@ module Aws::RDS
3596
3597
  #
3597
3598
  # @option params [required, String] :db_instance_class
3598
3599
  # The compute and memory capacity of the DB instance, for example
3599
- # db.m4.large. Not all DB instance classes are available in all Amazon
3600
+ # db.m5.large. Not all DB instance classes are available in all Amazon
3600
3601
  # Web Services Regions, or for all database engines. For the full list
3601
3602
  # of DB instance classes, and availability for your engine, see [DB
3602
- # Instance Class][1] in the *Amazon RDS User Guide*.
3603
+ # instance classes][1] in the *Amazon RDS User Guide* or [Aurora DB
3604
+ # instance classes][2] in the *Amazon Aurora User Guide*.
3603
3605
  #
3604
3606
  #
3605
3607
  #
3606
3608
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
3609
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.DBInstanceClass.html
3607
3610
  #
3608
3611
  # @option params [required, String] :engine
3609
3612
  # The name of the database engine to be used for this instance.
@@ -3702,7 +3705,9 @@ module Aws::RDS
3702
3705
  # @option params [Array<String>] :db_security_groups
3703
3706
  # A list of DB security groups to associate with this DB instance.
3704
3707
  #
3705
- # Default: The default DB security group for the database engine.
3708
+ # This setting applies to the legacy EC2-Classic platform, which is no
3709
+ # longer used to create new DB instances. Use the `VpcSecurityGroupIds`
3710
+ # setting instead.
3706
3711
  #
3707
3712
  # @option params [Array<String>] :vpc_security_group_ids
3708
3713
  # A list of Amazon EC2 VPC security groups to associate with this DB
@@ -3738,19 +3743,9 @@ module Aws::RDS
3738
3743
  # Zone must be in the same Amazon Web Services Region as the current
3739
3744
  # endpoint.
3740
3745
  #
3741
- # <note markdown="1"> If you're creating a DB instance in an RDS on VMware environment,
3742
- # specify the identifier of the custom Availability Zone to create the
3743
- # DB instance in.
3744
- #
3745
- # For more information about RDS on VMware, see the [ RDS on VMware User
3746
- # Guide.][2]
3747
- #
3748
- # </note>
3749
- #
3750
3746
  #
3751
3747
  #
3752
3748
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.RegionsAndAvailabilityZones.html
3753
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/RDSonVMwareUserGuide/rds-on-vmware.html
3754
3749
  #
3755
3750
  # @option params [String] :db_subnet_group_name
3756
3751
  # A DB subnet group to associate with this DB instance.
@@ -3812,7 +3807,7 @@ module Aws::RDS
3812
3807
  #
3813
3808
  # * Can't be set to 0 if the DB instance is a source to read replicas
3814
3809
  #
3815
- # * Can't be set to 0 or 35 for an RDS Custom for Oracle DB instance
3810
+ # * Can't be set to 0 for an RDS Custom for Oracle DB instance
3816
3811
  #
3817
3812
  # @option params [String] :preferred_backup_window
3818
3813
  # The daily time range during which automated backups are created if
@@ -3895,11 +3890,16 @@ module Aws::RDS
3895
3890
  #
3896
3891
  # This setting doesn't apply to RDS Custom.
3897
3892
  #
3893
+ # **Amazon Aurora**
3894
+ #
3895
+ # Not applicable. DB instance Availability Zones (AZs) are managed by
3896
+ # the DB cluster.
3897
+ #
3898
3898
  # @option params [String] :engine_version
3899
3899
  # The version number of the database engine to use.
3900
3900
  #
3901
3901
  # For a list of valid engine versions, use the
3902
- # `DescribeDBEngineVersions` action.
3902
+ # `DescribeDBEngineVersions` operation.
3903
3903
  #
3904
3904
  # The following are the database engines and links to information about
3905
3905
  # the major and minor versions that are available with Amazon RDS. Not
@@ -3952,7 +3952,7 @@ module Aws::RDS
3952
3952
  #
3953
3953
  #
3954
3954
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-creating.html#custom-creating.create
3955
- # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-reqs-limits.html#custom-reqs-limits.reqsMS
3955
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-reqs-limits-MS.html
3956
3956
  # [3]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MariaDB.html#MariaDB.Concepts.VersionMgmt
3957
3957
  # [4]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_SQLServer.html#SQLServer.Concepts.General.VersionSupport
3958
3958
  # [5]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_MySQL.html#MySQL.Concepts.VersionMgmt
@@ -3975,6 +3975,10 @@ module Aws::RDS
3975
3975
  #
3976
3976
  # This setting doesn't apply to RDS Custom.
3977
3977
  #
3978
+ # **Amazon Aurora**
3979
+ #
3980
+ # Not applicable.
3981
+ #
3978
3982
  # @option params [Integer] :iops
3979
3983
  # The amount of Provisioned IOPS (input/output operations per second) to
3980
3984
  # be initially allocated for the DB instance. For information about
@@ -3986,6 +3990,10 @@ module Aws::RDS
3986
3990
  # instance. For SQL Server DB instances, must be a multiple between 1
3987
3991
  # and 50 of the storage amount for the DB instance.
3988
3992
  #
3993
+ # **Amazon Aurora**
3994
+ #
3995
+ # Not applicable. Storage is managed by the DB cluster.
3996
+ #
3989
3997
  #
3990
3998
  #
3991
3999
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_Storage.html#USER_PIOPS
@@ -4001,6 +4009,10 @@ module Aws::RDS
4001
4009
  #
4002
4010
  # This setting doesn't apply to RDS Custom.
4003
4011
  #
4012
+ # **Amazon Aurora**
4013
+ #
4014
+ # Not applicable.
4015
+ #
4004
4016
  # @option params [String] :character_set_name
4005
4017
  # For supported engines, this value indicates that the DB instance
4006
4018
  # should be associated with the specified `CharacterSet`.
@@ -4071,12 +4083,20 @@ module Aws::RDS
4071
4083
  #
4072
4084
  # Default: `io1` if the `Iops` parameter is specified, otherwise `gp2`
4073
4085
  #
4086
+ # **Amazon Aurora**
4087
+ #
4088
+ # Not applicable. Storage is managed by the DB cluster.
4089
+ #
4074
4090
  # @option params [String] :tde_credential_arn
4075
4091
  # The ARN from the key store with which to associate the instance for
4076
4092
  # TDE encryption.
4077
4093
  #
4078
4094
  # This setting doesn't apply to RDS Custom.
4079
4095
  #
4096
+ # **Amazon Aurora**
4097
+ #
4098
+ # Not applicable.
4099
+ #
4080
4100
  # @option params [String] :tde_credential_password
4081
4101
  # The password for the given ARN from the key store in order to access
4082
4102
  # the device.
@@ -4133,6 +4153,10 @@ module Aws::RDS
4133
4153
  #
4134
4154
  # This setting doesn't apply to RDS Custom.
4135
4155
  #
4156
+ # **Amazon Aurora**
4157
+ #
4158
+ # Not applicable. The domain is managed by the DB cluster.
4159
+ #
4136
4160
  #
4137
4161
  #
4138
4162
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html
@@ -4181,6 +4205,10 @@ module Aws::RDS
4181
4205
  #
4182
4206
  # This setting doesn't apply to RDS Custom.
4183
4207
  #
4208
+ # **Amazon Aurora**
4209
+ #
4210
+ # Not applicable. The domain is managed by the DB cluster.
4211
+ #
4184
4212
  # @option params [Integer] :promotion_tier
4185
4213
  # A value that specifies the order in which an Aurora Replica is
4186
4214
  # promoted to the primary instance after a failure of the existing
@@ -4210,13 +4238,16 @@ module Aws::RDS
4210
4238
  # Services Identity and Access Management (IAM) accounts to database
4211
4239
  # accounts. By default, mapping isn't enabled.
4212
4240
  #
4213
- # This setting doesn't apply to RDS Custom or Amazon Aurora. In Aurora,
4214
- # mapping Amazon Web Services IAM accounts to database accounts is
4215
- # managed by the DB cluster.
4216
- #
4217
4241
  # For more information, see [ IAM Database Authentication for MySQL and
4218
4242
  # PostgreSQL][1] in the *Amazon RDS User Guide*.
4219
4243
  #
4244
+ # This setting doesn't apply to RDS Custom.
4245
+ #
4246
+ # **Amazon Aurora**
4247
+ #
4248
+ # Not applicable. Mapping Amazon Web Services IAM accounts to database
4249
+ # accounts is managed by the DB cluster.
4250
+ #
4220
4251
  #
4221
4252
  #
4222
4253
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html
@@ -4247,8 +4278,27 @@ module Aws::RDS
4247
4278
  # This setting doesn't apply to RDS Custom.
4248
4279
  #
4249
4280
  # @option params [Integer] :performance_insights_retention_period
4250
- # The amount of time, in days, to retain Performance Insights data.
4251
- # Valid values are 7 or 731 (2 years).
4281
+ # The number of days to retain Performance Insights data. The default is
4282
+ # 7 days. The following values are valid:
4283
+ #
4284
+ # * 7
4285
+ #
4286
+ # * *month* * 31, where *month* is a number of months from 1-23
4287
+ #
4288
+ # * 731
4289
+ #
4290
+ # For example, the following values are valid:
4291
+ #
4292
+ # * 93 (3 months * 31)
4293
+ #
4294
+ # * 341 (11 months * 31)
4295
+ #
4296
+ # * 589 (19 months * 31)
4297
+ #
4298
+ # * 731
4299
+ #
4300
+ # If you specify a retention period such as 94, which isn't a valid
4301
+ # value, RDS issues an error.
4252
4302
  #
4253
4303
  # This setting doesn't apply to RDS Custom.
4254
4304
  #
@@ -4297,6 +4347,10 @@ module Aws::RDS
4297
4347
  #
4298
4348
  # This setting doesn't apply to RDS Custom.
4299
4349
  #
4350
+ # **Amazon Aurora**
4351
+ #
4352
+ # Not applicable.
4353
+ #
4300
4354
  # @option params [Boolean] :deletion_protection
4301
4355
  # A value that indicates whether the DB instance has deletion protection
4302
4356
  # enabled. The database can't be deleted when deletion protection is
@@ -4324,6 +4378,10 @@ module Aws::RDS
4324
4378
  #
4325
4379
  # This setting doesn't apply to RDS Custom.
4326
4380
  #
4381
+ # **Amazon Aurora**
4382
+ #
4383
+ # Not applicable. Storage is managed by the DB cluster.
4384
+ #
4327
4385
  #
4328
4386
  #
4329
4387
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
@@ -4384,6 +4442,26 @@ module Aws::RDS
4384
4442
  #
4385
4443
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
4386
4444
  #
4445
+ # @option params [String] :network_type
4446
+ # The network type of the DB instance.
4447
+ #
4448
+ # Valid values:
4449
+ #
4450
+ # * `IPV4`
4451
+ #
4452
+ # * `DUAL`
4453
+ #
4454
+ # The network type is determined by the `DBSubnetGroup` specified for
4455
+ # the DB instance. A `DBSubnetGroup` can support only the IPv4 protocol
4456
+ # or the IPv4 and the IPv6 protocols (`DUAL`).
4457
+ #
4458
+ # For more information, see [ Working with a DB instance in a VPC][1] in
4459
+ # the *Amazon RDS User Guide.*
4460
+ #
4461
+ #
4462
+ #
4463
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html
4464
+ #
4387
4465
  # @return [Types::CreateDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
4388
4466
  #
4389
4467
  # * {Types::CreateDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -4471,6 +4549,7 @@ module Aws::RDS
4471
4549
  # enable_customer_owned_ip: false,
4472
4550
  # custom_iam_instance_profile: "String",
4473
4551
  # backup_target: "String",
4552
+ # network_type: "String",
4474
4553
  # })
4475
4554
  #
4476
4555
  # @example Response structure
@@ -4509,6 +4588,8 @@ module Aws::RDS
4509
4588
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
4510
4589
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
4511
4590
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
4591
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
4592
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
4512
4593
  # resp.db_instance.preferred_maintenance_window #=> String
4513
4594
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
4514
4595
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -4611,6 +4692,7 @@ module Aws::RDS
4611
4692
  # resp.db_instance.resume_full_automation_mode_time #=> Time
4612
4693
  # resp.db_instance.custom_iam_instance_profile #=> String
4613
4694
  # resp.db_instance.backup_target #=> String
4695
+ # resp.db_instance.network_type #=> String
4614
4696
  #
4615
4697
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstance AWS API Documentation
4616
4698
  #
@@ -4627,8 +4709,8 @@ module Aws::RDS
4627
4709
  # information, see [Working with Read Replicas][1] in the *Amazon RDS
4628
4710
  # User Guide*.
4629
4711
  #
4630
- # Amazon Aurora doesn't support this action. Call the
4631
- # `CreateDBInstance` action to create a DB instance for an Aurora DB
4712
+ # Amazon Aurora doesn't support this operation. Call the
4713
+ # `CreateDBInstance` operation to create a DB instance for an Aurora DB
4632
4714
  # cluster.
4633
4715
  #
4634
4716
  # All read replica DB instances are created with backups disabled. All
@@ -4760,7 +4842,7 @@ module Aws::RDS
4760
4842
  # specified DB engine for a cross-Region read replica.
4761
4843
  #
4762
4844
  # Specifying a parameter group for this operation is only supported for
4763
- # Oracle DB instances. It isn't supported for RDS Custom.
4845
+ # MySQL and Oracle DB instances. It isn't supported for RDS Custom.
4764
4846
  #
4765
4847
  # Constraints:
4766
4848
  #
@@ -4899,9 +4981,16 @@ module Aws::RDS
4899
4981
  # as the primary replica.
4900
4982
  #
4901
4983
  # @option params [String] :pre_signed_url
4902
- # The URL that contains a Signature Version 4 signed request for the
4903
- # `CreateDBInstanceReadReplica` API action in the source Amazon Web
4904
- # Services Region that contains the source DB instance.
4984
+ # When you are creating a read replica from one Amazon Web Services
4985
+ # GovCloud (US) Region to another or from one China Amazon Web Services
4986
+ # Region to another, the URL that contains a Signature Version 4 signed
4987
+ # request for the `CreateDBInstanceReadReplica` API operation in the
4988
+ # source Amazon Web Services Region that contains the source DB
4989
+ # instance.
4990
+ #
4991
+ # This setting applies only to Amazon Web Services GovCloud (US) Regions
4992
+ # and China Amazon Web Services Regions. It's ignored in other Amazon
4993
+ # Web Services Regions.
4905
4994
  #
4906
4995
  # You must specify this parameter when you create an encrypted read
4907
4996
  # replica from another Amazon Web Services Region by using the Amazon
@@ -4909,32 +4998,31 @@ module Aws::RDS
4909
4998
  # encrypted read replica in the same Amazon Web Services Region.
4910
4999
  #
4911
5000
  # The presigned URL must be a valid request for the
4912
- # `CreateDBInstanceReadReplica` API action that can be executed in the
4913
- # source Amazon Web Services Region that contains the encrypted source
4914
- # DB instance. The presigned URL request must contain the following
5001
+ # `CreateDBInstanceReadReplica` API operation that can run in the source
5002
+ # Amazon Web Services Region that contains the encrypted source DB
5003
+ # instance. The presigned URL request must contain the following
4915
5004
  # parameter values:
4916
5005
  #
4917
5006
  # * `DestinationRegion` - The Amazon Web Services Region that the
4918
5007
  # encrypted read replica is created in. This Amazon Web Services
4919
5008
  # Region is the same one where the `CreateDBInstanceReadReplica`
4920
- # action is called that contains this presigned URL.
5009
+ # operation is called that contains this presigned URL.
4921
5010
  #
4922
5011
  # For example, if you create an encrypted DB instance in the us-west-1
4923
5012
  # Amazon Web Services Region, from a source DB instance in the
4924
5013
  # us-east-2 Amazon Web Services Region, then you call the
4925
- # `CreateDBInstanceReadReplica` action in the us-east-1 Amazon Web
5014
+ # `CreateDBInstanceReadReplica` operation in the us-east-1 Amazon Web
4926
5015
  # Services Region and provide a presigned URL that contains a call to
4927
- # the `CreateDBInstanceReadReplica` action in the us-west-2 Amazon Web
4928
- # Services Region. For this example, the `DestinationRegion` in the
4929
- # presigned URL must be set to the us-east-1 Amazon Web Services
5016
+ # the `CreateDBInstanceReadReplica` operation in the us-west-2 Amazon
5017
+ # Web Services Region. For this example, the `DestinationRegion` in
5018
+ # the presigned URL must be set to the us-east-1 Amazon Web Services
4930
5019
  # Region.
4931
5020
  #
4932
- # * `KmsKeyId` - The Amazon Web Services KMS key identifier for the key
4933
- # to use to encrypt the read replica in the destination Amazon Web
4934
- # Services Region. This is the same identifier for both the
4935
- # `CreateDBInstanceReadReplica` action that is called in the
4936
- # destination Amazon Web Services Region, and the action contained in
4937
- # the presigned URL.
5021
+ # * `KmsKeyId` - The KMS key identifier for the key to use to encrypt
5022
+ # the read replica in the destination Amazon Web Services Region. This
5023
+ # is the same identifier for both the `CreateDBInstanceReadReplica`
5024
+ # operation that is called in the destination Amazon Web Services
5025
+ # Region, and the operation contained in the presigned URL.
4938
5026
  #
4939
5027
  # * `SourceDBInstanceIdentifier` - The DB instance identifier for the
4940
5028
  # encrypted DB instance to be replicated. This identifier must be in
@@ -4953,11 +5041,10 @@ module Aws::RDS
4953
5041
  # specify `SourceRegion` (or `--source-region` for the CLI) instead of
4954
5042
  # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
4955
5043
  # autogenerates a presigned URL that is a valid request for the
4956
- # operation that can be executed in the source Amazon Web Services
4957
- # Region.
5044
+ # operation that can run in the source Amazon Web Services Region.
4958
5045
  #
4959
- # `SourceRegion` isn't supported for SQL Server, because SQL Server on
4960
- # Amazon RDS doesn't support cross-Region read replicas.
5046
+ # `SourceRegion` isn't supported for SQL Server, because Amazon RDS for
5047
+ # SQL Server doesn't support cross-Region read replicas.
4961
5048
  #
4962
5049
  # </note>
4963
5050
  #
@@ -5011,8 +5098,27 @@ module Aws::RDS
5011
5098
  # This setting doesn't apply to RDS Custom.
5012
5099
  #
5013
5100
  # @option params [Integer] :performance_insights_retention_period
5014
- # The amount of time, in days, to retain Performance Insights data.
5015
- # Valid values are 7 or 731 (2 years).
5101
+ # The number of days to retain Performance Insights data. The default is
5102
+ # 7 days. The following values are valid:
5103
+ #
5104
+ # * 7
5105
+ #
5106
+ # * *month* * 31, where *month* is a number of months from 1-23
5107
+ #
5108
+ # * 731
5109
+ #
5110
+ # For example, the following values are valid:
5111
+ #
5112
+ # * 93 (3 months * 31)
5113
+ #
5114
+ # * 341 (11 months * 31)
5115
+ #
5116
+ # * 589 (19 months * 31)
5117
+ #
5118
+ # * 731
5119
+ #
5120
+ # If you specify a retention period such as 94, which isn't a valid
5121
+ # value, RDS issues an error.
5016
5122
  #
5017
5123
  # This setting doesn't apply to RDS Custom.
5018
5124
  #
@@ -5131,6 +5237,26 @@ module Aws::RDS
5131
5237
  #
5132
5238
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/custom-setup-orcl.html#custom-setup-orcl.iam-vpc
5133
5239
  #
5240
+ # @option params [String] :network_type
5241
+ # The network type of the DB instance.
5242
+ #
5243
+ # Valid values:
5244
+ #
5245
+ # * `IPV4`
5246
+ #
5247
+ # * `DUAL`
5248
+ #
5249
+ # The network type is determined by the `DBSubnetGroup` specified for
5250
+ # read replica. A `DBSubnetGroup` can support only the IPv4 protocol or
5251
+ # the IPv4 and the IPv6 protocols (`DUAL`).
5252
+ #
5253
+ # For more information, see [ Working with a DB instance in a VPC][1] in
5254
+ # the *Amazon RDS User Guide.*
5255
+ #
5256
+ #
5257
+ #
5258
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html
5259
+ #
5134
5260
  # @option params [String] :source_region
5135
5261
  # The source region of the snapshot. This is only needed when the
5136
5262
  # shapshot is encrypted and in a different region.
@@ -5212,6 +5338,7 @@ module Aws::RDS
5212
5338
  # replica_mode: "open-read-only", # accepts open-read-only, mounted
5213
5339
  # max_allocated_storage: 1,
5214
5340
  # custom_iam_instance_profile: "String",
5341
+ # network_type: "String",
5215
5342
  # source_region: "String",
5216
5343
  # })
5217
5344
  #
@@ -5251,6 +5378,8 @@ module Aws::RDS
5251
5378
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
5252
5379
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
5253
5380
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
5381
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
5382
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
5254
5383
  # resp.db_instance.preferred_maintenance_window #=> String
5255
5384
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
5256
5385
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -5353,6 +5482,7 @@ module Aws::RDS
5353
5482
  # resp.db_instance.resume_full_automation_mode_time #=> Time
5354
5483
  # resp.db_instance.custom_iam_instance_profile #=> String
5355
5484
  # resp.db_instance.backup_target #=> String
5485
+ # resp.db_instance.network_type #=> String
5356
5486
  #
5357
5487
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBInstanceReadReplica AWS API Documentation
5358
5488
  #
@@ -5996,6 +6126,8 @@ module Aws::RDS
5996
6126
  # resp.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
5997
6127
  # resp.db_subnet_group.subnets[0].subnet_status #=> String
5998
6128
  # resp.db_subnet_group.db_subnet_group_arn #=> String
6129
+ # resp.db_subnet_group.supported_network_types #=> Array
6130
+ # resp.db_subnet_group.supported_network_types[0] #=> String
5999
6131
  #
6000
6132
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/CreateDBSubnetGroup AWS API Documentation
6001
6133
  #
@@ -6006,11 +6138,11 @@ module Aws::RDS
6006
6138
  req.send_request(options)
6007
6139
  end
6008
6140
 
6009
- # Creates an RDS event notification subscription. This action requires a
6010
- # topic Amazon Resource Name (ARN) created by either the RDS console,
6011
- # the SNS console, or the SNS API. To obtain an ARN with SNS, you must
6012
- # create a topic in Amazon SNS and subscribe to the topic. The ARN is
6013
- # displayed in the SNS console.
6141
+ # Creates an RDS event notification subscription. This operation
6142
+ # requires a topic Amazon Resource Name (ARN) created by either the RDS
6143
+ # console, the SNS console, or the SNS API. To obtain an ARN with SNS,
6144
+ # you must create a topic in Amazon SNS and subscribe to the topic. The
6145
+ # ARN is displayed in the SNS console.
6014
6146
  #
6015
6147
  # You can specify the type of source (`SourceType`) that you want to be
6016
6148
  # notified of and provide a list of RDS sources (`SourceIds`) that
@@ -6193,7 +6325,7 @@ module Aws::RDS
6193
6325
  # existing Aurora cluster during the create operation, and this cluster
6194
6326
  # becomes the primary cluster of the global database.
6195
6327
  #
6196
- # <note markdown="1"> This action only applies to Aurora DB clusters.
6328
+ # <note markdown="1"> This action applies only to Aurora DB clusters.
6197
6329
  #
6198
6330
  # </note>
6199
6331
  #
@@ -6215,9 +6347,9 @@ module Aws::RDS
6215
6347
  # global database can't be deleted when deletion protection is enabled.
6216
6348
  #
6217
6349
  # @option params [String] :database_name
6218
- # The name for your database of up to 64 alpha-numeric characters. If
6219
- # you do not provide a name, Amazon Aurora will not create a database in
6220
- # the global database cluster you are creating.
6350
+ # The name for your database of up to 64 alphanumeric characters. If you
6351
+ # do not provide a name, Amazon Aurora will not create a database in the
6352
+ # global database cluster you are creating.
6221
6353
  #
6222
6354
  # @option params [Boolean] :storage_encrypted
6223
6355
  # The storage encryption setting for the new global database cluster.
@@ -7085,6 +7217,8 @@ module Aws::RDS
7085
7217
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
7086
7218
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
7087
7219
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
7220
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
7221
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
7088
7222
  # resp.db_instance.preferred_maintenance_window #=> String
7089
7223
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
7090
7224
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -7187,6 +7321,7 @@ module Aws::RDS
7187
7321
  # resp.db_instance.resume_full_automation_mode_time #=> Time
7188
7322
  # resp.db_instance.custom_iam_instance_profile #=> String
7189
7323
  # resp.db_instance.backup_target #=> String
7324
+ # resp.db_instance.network_type #=> String
7190
7325
  #
7191
7326
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DeleteDBInstance AWS API Documentation
7192
7327
  #
@@ -9295,6 +9430,8 @@ module Aws::RDS
9295
9430
  # resp.db_instances[0].db_subnet_group.subnets[0].subnet_outpost.arn #=> String
9296
9431
  # resp.db_instances[0].db_subnet_group.subnets[0].subnet_status #=> String
9297
9432
  # resp.db_instances[0].db_subnet_group.db_subnet_group_arn #=> String
9433
+ # resp.db_instances[0].db_subnet_group.supported_network_types #=> Array
9434
+ # resp.db_instances[0].db_subnet_group.supported_network_types[0] #=> String
9298
9435
  # resp.db_instances[0].preferred_maintenance_window #=> String
9299
9436
  # resp.db_instances[0].pending_modified_values.db_instance_class #=> String
9300
9437
  # resp.db_instances[0].pending_modified_values.allocated_storage #=> Integer
@@ -9397,6 +9534,7 @@ module Aws::RDS
9397
9534
  # resp.db_instances[0].resume_full_automation_mode_time #=> Time
9398
9535
  # resp.db_instances[0].custom_iam_instance_profile #=> String
9399
9536
  # resp.db_instances[0].backup_target #=> String
9537
+ # resp.db_instances[0].network_type #=> String
9400
9538
  #
9401
9539
  #
9402
9540
  # The following waiters are defined for this operation (see {Client#wait_until} for detailed usage):
@@ -10454,6 +10592,8 @@ module Aws::RDS
10454
10592
  # resp.db_subnet_groups[0].subnets[0].subnet_outpost.arn #=> String
10455
10593
  # resp.db_subnet_groups[0].subnets[0].subnet_status #=> String
10456
10594
  # resp.db_subnet_groups[0].db_subnet_group_arn #=> String
10595
+ # resp.db_subnet_groups[0].supported_network_types #=> Array
10596
+ # resp.db_subnet_groups[0].supported_network_types[0] #=> String
10457
10597
  #
10458
10598
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeDBSubnetGroups AWS API Documentation
10459
10599
  #
@@ -10889,10 +11029,19 @@ module Aws::RDS
10889
11029
  # snapshot, DB cluster snapshot group, or RDS Proxy can be obtained by
10890
11030
  # providing the name as a parameter.
10891
11031
  #
11032
+ # For more information on working with events, see [Monitoring Amazon
11033
+ # RDS events][1] in the *Amazon RDS User Guide* and [Monitoring Amazon
11034
+ # Aurora events][2] in the *Amazon Aurora User Guide*.
11035
+ #
10892
11036
  # <note markdown="1"> By default, RDS returns events that were generated in the past hour.
10893
11037
  #
10894
11038
  # </note>
10895
11039
  #
11040
+ #
11041
+ #
11042
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/working-with-events.html
11043
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/working-with-events.html
11044
+ #
10896
11045
  # @option params [String] :source_identifier
10897
11046
  # The identifier of the event source for which events are returned. If
10898
11047
  # not specified, then all sources are included in the response.
@@ -11688,6 +11837,8 @@ module Aws::RDS
11688
11837
  # resp.orderable_db_instance_options[0].supported_activity_stream_modes[0] #=> String
11689
11838
  # resp.orderable_db_instance_options[0].supports_global_databases #=> Boolean
11690
11839
  # resp.orderable_db_instance_options[0].supports_clusters #=> Boolean
11840
+ # resp.orderable_db_instance_options[0].supported_network_types #=> Array
11841
+ # resp.orderable_db_instance_options[0].supported_network_types[0] #=> String
11691
11842
  # resp.marker #=> String
11692
11843
  #
11693
11844
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/DescribeOrderableDBInstanceOptions AWS API Documentation
@@ -12351,7 +12502,7 @@ module Aws::RDS
12351
12502
  #
12352
12503
  # An Amazon Aurora DB cluster automatically fails over to an Aurora
12353
12504
  # Replica, if one exists, when the primary DB instance fails. A Multi-AZ
12354
- # DB cluster automatically fails over to a readbable standby DB instance
12505
+ # DB cluster automatically fails over to a readable standby DB instance
12355
12506
  # when the primary DB instance fails.
12356
12507
  #
12357
12508
  # To simulate a failure of a primary instance for testing, you can force
@@ -13504,8 +13655,27 @@ module Aws::RDS
13504
13655
  # Valid for: Multi-AZ DB clusters only
13505
13656
  #
13506
13657
  # @option params [Integer] :performance_insights_retention_period
13507
- # The amount of time, in days, to retain Performance Insights data.
13508
- # Valid values are 7 or 731 (2 years).
13658
+ # The number of days to retain Performance Insights data. The default is
13659
+ # 7 days. The following values are valid:
13660
+ #
13661
+ # * 7
13662
+ #
13663
+ # * *month* * 31, where *month* is a number of months from 1-23
13664
+ #
13665
+ # * 731
13666
+ #
13667
+ # For example, the following values are valid:
13668
+ #
13669
+ # * 93 (3 months * 31)
13670
+ #
13671
+ # * 341 (11 months * 31)
13672
+ #
13673
+ # * 589 (19 months * 31)
13674
+ #
13675
+ # * 731
13676
+ #
13677
+ # If you specify a retention period such as 94, which isn't a valid
13678
+ # value, RDS issues an error.
13509
13679
  #
13510
13680
  # Valid for: Multi-AZ DB clusters only
13511
13681
  #
@@ -13793,7 +13963,7 @@ module Aws::RDS
13793
13963
  # database for a DB cluster, such as the character set for the default
13794
13964
  # database defined by the `character_set_database` parameter. You can
13795
13965
  # use the *Parameter Groups* option of the [Amazon RDS console][1] or
13796
- # the `DescribeDBClusterParameters` action to verify that your DB
13966
+ # the `DescribeDBClusterParameters` operation to verify that your DB
13797
13967
  # cluster parameter group has been created or modified.
13798
13968
  #
13799
13969
  # If the modified DB cluster parameter group is used by an Aurora
@@ -13920,7 +14090,7 @@ module Aws::RDS
13920
14090
  # To view which Amazon Web Services accounts have access to copy or
13921
14091
  # restore a manual DB cluster snapshot, or whether a manual DB cluster
13922
14092
  # snapshot is public or private, use the
13923
- # DescribeDBClusterSnapshotAttributes API action. The accounts are
14093
+ # DescribeDBClusterSnapshotAttributes API operation. The accounts are
13924
14094
  # returned as values for the `restore` attribute.
13925
14095
  #
13926
14096
  # @option params [required, String] :db_cluster_snapshot_identifier
@@ -13934,7 +14104,7 @@ module Aws::RDS
13934
14104
  # or restore a manual DB cluster snapshot, set this value to `restore`.
13935
14105
  #
13936
14106
  # <note markdown="1"> To view the list of attributes available to modify, use the
13937
- # DescribeDBClusterSnapshotAttributes API action.
14107
+ # DescribeDBClusterSnapshotAttributes API operation.
13938
14108
  #
13939
14109
  # </note>
13940
14110
  #
@@ -14046,10 +14216,11 @@ module Aws::RDS
14046
14216
  #
14047
14217
  # @option params [String] :db_instance_class
14048
14218
  # The new compute and memory capacity of the DB instance, for example
14049
- # db.m4.large. Not all DB instance classes are available in all Amazon
14219
+ # db.m5.large. Not all DB instance classes are available in all Amazon
14050
14220
  # Web Services Regions, or for all database engines. For the full list
14051
14221
  # of DB instance classes, and availability for your engine, see [DB
14052
- # Instance Class][1] in the *Amazon RDS User Guide*.
14222
+ # instance classes][1] in the *Amazon RDS User Guide* or [Aurora DB
14223
+ # instance classes][2] in the *Amazon Aurora User Guide*.
14053
14224
  #
14054
14225
  # If you modify the DB instance class, an outage occurs during the
14055
14226
  # change. The change is applied during the next maintenance window,
@@ -14062,6 +14233,7 @@ module Aws::RDS
14062
14233
  #
14063
14234
  #
14064
14235
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html
14236
+ # [2]: https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.DBInstanceClass.html
14065
14237
  #
14066
14238
  # @option params [String] :db_subnet_group_name
14067
14239
  # The new DB subnet group for the DB instance. You can use this
@@ -14173,7 +14345,7 @@ module Aws::RDS
14173
14345
  #
14174
14346
  # Constraints: Must contain from 8 to 128 characters.
14175
14347
  #
14176
- # <note markdown="1"> Amazon RDS API actions never return the password, so this action
14348
+ # <note markdown="1"> Amazon RDS API operations never return the password, so this action
14177
14349
  # provides a way to regain access to a primary instance user if the
14178
14350
  # password is lost. This includes restoring privileges that might have
14179
14351
  # been accidentally revoked.
@@ -14225,8 +14397,8 @@ module Aws::RDS
14225
14397
  # Constraints:
14226
14398
  #
14227
14399
  # * It must be a value from 0 to 35. It can't be set to 0 if the DB
14228
- # instance is a source to read replicas. It can't be set to 0 or 35
14229
- # for an RDS Custom for Oracle DB instance.
14400
+ # instance is a source to read replicas. It can't be set to 0 for an
14401
+ # RDS Custom for Oracle DB instance.
14230
14402
  #
14231
14403
  # * It can be specified for a MySQL read replica only if the source is
14232
14404
  # running MySQL 5.6 or later.
@@ -14638,7 +14810,7 @@ module Aws::RDS
14638
14810
  # DB instance.
14639
14811
  #
14640
14812
  # For more information, see [Using Amazon Performance Insights][1] in
14641
- # the *Amazon RDS User Guide.*.
14813
+ # the *Amazon RDS User Guide*.
14642
14814
  #
14643
14815
  # This setting doesn't apply to RDS Custom.
14644
14816
  #
@@ -14661,8 +14833,27 @@ module Aws::RDS
14661
14833
  # This setting doesn't apply to RDS Custom.
14662
14834
  #
14663
14835
  # @option params [Integer] :performance_insights_retention_period
14664
- # The amount of time, in days, to retain Performance Insights data.
14665
- # Valid values are 7 or 731 (2 years).
14836
+ # The number of days to retain Performance Insights data. The default is
14837
+ # 7 days. The following values are valid:
14838
+ #
14839
+ # * 7
14840
+ #
14841
+ # * *month* * 31, where *month* is a number of months from 1-23
14842
+ #
14843
+ # * 731
14844
+ #
14845
+ # For example, the following values are valid:
14846
+ #
14847
+ # * 93 (3 months * 31)
14848
+ #
14849
+ # * 341 (11 months * 31)
14850
+ #
14851
+ # * 589 (19 months * 31)
14852
+ #
14853
+ # * 731
14854
+ #
14855
+ # If you specify a retention period such as 94, which isn't a valid
14856
+ # value, RDS issues an error.
14666
14857
  #
14667
14858
  # This setting doesn't apply to RDS Custom.
14668
14859
  #
@@ -14802,6 +14993,26 @@ module Aws::RDS
14802
14993
  # ends, RDS Custom resumes full automation. The minimum value is `60`
14803
14994
  # (default). The maximum value is `1,440`.
14804
14995
  #
14996
+ # @option params [String] :network_type
14997
+ # The network type of the DB instance.
14998
+ #
14999
+ # Valid values:
15000
+ #
15001
+ # * `IPV4`
15002
+ #
15003
+ # * `DUAL`
15004
+ #
15005
+ # The network type is determined by the `DBSubnetGroup` specified for
15006
+ # the DB instance. A `DBSubnetGroup` can support only the IPv4 protocol
15007
+ # or the IPv4 and the IPv6 protocols (`DUAL`).
15008
+ #
15009
+ # For more information, see [ Working with a DB instance in a VPC][1] in
15010
+ # the *Amazon RDS User Guide.*
15011
+ #
15012
+ #
15013
+ #
15014
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html
15015
+ #
14805
15016
  # @return [Types::ModifyDBInstanceResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
14806
15017
  #
14807
15018
  # * {Types::ModifyDBInstanceResult#db_instance #db_instance} => Types::DBInstance
@@ -14886,6 +15097,7 @@ module Aws::RDS
14886
15097
  # aws_backup_recovery_point_arn: "AwsBackupRecoveryPointArn",
14887
15098
  # automation_mode: "full", # accepts full, all-paused
14888
15099
  # resume_full_automation_mode_minutes: 1,
15100
+ # network_type: "String",
14889
15101
  # })
14890
15102
  #
14891
15103
  # @example Response structure
@@ -14924,6 +15136,8 @@ module Aws::RDS
14924
15136
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
14925
15137
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
14926
15138
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
15139
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
15140
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
14927
15141
  # resp.db_instance.preferred_maintenance_window #=> String
14928
15142
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
14929
15143
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -15026,6 +15240,7 @@ module Aws::RDS
15026
15240
  # resp.db_instance.resume_full_automation_mode_time #=> Time
15027
15241
  # resp.db_instance.custom_iam_instance_profile #=> String
15028
15242
  # resp.db_instance.backup_target #=> String
15243
+ # resp.db_instance.network_type #=> String
15029
15244
  #
15030
15245
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBInstance AWS API Documentation
15031
15246
  #
@@ -15314,10 +15529,10 @@ module Aws::RDS
15314
15529
  # Modifies the properties of a `DBProxyTargetGroup`.
15315
15530
  #
15316
15531
  # @option params [required, String] :target_group_name
15317
- # The name of the new target group to assign to the proxy.
15532
+ # The name of the target group to modify.
15318
15533
  #
15319
15534
  # @option params [required, String] :db_proxy_name
15320
- # The name of the new proxy to which to assign the target group.
15535
+ # The name of the proxy.
15321
15536
  #
15322
15537
  # @option params [Types::ConnectionPoolConfiguration] :connection_pool_config
15323
15538
  # The settings that determine the size and behavior of the connection
@@ -15505,7 +15720,7 @@ module Aws::RDS
15505
15720
  #
15506
15721
  # To view which Amazon Web Services accounts have access to copy or
15507
15722
  # restore a manual DB snapshot, or whether a manual DB snapshot public
15508
- # or private, use the DescribeDBSnapshotAttributes API action. The
15723
+ # or private, use the DescribeDBSnapshotAttributes API operation. The
15509
15724
  # accounts are returned as values for the `restore` attribute.
15510
15725
  #
15511
15726
  # @option params [required, String] :db_snapshot_identifier
@@ -15518,7 +15733,7 @@ module Aws::RDS
15518
15733
  # or restore a manual DB snapshot, set this value to `restore`.
15519
15734
  #
15520
15735
  # <note markdown="1"> To view the list of attributes available to modify, use the
15521
- # DescribeDBSnapshotAttributes API action.
15736
+ # DescribeDBSnapshotAttributes API operation.
15522
15737
  #
15523
15738
  # </note>
15524
15739
  #
@@ -15656,6 +15871,8 @@ module Aws::RDS
15656
15871
  # resp.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
15657
15872
  # resp.db_subnet_group.subnets[0].subnet_status #=> String
15658
15873
  # resp.db_subnet_group.db_subnet_group_arn #=> String
15874
+ # resp.db_subnet_group.supported_network_types #=> Array
15875
+ # resp.db_subnet_group.supported_network_types[0] #=> String
15659
15876
  #
15660
15877
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/ModifyDBSubnetGroup AWS API Documentation
15661
15878
  #
@@ -16148,6 +16365,8 @@ module Aws::RDS
16148
16365
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
16149
16366
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
16150
16367
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
16368
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
16369
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
16151
16370
  # resp.db_instance.preferred_maintenance_window #=> String
16152
16371
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
16153
16372
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -16250,6 +16469,7 @@ module Aws::RDS
16250
16469
  # resp.db_instance.resume_full_automation_mode_time #=> Time
16251
16470
  # resp.db_instance.custom_iam_instance_profile #=> String
16252
16471
  # resp.db_instance.backup_target #=> String
16472
+ # resp.db_instance.network_type #=> String
16253
16473
  #
16254
16474
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/PromoteReadReplica AWS API Documentation
16255
16475
  #
@@ -16738,6 +16958,8 @@ module Aws::RDS
16738
16958
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
16739
16959
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
16740
16960
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
16961
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
16962
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
16741
16963
  # resp.db_instance.preferred_maintenance_window #=> String
16742
16964
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
16743
16965
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -16840,6 +17062,7 @@ module Aws::RDS
16840
17062
  # resp.db_instance.resume_full_automation_mode_time #=> Time
16841
17063
  # resp.db_instance.custom_iam_instance_profile #=> String
16842
17064
  # resp.db_instance.backup_target #=> String
17065
+ # resp.db_instance.network_type #=> String
16843
17066
  #
16844
17067
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RebootDBInstance AWS API Documentation
16845
17068
  #
@@ -17443,9 +17666,9 @@ module Aws::RDS
17443
17666
  # @option params [required, String] :engine
17444
17667
  # The name of the database engine to be used for this DB cluster.
17445
17668
  #
17446
- # Valid Values: `aurora` (for MySQL 5.6-compatible Aurora),
17669
+ # Valid Values: `aurora` (for MySQL 5.6-compatible Aurora) and
17447
17670
  # `aurora-mysql` (for MySQL 5.7-compatible and MySQL 8.0-compatible
17448
- # Aurora), and `aurora-postgresql`
17671
+ # Aurora)
17449
17672
  #
17450
17673
  # @option params [String] :engine_version
17451
17674
  # The version number of the database engine to use.
@@ -17463,20 +17686,10 @@ module Aws::RDS
17463
17686
  # `aws rds describe-db-engine-versions --engine aurora-mysql --query
17464
17687
  # "DBEngineVersions[].EngineVersion"`
17465
17688
  #
17466
- # To list all of the available engine versions for `aurora-postgresql`,
17467
- # use the following command:
17468
- #
17469
- # `aws rds describe-db-engine-versions --engine aurora-postgresql
17470
- # --query "DBEngineVersions[].EngineVersion"`
17471
- #
17472
17689
  # **Aurora MySQL**
17473
17690
  #
17474
- # Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`, `5.7.12`,
17475
- # `5.7.mysql_aurora.2.04.5`, `8.0.mysql_aurora.3.01.0`
17476
- #
17477
- # **Aurora PostgreSQL**
17478
- #
17479
- # Example: `9.6.3`, `10.7`
17691
+ # Example: `5.6.10a`, `5.6.mysql_aurora.1.19.2`,
17692
+ # `5.7.mysql_aurora.2.07.1`, `8.0.mysql_aurora.3.02.0`
17480
17693
  #
17481
17694
  # @option params [Integer] :port
17482
17695
  # The port number on which the instances in the restored DB cluster
@@ -18110,7 +18323,7 @@ module Aws::RDS
18110
18323
  #
18111
18324
  # For more information about exporting CloudWatch Logs for Amazon RDS,
18112
18325
  # see [Publishing Database Logs to Amazon CloudWatch Logs][1] in the
18113
- # *Amazon RDS User Guide.*.
18326
+ # *Amazon RDS User Guide*.
18114
18327
  #
18115
18328
  # For more information about exporting CloudWatch Logs for Amazon
18116
18329
  # Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs][2] in
@@ -18692,7 +18905,7 @@ module Aws::RDS
18692
18905
  #
18693
18906
  # For more information about exporting CloudWatch Logs for Amazon RDS,
18694
18907
  # see [Publishing Database Logs to Amazon CloudWatch Logs][1] in the
18695
- # *Amazon RDS User Guide.*.
18908
+ # *Amazon RDS User Guide*.
18696
18909
  #
18697
18910
  # For more information about exporting CloudWatch Logs for Amazon
18698
18911
  # Aurora, see [Publishing Database Logs to Amazon CloudWatch Logs][2] in
@@ -19451,6 +19664,26 @@ module Aws::RDS
19451
19664
  #
19452
19665
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
19453
19666
  #
19667
+ # @option params [String] :network_type
19668
+ # The network type of the DB instance.
19669
+ #
19670
+ # Valid values:
19671
+ #
19672
+ # * `IPV4`
19673
+ #
19674
+ # * `DUAL`
19675
+ #
19676
+ # The network type is determined by the `DBSubnetGroup` specified for
19677
+ # the DB instance. A `DBSubnetGroup` can support only the IPv4 protocol
19678
+ # or the IPv4 and the IPv6 protocols (`DUAL`).
19679
+ #
19680
+ # For more information, see [ Working with a DB instance in a VPC][1] in
19681
+ # the *Amazon RDS User Guide.*
19682
+ #
19683
+ #
19684
+ #
19685
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html
19686
+ #
19454
19687
  # @return [Types::RestoreDBInstanceFromDBSnapshotResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
19455
19688
  #
19456
19689
  # * {Types::RestoreDBInstanceFromDBSnapshotResult#db_instance #db_instance} => Types::DBInstance
@@ -19594,6 +19827,7 @@ module Aws::RDS
19594
19827
  # enable_customer_owned_ip: false,
19595
19828
  # custom_iam_instance_profile: "String",
19596
19829
  # backup_target: "String",
19830
+ # network_type: "String",
19597
19831
  # })
19598
19832
  #
19599
19833
  # @example Response structure
@@ -19632,6 +19866,8 @@ module Aws::RDS
19632
19866
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
19633
19867
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
19634
19868
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
19869
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
19870
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
19635
19871
  # resp.db_instance.preferred_maintenance_window #=> String
19636
19872
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
19637
19873
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -19734,6 +19970,7 @@ module Aws::RDS
19734
19970
  # resp.db_instance.resume_full_automation_mode_time #=> Time
19735
19971
  # resp.db_instance.custom_iam_instance_profile #=> String
19736
19972
  # resp.db_instance.backup_target #=> String
19973
+ # resp.db_instance.network_type #=> String
19737
19974
  #
19738
19975
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromDBSnapshot AWS API Documentation
19739
19976
  #
@@ -20075,7 +20312,7 @@ module Aws::RDS
20075
20312
  # DB instance.
20076
20313
  #
20077
20314
  # For more information, see [Using Amazon Performance Insights][1] in
20078
- # the *Amazon RDS User Guide.*.
20315
+ # the *Amazon RDS User Guide*.
20079
20316
  #
20080
20317
  #
20081
20318
  #
@@ -20094,8 +20331,27 @@ module Aws::RDS
20094
20331
  # a different default KMS key for each Amazon Web Services Region.
20095
20332
  #
20096
20333
  # @option params [Integer] :performance_insights_retention_period
20097
- # The amount of time, in days, to retain Performance Insights data.
20098
- # Valid values are 7 or 731 (2 years).
20334
+ # The number of days to retain Performance Insights data. The default is
20335
+ # 7 days. The following values are valid:
20336
+ #
20337
+ # * 7
20338
+ #
20339
+ # * *month* * 31, where *month* is a number of months from 1-23
20340
+ #
20341
+ # * 731
20342
+ #
20343
+ # For example, the following values are valid:
20344
+ #
20345
+ # * 93 (3 months * 31)
20346
+ #
20347
+ # * 341 (11 months * 31)
20348
+ #
20349
+ # * 589 (19 months * 31)
20350
+ #
20351
+ # * 731
20352
+ #
20353
+ # If you specify a retention period such as 94, which isn't a valid
20354
+ # value, RDS issues an error.
20099
20355
  #
20100
20356
  # @option params [Array<String>] :enable_cloudwatch_logs_exports
20101
20357
  # The list of logs that the restored DB instance is to export to
@@ -20137,6 +20393,26 @@ module Aws::RDS
20137
20393
  #
20138
20394
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_PIOPS.StorageTypes.html#USER_PIOPS.Autoscaling
20139
20395
  #
20396
+ # @option params [String] :network_type
20397
+ # The network type of the DB instance.
20398
+ #
20399
+ # Valid values:
20400
+ #
20401
+ # * `IPV4`
20402
+ #
20403
+ # * `DUAL`
20404
+ #
20405
+ # The network type is determined by the `DBSubnetGroup` specified for
20406
+ # the DB instance. A `DBSubnetGroup` can support only the IPv4 protocol
20407
+ # or the IPv4 and the IPv6 protocols (`DUAL`).
20408
+ #
20409
+ # For more information, see [ Working with a DB instance in a VPC][1] in
20410
+ # the *Amazon RDS User Guide.*
20411
+ #
20412
+ #
20413
+ #
20414
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html
20415
+ #
20140
20416
  # @return [Types::RestoreDBInstanceFromS3Result] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
20141
20417
  #
20142
20418
  # * {Types::RestoreDBInstanceFromS3Result#db_instance #db_instance} => Types::DBInstance
@@ -20198,6 +20474,7 @@ module Aws::RDS
20198
20474
  # use_default_processor_features: false,
20199
20475
  # deletion_protection: false,
20200
20476
  # max_allocated_storage: 1,
20477
+ # network_type: "String",
20201
20478
  # })
20202
20479
  #
20203
20480
  # @example Response structure
@@ -20236,6 +20513,8 @@ module Aws::RDS
20236
20513
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
20237
20514
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
20238
20515
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
20516
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
20517
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
20239
20518
  # resp.db_instance.preferred_maintenance_window #=> String
20240
20519
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
20241
20520
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -20338,6 +20617,7 @@ module Aws::RDS
20338
20617
  # resp.db_instance.resume_full_automation_mode_time #=> Time
20339
20618
  # resp.db_instance.custom_iam_instance_profile #=> String
20340
20619
  # resp.db_instance.backup_target #=> String
20620
+ # resp.db_instance.network_type #=> String
20341
20621
  #
20342
20622
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceFromS3 AWS API Documentation
20343
20623
  #
@@ -20763,6 +21043,26 @@ module Aws::RDS
20763
21043
  #
20764
21044
  # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-on-outposts.html
20765
21045
  #
21046
+ # @option params [String] :network_type
21047
+ # The network type of the DB instance.
21048
+ #
21049
+ # Valid values:
21050
+ #
21051
+ # * `IPV4`
21052
+ #
21053
+ # * `DUAL`
21054
+ #
21055
+ # The network type is determined by the `DBSubnetGroup` specified for
21056
+ # the DB instance. A `DBSubnetGroup` can support only the IPv4 protocol
21057
+ # or the IPv4 and the IPv6 protocols (`DUAL`).
21058
+ #
21059
+ # For more information, see [ Working with a DB instance in a VPC][1] in
21060
+ # the *Amazon RDS User Guide.*
21061
+ #
21062
+ #
21063
+ #
21064
+ # [1]: https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_VPC.WorkingWithRDSInstanceinaVPC.html
21065
+ #
20766
21066
  # @return [Types::RestoreDBInstanceToPointInTimeResult] Returns a {Seahorse::Client::Response response} object which responds to the following methods:
20767
21067
  #
20768
21068
  # * {Types::RestoreDBInstanceToPointInTimeResult#db_instance #db_instance} => Types::DBInstance
@@ -20912,6 +21212,7 @@ module Aws::RDS
20912
21212
  # enable_customer_owned_ip: false,
20913
21213
  # custom_iam_instance_profile: "String",
20914
21214
  # backup_target: "String",
21215
+ # network_type: "String",
20915
21216
  # })
20916
21217
  #
20917
21218
  # @example Response structure
@@ -20950,6 +21251,8 @@ module Aws::RDS
20950
21251
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
20951
21252
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
20952
21253
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
21254
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
21255
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
20953
21256
  # resp.db_instance.preferred_maintenance_window #=> String
20954
21257
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
20955
21258
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -21052,6 +21355,7 @@ module Aws::RDS
21052
21355
  # resp.db_instance.resume_full_automation_mode_time #=> Time
21053
21356
  # resp.db_instance.custom_iam_instance_profile #=> String
21054
21357
  # resp.db_instance.backup_target #=> String
21358
+ # resp.db_instance.network_type #=> String
21055
21359
  #
21056
21360
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/RestoreDBInstanceToPointInTime AWS API Documentation
21057
21361
  #
@@ -21430,6 +21734,8 @@ module Aws::RDS
21430
21734
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
21431
21735
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
21432
21736
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
21737
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
21738
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
21433
21739
  # resp.db_instance.preferred_maintenance_window #=> String
21434
21740
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
21435
21741
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -21532,6 +21838,7 @@ module Aws::RDS
21532
21838
  # resp.db_instance.resume_full_automation_mode_time #=> Time
21533
21839
  # resp.db_instance.custom_iam_instance_profile #=> String
21534
21840
  # resp.db_instance.backup_target #=> String
21841
+ # resp.db_instance.network_type #=> String
21535
21842
  #
21536
21843
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StartDBInstance AWS API Documentation
21537
21844
  #
@@ -21570,14 +21877,36 @@ module Aws::RDS
21570
21877
  # `arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE`.
21571
21878
  #
21572
21879
  # @option params [String] :pre_signed_url
21573
- # A URL that contains a Signature Version 4 signed request for the
21574
- # StartDBInstanceAutomatedBackupsReplication action to be called in the
21880
+ # In an Amazon Web Services GovCloud (US) Region, an URL that contains a
21881
+ # Signature Version 4 signed request for the
21882
+ # `StartDBInstanceAutomatedBackupsReplication` operation to call in the
21575
21883
  # Amazon Web Services Region of the source DB instance. The presigned
21576
21884
  # URL must be a valid request for the
21577
- # StartDBInstanceAutomatedBackupsReplication API action that can be
21578
- # executed in the Amazon Web Services Region that contains the source DB
21885
+ # `StartDBInstanceAutomatedBackupsReplication` API operation that can
21886
+ # run in the Amazon Web Services Region that contains the source DB
21579
21887
  # instance.
21580
21888
  #
21889
+ # This setting applies only to Amazon Web Services GovCloud (US)
21890
+ # Regions. It's ignored in other Amazon Web Services Regions.
21891
+ #
21892
+ # To learn how to generate a Signature Version 4 signed request, see [
21893
+ # Authenticating Requests: Using Query Parameters (Amazon Web Services
21894
+ # Signature Version 4)][1] and [ Signature Version 4 Signing
21895
+ # Process][2].
21896
+ #
21897
+ # <note markdown="1"> If you are using an Amazon Web Services SDK tool or the CLI, you can
21898
+ # specify `SourceRegion` (or `--source-region` for the CLI) instead of
21899
+ # specifying `PreSignedUrl` manually. Specifying `SourceRegion`
21900
+ # autogenerates a presigned URL that is a valid request for the
21901
+ # operation that can run in the source Amazon Web Services Region.
21902
+ #
21903
+ # </note>
21904
+ #
21905
+ #
21906
+ #
21907
+ # [1]: https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html
21908
+ # [2]: https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html
21909
+ #
21581
21910
  # @option params [String] :source_region
21582
21911
  # The source region of the snapshot. This is only needed when the
21583
21912
  # shapshot is encrypted and in a different region.
@@ -22029,6 +22358,8 @@ module Aws::RDS
22029
22358
  # resp.db_instance.db_subnet_group.subnets[0].subnet_outpost.arn #=> String
22030
22359
  # resp.db_instance.db_subnet_group.subnets[0].subnet_status #=> String
22031
22360
  # resp.db_instance.db_subnet_group.db_subnet_group_arn #=> String
22361
+ # resp.db_instance.db_subnet_group.supported_network_types #=> Array
22362
+ # resp.db_instance.db_subnet_group.supported_network_types[0] #=> String
22032
22363
  # resp.db_instance.preferred_maintenance_window #=> String
22033
22364
  # resp.db_instance.pending_modified_values.db_instance_class #=> String
22034
22365
  # resp.db_instance.pending_modified_values.allocated_storage #=> Integer
@@ -22131,6 +22462,7 @@ module Aws::RDS
22131
22462
  # resp.db_instance.resume_full_automation_mode_time #=> Time
22132
22463
  # resp.db_instance.custom_iam_instance_profile #=> String
22133
22464
  # resp.db_instance.backup_target #=> String
22465
+ # resp.db_instance.network_type #=> String
22134
22466
  #
22135
22467
  # @see http://docs.aws.amazon.com/goto/WebAPI/rds-2014-10-31/StopDBInstance AWS API Documentation
22136
22468
  #
@@ -22143,7 +22475,8 @@ module Aws::RDS
22143
22475
 
22144
22476
  # Stops automated backup replication for a DB instance.
22145
22477
  #
22146
- # This command doesn't apply to RDS Custom.
22478
+ # This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora
22479
+ # PostgreSQL.
22147
22480
  #
22148
22481
  # For more information, see [ Replicating Automated Backups to Another
22149
22482
  # Amazon Web Services Region][1] in the *Amazon RDS User Guide.*
@@ -22221,7 +22554,7 @@ module Aws::RDS
22221
22554
  params: params,
22222
22555
  config: config)
22223
22556
  context[:gem_name] = 'aws-sdk-rds'
22224
- context[:gem_version] = '1.144.0'
22557
+ context[:gem_version] = '1.147.0'
22225
22558
  Seahorse::Client::Request.new(handlers, context)
22226
22559
  end
22227
22560