aws-sdk-rds 1.144.0 → 1.147.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -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