@aws-sdk/client-rds 3.131.0 → 3.135.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.
@@ -1272,22 +1272,33 @@ export interface CopyDBClusterSnapshotMessage {
1272
1272
  */
1273
1273
  KmsKeyId?: string;
1274
1274
  /**
1275
- * <p>The URL that contains a Signature Version 4 signed request for the <code>CopyDBClusterSnapshot</code> API action in the Amazon Web Services Region that contains the
1276
- * source DB cluster snapshot to copy. The <code>PreSignedUrl</code> parameter must be used when copying an encrypted DB cluster snapshot from another Amazon Web Services Region.
1277
- * Don't specify <code>PreSignedUrl</code> when you are copying an encrypted DB cluster snapshot in the same Amazon Web Services Region.</p>
1278
- * <p>The pre-signed URL must be a valid request for the <code>CopyDBClusterSnapshot</code> API action that can be
1279
- * executed in the source Amazon Web Services Region that contains the encrypted DB cluster snapshot to be copied.
1280
- * The pre-signed URL request must contain the following parameter values:</p>
1275
+ * <p>When you are copying a DB cluster snapshot from one Amazon Web Services GovCloud (US) Region
1276
+ * to another, the URL that contains a Signature Version 4 signed request for the
1277
+ * <code>CopyDBClusterSnapshot</code> API operation in the Amazon Web Services Region that contains
1278
+ * the source DB cluster snapshot to copy. Use the <code>PreSignedUrl</code> parameter when
1279
+ * copying an encrypted DB cluster snapshot from another Amazon Web Services Region. Don't specify
1280
+ * <code>PreSignedUrl</code> when copying an encrypted DB cluster snapshot in the same
1281
+ * Amazon Web Services Region.</p>
1282
+ * <p>This setting applies only to Amazon Web Services GovCloud (US) Regions. It's ignored in other
1283
+ * Amazon Web Services Regions.</p>
1284
+ * <p>The presigned URL must be a valid request for the
1285
+ * <code>CopyDBClusterSnapshot</code> API operation that can run in the source
1286
+ * Amazon Web Services Region that contains the encrypted DB cluster snapshot to copy. The presigned URL request
1287
+ * must contain the following parameter values:</p>
1281
1288
  * <ul>
1282
1289
  * <li>
1283
1290
  * <p>
1284
- * <code>KmsKeyId</code> - The Amazon Web Services KMS key identifier for the KMS key to use to encrypt the copy of the DB
1285
- * cluster snapshot in the destination Amazon Web Services Region. This is the same identifier for both the <code>CopyDBClusterSnapshot</code>
1286
- * action that is called in the destination Amazon Web Services Region, and the action contained in the pre-signed URL.</p>
1291
+ * <code>KmsKeyId</code> - The KMS key identifier for the KMS key
1292
+ * to use to encrypt the copy of the DB cluster snapshot in the destination
1293
+ * Amazon Web Services Region. This is the same identifier for both the
1294
+ * <code>CopyDBClusterSnapshot</code> operation that is called in the
1295
+ * destination Amazon Web Services Region, and the operation contained in the presigned
1296
+ * URL.</p>
1287
1297
  * </li>
1288
1298
  * <li>
1289
1299
  * <p>
1290
- * <code>DestinationRegion</code> - The name of the Amazon Web Services Region that the DB cluster snapshot is to be created in.</p>
1300
+ * <code>DestinationRegion</code> - The name of the Amazon Web Services Region
1301
+ * that the DB cluster snapshot is to be created in.</p>
1291
1302
  * </li>
1292
1303
  * <li>
1293
1304
  * <p>
@@ -1298,15 +1309,16 @@ export interface CopyDBClusterSnapshotMessage {
1298
1309
  * </li>
1299
1310
  * </ul>
1300
1311
  * <p>To learn how to generate a Signature Version 4 signed request, see
1301
- *
1302
1312
  * <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html">
1303
1313
  * Authenticating Requests: Using Query Parameters (Amazon Web Services Signature Version 4)</a> and
1304
1314
  * <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">
1305
1315
  * Signature Version 4 Signing Process</a>.</p>
1306
1316
  * <note>
1307
- * <p>If you are using an Amazon Web Services SDK tool or the CLI, you can specify <code>SourceRegion</code> (or <code>--source-region</code> for the CLI)
1308
- * instead of specifying <code>PreSignedUrl</code> manually. Specifying <code>SourceRegion</code> autogenerates a pre-signed URL that is a valid
1309
- * request for the operation that can be executed in the source Amazon Web Services Region.</p>
1317
+ * <p>If you are using an Amazon Web Services SDK tool or the CLI, you can specify
1318
+ * <code>SourceRegion</code> (or <code>--source-region</code> for the CLI)
1319
+ * instead of specifying <code>PreSignedUrl</code> manually. Specifying
1320
+ * <code>SourceRegion</code> autogenerates a presigned URL that is a valid request
1321
+ * for the operation that can run in the source Amazon Web Services Region.</p>
1310
1322
  * </note>
1311
1323
  */
1312
1324
  PreSignedUrl?: string;
@@ -1632,9 +1644,7 @@ export interface CopyDBSnapshotMessage {
1632
1644
  * <code>arn:aws:rds:us-west-2:123456789012:snapshot:mysql-instance1-snapshot-20130805</code>.</p>
1633
1645
  * <p>If you are copying from a shared manual DB snapshot,
1634
1646
  * this parameter must be the Amazon Resource Name (ARN) of the shared DB snapshot.</p>
1635
- * <p>If you are copying an encrypted snapshot
1636
- * this parameter must be in the ARN format for the source Amazon Web Services Region,
1637
- * and must match the <code>SourceDBSnapshotIdentifier</code> in the <code>PreSignedUrl</code> parameter.</p>
1647
+ * <p>If you are copying an encrypted snapshot this parameter must be in the ARN format for the source Amazon Web Services Region.</p>
1638
1648
  * <p>Constraints:</p>
1639
1649
  * <ul>
1640
1650
  * <li>
@@ -1696,32 +1706,40 @@ export interface CopyDBSnapshotMessage {
1696
1706
  */
1697
1707
  CopyTags?: boolean;
1698
1708
  /**
1699
- * <p>The URL that contains a Signature Version 4 signed request for the
1700
- * <code>CopyDBSnapshot</code> API action in the source Amazon Web Services Region that contains the
1701
- * source DB snapshot to copy.</p>
1709
+ * <p>When you are copying a snapshot from one Amazon Web Services GovCloud (US) Region to another,
1710
+ * the URL that contains a Signature Version 4 signed request for the <code>CopyDBSnapshot</code> API
1711
+ * operation in the source Amazon Web Services Region that contains the source DB snapshot to copy.</p>
1712
+ * <p>This setting applies only to Amazon Web Services GovCloud (US) Regions. It's ignored in other
1713
+ * Amazon Web Services Regions.</p>
1702
1714
  * <p>You must specify this parameter when you copy an encrypted DB snapshot from another
1703
1715
  * Amazon Web Services Region by using the Amazon RDS API. Don't specify <code>PreSignedUrl</code> when you are
1704
1716
  * copying an encrypted DB snapshot in the same Amazon Web Services Region.</p>
1705
- * <p>The presigned URL must be a valid request for the <code>CopyDBSnapshot</code> API action
1706
- * that can be executed in the source Amazon Web Services Region that contains the encrypted DB snapshot to be copied.
1707
- * The presigned URL request must contain the following parameter values:</p>
1717
+ * <p>The presigned URL must be a valid request for the
1718
+ * <code>CopyDBClusterSnapshot</code> API operation that can run in the source
1719
+ * Amazon Web Services Region that contains the encrypted DB cluster snapshot to copy. The presigned URL request
1720
+ * must contain the following parameter values:</p>
1708
1721
  * <ul>
1709
1722
  * <li>
1710
1723
  * <p>
1711
- * <code>DestinationRegion</code> - The Amazon Web Services Region that the encrypted DB snapshot is copied to.
1712
- * This Amazon Web Services Region is the same one where the <code>CopyDBSnapshot</code> action is called that contains this presigned URL.</p>
1713
- * <p>For example, if you copy an encrypted DB snapshot from the us-west-2 Amazon Web Services Region
1714
- * to the us-east-1 Amazon Web Services Region, then you call the <code>CopyDBSnapshot</code> action in
1715
- * the us-east-1 Amazon Web Services Region and provide a presigned URL that contains a call to the
1716
- * <code>CopyDBSnapshot</code> action in the us-west-2 Amazon Web Services Region. For this
1717
- * example, the <code>DestinationRegion</code> in the presigned URL must be set to
1718
- * the us-east-1 Amazon Web Services Region.</p>
1724
+ * <code>DestinationRegion</code> - The Amazon Web Services Region that the encrypted DB
1725
+ * snapshot is copied to. This Amazon Web Services Region is the same one where the
1726
+ * <code>CopyDBSnapshot</code> operation is called that contains this presigned
1727
+ * URL.</p>
1728
+ * <p>For example, if you copy an encrypted DB snapshot from the us-west-2
1729
+ * Amazon Web Services Region to the us-east-1 Amazon Web Services Region, then you call the
1730
+ * <code>CopyDBSnapshot</code> operation in the us-east-1 Amazon Web Services Region and
1731
+ * provide a presigned URL that contains a call to the <code>CopyDBSnapshot</code>
1732
+ * operation in the us-west-2 Amazon Web Services Region. For this example, the
1733
+ * <code>DestinationRegion</code> in the presigned URL must be set to the
1734
+ * us-east-1 Amazon Web Services Region.</p>
1719
1735
  * </li>
1720
1736
  * <li>
1721
1737
  * <p>
1722
- * <code>KmsKeyId</code> - The Amazon Web Services KMS key identifier for the KMS key to use to encrypt the copy of the DB snapshot in the destination Amazon Web Services Region.
1723
- * This is the same identifier for both the <code>CopyDBSnapshot</code> action that is called in the destination Amazon Web Services Region,
1724
- * and the action contained in the presigned URL.</p>
1738
+ * <code>KmsKeyId</code> - The KMS key identifier for the KMS key to use to
1739
+ * encrypt the copy of the DB snapshot in the destination Amazon Web Services Region. This is the
1740
+ * same identifier for both the <code>CopyDBSnapshot</code> operation that is
1741
+ * called in the destination Amazon Web Services Region, and the operation contained in the
1742
+ * presigned URL.</p>
1725
1743
  * </li>
1726
1744
  * <li>
1727
1745
  * <p>
@@ -1735,9 +1753,11 @@ export interface CopyDBSnapshotMessage {
1735
1753
  * <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html">Authenticating Requests: Using Query Parameters (Amazon Web Services Signature Version 4)</a> and
1736
1754
  * <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">Signature Version 4 Signing Process</a>.</p>
1737
1755
  * <note>
1738
- * <p>If you are using an Amazon Web Services SDK tool or the CLI, you can specify <code>SourceRegion</code> (or <code>--source-region</code> for the CLI)
1739
- * instead of specifying <code>PreSignedUrl</code> manually. Specifying <code>SourceRegion</code> autogenerates a pre-signed URL that is a valid
1740
- * request for the operation that can be executed in the source Amazon Web Services Region.</p>
1756
+ * <p>If you are using an Amazon Web Services SDK tool or the CLI, you can specify
1757
+ * <code>SourceRegion</code> (or <code>--source-region</code> for the CLI)
1758
+ * instead of specifying <code>PreSignedUrl</code> manually. Specifying
1759
+ * <code>SourceRegion</code> autogenerates a presigned URL that is a valid request
1760
+ * for the operation that can run in the source Amazon Web Services Region.</p>
1741
1761
  * </note>
1742
1762
  */
1743
1763
  PreSignedUrl?: string;
@@ -2199,7 +2219,8 @@ export interface VpcSecurityGroupMembership {
2199
2219
  */
2200
2220
  VpcSecurityGroupId?: string;
2201
2221
  /**
2202
- * <p>The status of the VPC security group.</p>
2222
+ * <p>The membership status of the VPC security group.</p>
2223
+ * <p>Currently, the only valid status is <code>active</code>.</p>
2203
2224
  */
2204
2225
  Status?: string;
2205
2226
  }
@@ -3051,18 +3072,24 @@ export interface CreateDBClusterMessage {
3051
3072
  */
3052
3073
  KmsKeyId?: string;
3053
3074
  /**
3054
- * <p>A URL that contains a Signature Version 4 signed request for
3055
- * the <code>CreateDBCluster</code> action to be called in the source Amazon Web Services Region where the DB cluster is replicated from.
3056
- * Specify <code>PreSignedUrl</code> only when you are performing cross-Region replication from an encrypted DB cluster.</p>
3057
- * <p>The pre-signed URL must be a valid request for the <code>CreateDBCluster</code> API action
3058
- * that can be executed in the source Amazon Web Services Region that contains the encrypted DB cluster to be copied.</p>
3059
- * <p>The pre-signed URL request must contain the following parameter values:</p>
3075
+ * <p>When you are replicating a DB cluster from one Amazon Web Services GovCloud (US) Region to another,
3076
+ * an URL that contains a Signature Version 4 signed request for the
3077
+ * <code>CreateDBCluster</code> operation to be called in the source Amazon Web Services Region where
3078
+ * the DB cluster is replicated from. Specify <code>PreSignedUrl</code> only when you are
3079
+ * performing cross-Region replication from an encrypted DB cluster.</p>
3080
+ *
3081
+ * <p>The presigned URL must be a valid request for the <code>CreateDBCluster</code> API
3082
+ * operation that can run in the source Amazon Web Services Region that contains the encrypted DB
3083
+ * cluster to copy.</p>
3084
+ * <p>The presigned URL request must contain the following parameter values:</p>
3060
3085
  * <ul>
3061
3086
  * <li>
3062
3087
  * <p>
3063
- * <code>KmsKeyId</code> - The Amazon Web Services KMS key identifier for the KMS key to use to encrypt the copy of
3064
- * the DB cluster in the destination Amazon Web Services Region. This should refer to the same KMS key for both the <code>CreateDBCluster</code>
3065
- * action that is called in the destination Amazon Web Services Region, and the action contained in the pre-signed URL.</p>
3088
+ * <code>KmsKeyId</code> - The KMS key identifier for the KMS key to use to
3089
+ * encrypt the copy of the DB cluster in the destination Amazon Web Services Region. This should
3090
+ * refer to the same KMS key for both the <code>CreateDBCluster</code> operation
3091
+ * that is called in the destination Amazon Web Services Region, and the operation contained in
3092
+ * the presigned URL.</p>
3066
3093
  * </li>
3067
3094
  * <li>
3068
3095
  * <p>
@@ -3083,9 +3110,11 @@ export interface CreateDBClusterMessage {
3083
3110
  * <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">
3084
3111
  * Signature Version 4 Signing Process</a>.</p>
3085
3112
  * <note>
3086
- * <p>If you are using an Amazon Web Services SDK tool or the CLI, you can specify <code>SourceRegion</code> (or <code>--source-region</code> for the CLI)
3087
- * instead of specifying <code>PreSignedUrl</code> manually. Specifying <code>SourceRegion</code> autogenerates a pre-signed URL that is a valid
3088
- * request for the operation that can be executed in the source Amazon Web Services Region.</p>
3113
+ * <p>If you are using an Amazon Web Services SDK tool or the CLI, you can specify
3114
+ * <code>SourceRegion</code> (or <code>--source-region</code> for the CLI)
3115
+ * instead of specifying <code>PreSignedUrl</code> manually. Specifying
3116
+ * <code>SourceRegion</code> autogenerates a presigned URL that is a valid request
3117
+ * for the operation that can run in the source Amazon Web Services Region.</p>
3089
3118
  * </note>
3090
3119
  * <p>Valid for: Aurora DB clusters only</p>
3091
3120
  */
@@ -3096,7 +3125,7 @@ export interface CreateDBClusterMessage {
3096
3125
  * enabled.</p>
3097
3126
  * <p>For more information, see
3098
3127
  * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/UsingWithRDS.IAMDBAuth.html">
3099
- * IAM Database Authentication</a> in the <i>Amazon Aurora User Guide.</i>.</p>
3128
+ * IAM Database Authentication</a> in the <i>Amazon Aurora User Guide</i>.</p>
3100
3129
  * <p>Valid for: Aurora DB clusters only</p>
3101
3130
  */
3102
3131
  EnableIAMDatabaseAuthentication?: boolean;
@@ -3145,6 +3174,7 @@ export interface CreateDBClusterMessage {
3145
3174
  * <p>The <code>global</code> engine mode isn't required for Aurora MySQL version 1.22 and higher 1.x versions,
3146
3175
  * and <code>global</code> engine mode isn't required for any 2.x versions.</p>
3147
3176
  * <p>The <code>multimaster</code> engine mode only applies for DB clusters created with Aurora MySQL version 5.6.10a.</p>
3177
+ * <p>The <code>serverless</code> engine mode only applies for Aurora Serverless v1 DB clusters.</p>
3148
3178
  * <p>For Aurora PostgreSQL, the <code>global</code> engine mode isn't required, and both the <code>parallelquery</code>
3149
3179
  * and the <code>multimaster</code> engine modes currently aren't supported.</p>
3150
3180
  * <p>Limitations and requirements apply to some DB engine modes. For more information, see the
@@ -3152,26 +3182,31 @@ export interface CreateDBClusterMessage {
3152
3182
  * <ul>
3153
3183
  * <li>
3154
3184
  * <p>
3155
- * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html#aurora-serverless.limitations">
3156
- * Limitations of Aurora Serverless v1</a>
3185
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless.html#aurora-serverless.limitations">Limitations of Aurora
3186
+ * Serverless v1</a>
3187
+ * </p>
3188
+ * </li>
3189
+ * <li>
3190
+ * <p>
3191
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-serverless-v2.requirements.html">Requirements
3192
+ * for Aurora Serverless v2</a>
3157
3193
  * </p>
3158
3194
  * </li>
3159
3195
  * <li>
3160
3196
  * <p>
3161
- * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations">
3162
- * Limitations of Parallel Query</a>
3197
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-mysql-parallel-query.html#aurora-mysql-parallel-query-limitations">Limitations of Parallel Query</a>
3163
3198
  * </p>
3164
3199
  * </li>
3165
3200
  * <li>
3166
3201
  * <p>
3167
- * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations">
3168
- * Limitations of Aurora Global Databases</a>
3202
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-global-database.html#aurora-global-database.limitations">Limitations of
3203
+ * Aurora Global Databases</a>
3169
3204
  * </p>
3170
3205
  * </li>
3171
3206
  * <li>
3172
3207
  * <p>
3173
- * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations">
3174
- * Limitations of Multi-Master Clusters</a>
3208
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/aurora-multi-master.html#aurora-multi-master-limitations">Limitations of
3209
+ * Multi-Master Clusters</a>
3175
3210
  * </p>
3176
3211
  * </li>
3177
3212
  * </ul>
@@ -3344,7 +3379,35 @@ export interface CreateDBClusterMessage {
3344
3379
  */
3345
3380
  PerformanceInsightsKMSKeyId?: string;
3346
3381
  /**
3347
- * <p>The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).</p>
3382
+ * <p>The number of days to retain Performance Insights data. The default is 7 days. The following values are valid:</p>
3383
+ * <ul>
3384
+ * <li>
3385
+ * <p>7</p>
3386
+ * </li>
3387
+ * <li>
3388
+ * <p>
3389
+ * <i>month</i> * 31, where <i>month</i> is a number of months from 1-23</p>
3390
+ * </li>
3391
+ * <li>
3392
+ * <p>731</p>
3393
+ * </li>
3394
+ * </ul>
3395
+ * <p>For example, the following values are valid:</p>
3396
+ * <ul>
3397
+ * <li>
3398
+ * <p>93 (3 months * 31)</p>
3399
+ * </li>
3400
+ * <li>
3401
+ * <p>341 (11 months * 31)</p>
3402
+ * </li>
3403
+ * <li>
3404
+ * <p>589 (19 months * 31)</p>
3405
+ * </li>
3406
+ * <li>
3407
+ * <p>731</p>
3408
+ * </li>
3409
+ * </ul>
3410
+ * <p>If you specify a retention period such as 94, which isn't a valid value, RDS issues an error.</p>
3348
3411
  * <p>Valid for: Multi-AZ DB clusters only</p>
3349
3412
  */
3350
3413
  PerformanceInsightsRetentionPeriod?: number;
@@ -3543,8 +3606,7 @@ export declare namespace ClusterPendingModifiedValues {
3543
3606
  */
3544
3607
  export interface ScalingConfigurationInfo {
3545
3608
  /**
3546
- * <p>The maximum capacity for the Aurora DB cluster in <code>serverless</code> DB engine
3547
- * mode.</p>
3609
+ * <p>The minimum capacity for an Aurora DB cluster in <code>serverless</code> DB engine mode.</p>
3548
3610
  */
3549
3611
  MinCapacity?: number;
3550
3612
  /**
@@ -3959,7 +4021,34 @@ export interface DBCluster {
3959
4021
  */
3960
4022
  PerformanceInsightsKMSKeyId?: string;
3961
4023
  /**
3962
- * <p>The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).</p>
4024
+ * <p>The number of days to retain Performance Insights data. The default is 7 days. The following values are valid:</p>
4025
+ * <ul>
4026
+ * <li>
4027
+ * <p>7</p>
4028
+ * </li>
4029
+ * <li>
4030
+ * <p>
4031
+ * <i>month</i> * 31, where <i>month</i> is a number of months from 1-23</p>
4032
+ * </li>
4033
+ * <li>
4034
+ * <p>731</p>
4035
+ * </li>
4036
+ * </ul>
4037
+ * <p>For example, the following values are valid:</p>
4038
+ * <ul>
4039
+ * <li>
4040
+ * <p>93 (3 months * 31)</p>
4041
+ * </li>
4042
+ * <li>
4043
+ * <p>341 (11 months * 31)</p>
4044
+ * </li>
4045
+ * <li>
4046
+ * <p>589 (19 months * 31)</p>
4047
+ * </li>
4048
+ * <li>
4049
+ * <p>731</p>
4050
+ * </li>
4051
+ * </ul>
3963
4052
  * <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>
3964
4053
  */
3965
4054
  PerformanceInsightsRetentionPeriod?: number;
@@ -4759,11 +4848,13 @@ export interface CreateDBInstanceMessage {
4759
4848
  */
4760
4849
  AllocatedStorage?: number;
4761
4850
  /**
4762
- * <p>The compute and memory capacity of the DB instance, for example db.m4.large.
4851
+ * <p>The compute and memory capacity of the DB instance, for example db.m5.large.
4763
4852
  * Not all DB instance classes are available in all Amazon Web Services Regions, or for all database engines.
4764
- * For the full list of DB instance classes,
4765
- * and availability for your engine, see
4766
- * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html">DB Instance Class</a> in the <i>Amazon RDS User Guide</i>.</p>
4853
+ * For the full list of DB instance classes, and availability for your engine, see
4854
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html">DB instance
4855
+ * classes</a> in the <i>Amazon RDS User Guide</i> or
4856
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.DBInstanceClass.html">Aurora
4857
+ * DB instance classes</a> in the <i>Amazon Aurora User Guide</i>.</p>
4767
4858
  */
4768
4859
  DBInstanceClass: string | undefined;
4769
4860
  /**
@@ -4919,7 +5010,8 @@ export interface CreateDBInstanceMessage {
4919
5010
  MasterUserPassword?: string;
4920
5011
  /**
4921
5012
  * <p>A list of DB security groups to associate with this DB instance.</p>
4922
- * <p>Default: The default DB security group for the database engine.</p>
5013
+ * <p>This setting applies to the legacy EC2-Classic platform, which is no longer used to create
5014
+ * new DB instances. Use the <code>VpcSecurityGroupIds</code> setting instead.</p>
4923
5015
  */
4924
5016
  DBSecurityGroups?: string[];
4925
5017
  /**
@@ -5004,7 +5096,7 @@ export interface CreateDBInstanceMessage {
5004
5096
  * <p>Can't be set to 0 if the DB instance is a source to read replicas</p>
5005
5097
  * </li>
5006
5098
  * <li>
5007
- * <p>Can't be set to 0 or 35 for an RDS Custom for Oracle DB instance</p>
5099
+ * <p>Can't be set to 0 for an RDS Custom for Oracle DB instance</p>
5008
5100
  * </li>
5009
5101
  * </ul>
5010
5102
  */
@@ -5092,11 +5184,16 @@ export interface CreateDBInstanceMessage {
5092
5184
  * <p>A value that indicates whether the DB instance is a Multi-AZ deployment. You can't set
5093
5185
  * the <code>AvailabilityZone</code> parameter if the DB instance is a Multi-AZ deployment.</p>
5094
5186
  * <p>This setting doesn't apply to RDS Custom.</p>
5187
+ * <p>
5188
+ * <b>Amazon Aurora</b>
5189
+ * </p>
5190
+ * <p>Not applicable. DB instance Availability Zones (AZs) are managed by the DB cluster.</p>
5095
5191
  */
5096
5192
  MultiAZ?: boolean;
5097
5193
  /**
5098
5194
  * <p>The version number of the database engine to use.</p>
5099
- * <p>For a list of valid engine versions, use the <code>DescribeDBEngineVersions</code> action.</p>
5195
+ * <p>For a list of valid engine versions, use the <code>DescribeDBEngineVersions</code>
5196
+ * operation.</p>
5100
5197
  * <p>The following are the database engines and links to information about the major and minor versions that are available with
5101
5198
  * Amazon RDS. Not every database engine is available for every Amazon Web Services Region.</p>
5102
5199
  * <p>
@@ -5156,6 +5253,10 @@ export interface CreateDBInstanceMessage {
5156
5253
  * <p>Valid values: <code>license-included</code> | <code>bring-your-own-license</code> | <code>general-public-license</code>
5157
5254
  * </p>
5158
5255
  * <p>This setting doesn't apply to RDS Custom.</p>
5256
+ * <p>
5257
+ * <b>Amazon Aurora</b>
5258
+ * </p>
5259
+ * <p>Not applicable.</p>
5159
5260
  */
5160
5261
  LicenseModel?: string;
5161
5262
  /**
@@ -5164,6 +5265,10 @@ export interface CreateDBInstanceMessage {
5164
5265
  * <p>Constraints: For MariaDB, MySQL, Oracle, and PostgreSQL DB instances, must be a multiple between .5 and 50
5165
5266
  * of the storage amount for the DB instance. For SQL Server DB instances, must be a multiple between 1 and 50
5166
5267
  * of the storage amount for the DB instance.</p>
5268
+ * <p>
5269
+ * <b>Amazon Aurora</b>
5270
+ * </p>
5271
+ * <p>Not applicable. Storage is managed by the DB cluster.</p>
5167
5272
  */
5168
5273
  Iops?: number;
5169
5274
  /**
@@ -5172,6 +5277,10 @@ export interface CreateDBInstanceMessage {
5172
5277
  * from an option group. Also, that option group can't be removed from a DB instance after it is
5173
5278
  * associated with a DB instance.</p>
5174
5279
  * <p>This setting doesn't apply to RDS Custom.</p>
5280
+ * <p>
5281
+ * <b>Amazon Aurora</b>
5282
+ * </p>
5283
+ * <p>Not applicable.</p>
5175
5284
  */
5176
5285
  OptionGroupName?: string;
5177
5286
  /**
@@ -5237,11 +5346,19 @@ export interface CreateDBInstanceMessage {
5237
5346
  * <p>Default: <code>io1</code> if the <code>Iops</code> parameter
5238
5347
  * is specified, otherwise <code>gp2</code>
5239
5348
  * </p>
5349
+ * <p>
5350
+ * <b>Amazon Aurora</b>
5351
+ * </p>
5352
+ * <p>Not applicable. Storage is managed by the DB cluster.</p>
5240
5353
  */
5241
5354
  StorageType?: string;
5242
5355
  /**
5243
5356
  * <p>The ARN from the key store with which to associate the instance for TDE encryption.</p>
5244
5357
  * <p>This setting doesn't apply to RDS Custom.</p>
5358
+ * <p>
5359
+ * <b>Amazon Aurora</b>
5360
+ * </p>
5361
+ * <p>Not applicable.</p>
5245
5362
  */
5246
5363
  TdeCredentialArn?: string;
5247
5364
  /**
@@ -5287,6 +5404,10 @@ export interface CreateDBInstanceMessage {
5287
5404
  * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html">
5288
5405
  * Kerberos Authentication</a> in the <i>Amazon RDS User Guide</i>.</p>
5289
5406
  * <p>This setting doesn't apply to RDS Custom.</p>
5407
+ * <p>
5408
+ * <b>Amazon Aurora</b>
5409
+ * </p>
5410
+ * <p>Not applicable. The domain is managed by the DB cluster.</p>
5290
5411
  */
5291
5412
  Domain?: string;
5292
5413
  /**
@@ -5320,6 +5441,10 @@ export interface CreateDBInstanceMessage {
5320
5441
  /**
5321
5442
  * <p>Specify the name of the IAM role to be used when making API calls to the Directory Service.</p>
5322
5443
  * <p>This setting doesn't apply to RDS Custom.</p>
5444
+ * <p>
5445
+ * <b>Amazon Aurora</b>
5446
+ * </p>
5447
+ * <p>Not applicable. The domain is managed by the DB cluster.</p>
5323
5448
  */
5324
5449
  DomainIAMRoleName?: string;
5325
5450
  /**
@@ -5341,11 +5466,14 @@ export interface CreateDBInstanceMessage {
5341
5466
  /**
5342
5467
  * <p>A value that indicates whether to enable mapping of Amazon Web Services Identity and Access Management
5343
5468
  * (IAM) accounts to database accounts. By default, mapping isn't enabled.</p>
5344
- * <p>This setting doesn't apply to RDS Custom or Amazon Aurora. In Aurora, mapping Amazon Web Services IAM accounts
5345
- * to database accounts is managed by the DB cluster.</p>
5346
5469
  * <p>For more information, see
5347
- * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html">
5348
- * IAM Database Authentication for MySQL and PostgreSQL</a> in the <i>Amazon RDS User Guide</i>.</p>
5470
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html">
5471
+ * IAM Database Authentication for MySQL and PostgreSQL</a> in the <i>Amazon RDS User Guide</i>.</p>
5472
+ * <p>This setting doesn't apply to RDS Custom.</p>
5473
+ * <p>
5474
+ * <b>Amazon Aurora</b>
5475
+ * </p>
5476
+ * <p>Not applicable. Mapping Amazon Web Services IAM accounts to database accounts is managed by the DB cluster.</p>
5349
5477
  */
5350
5478
  EnableIAMDatabaseAuthentication?: boolean;
5351
5479
  /**
@@ -5364,7 +5492,35 @@ export interface CreateDBInstanceMessage {
5364
5492
  */
5365
5493
  PerformanceInsightsKMSKeyId?: string;
5366
5494
  /**
5367
- * <p>The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).</p>
5495
+ * <p>The number of days to retain Performance Insights data. The default is 7 days. The following values are valid:</p>
5496
+ * <ul>
5497
+ * <li>
5498
+ * <p>7</p>
5499
+ * </li>
5500
+ * <li>
5501
+ * <p>
5502
+ * <i>month</i> * 31, where <i>month</i> is a number of months from 1-23</p>
5503
+ * </li>
5504
+ * <li>
5505
+ * <p>731</p>
5506
+ * </li>
5507
+ * </ul>
5508
+ * <p>For example, the following values are valid:</p>
5509
+ * <ul>
5510
+ * <li>
5511
+ * <p>93 (3 months * 31)</p>
5512
+ * </li>
5513
+ * <li>
5514
+ * <p>341 (11 months * 31)</p>
5515
+ * </li>
5516
+ * <li>
5517
+ * <p>589 (19 months * 31)</p>
5518
+ * </li>
5519
+ * <li>
5520
+ * <p>731</p>
5521
+ * </li>
5522
+ * </ul>
5523
+ * <p>If you specify a retention period such as 94, which isn't a valid value, RDS issues an error.</p>
5368
5524
  * <p>This setting doesn't apply to RDS Custom.</p>
5369
5525
  */
5370
5526
  PerformanceInsightsRetentionPeriod?: number;
@@ -5407,6 +5563,10 @@ export interface CreateDBInstanceMessage {
5407
5563
  /**
5408
5564
  * <p>The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.</p>
5409
5565
  * <p>This setting doesn't apply to RDS Custom.</p>
5566
+ * <p>
5567
+ * <b>Amazon Aurora</b>
5568
+ * </p>
5569
+ * <p>Not applicable.</p>
5410
5570
  */
5411
5571
  ProcessorFeatures?: ProcessorFeature[];
5412
5572
  /**
@@ -5430,6 +5590,10 @@ export interface CreateDBInstanceMessage {
5430
5590
  * Managing capacity automatically with Amazon RDS storage autoscaling</a>
5431
5591
  * in the <i>Amazon RDS User Guide</i>.</p>
5432
5592
  * <p>This setting doesn't apply to RDS Custom.</p>
5593
+ * <p>
5594
+ * <b>Amazon Aurora</b>
5595
+ * </p>
5596
+ * <p>Not applicable. Storage is managed by the DB cluster.</p>
5433
5597
  */
5434
5598
  MaxAllocatedStorage?: number;
5435
5599
  /**
@@ -6236,7 +6400,34 @@ export interface DBInstance {
6236
6400
  */
6237
6401
  PerformanceInsightsKMSKeyId?: string;
6238
6402
  /**
6239
- * <p>The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).</p>
6403
+ * <p>The number of days to retain Performance Insights data. The default is 7 days. The following values are valid:</p>
6404
+ * <ul>
6405
+ * <li>
6406
+ * <p>7</p>
6407
+ * </li>
6408
+ * <li>
6409
+ * <p>
6410
+ * <i>month</i> * 31, where <i>month</i> is a number of months from 1-23</p>
6411
+ * </li>
6412
+ * <li>
6413
+ * <p>731</p>
6414
+ * </li>
6415
+ * </ul>
6416
+ * <p>For example, the following values are valid:</p>
6417
+ * <ul>
6418
+ * <li>
6419
+ * <p>93 (3 months * 31)</p>
6420
+ * </li>
6421
+ * <li>
6422
+ * <p>341 (11 months * 31)</p>
6423
+ * </li>
6424
+ * <li>
6425
+ * <p>589 (19 months * 31)</p>
6426
+ * </li>
6427
+ * <li>
6428
+ * <p>731</p>
6429
+ * </li>
6430
+ * </ul>
6240
6431
  */
6241
6432
  PerformanceInsightsRetentionPeriod?: number;
6242
6433
  /**
@@ -6579,8 +6770,8 @@ export interface CreateDBInstanceReadReplicaMessage {
6579
6770
  * uses the <code>DBParameterGroup</code> of source DB instance for a same Region read
6580
6771
  * replica, or the default <code>DBParameterGroup</code> for the specified DB engine for a
6581
6772
  * cross-Region read replica.</p>
6582
- * <p>Specifying a parameter group for this operation is only supported for Oracle DB instances. It
6583
- * isn't supported for RDS Custom.</p>
6773
+ * <p>Specifying a parameter group for this operation is only supported for MySQL and Oracle DB instances.
6774
+ * It isn't supported for RDS Custom.</p>
6584
6775
  * <p>Constraints:</p>
6585
6776
  * <ul>
6586
6777
  * <li>
@@ -6704,36 +6895,42 @@ export interface CreateDBInstanceReadReplicaMessage {
6704
6895
  */
6705
6896
  KmsKeyId?: string;
6706
6897
  /**
6707
- * <p>The URL that contains a Signature Version 4 signed request for the <code>CreateDBInstanceReadReplica</code> API action
6708
- * in the source Amazon Web Services Region that contains the source DB instance.</p>
6898
+ * <p>When you are creating a read replica from one Amazon Web Services GovCloud (US) Region to another or
6899
+ * from one China Amazon Web Services Region to another, the URL that contains a Signature Version 4
6900
+ * signed request for the <code>CreateDBInstanceReadReplica</code> API operation in the
6901
+ * source Amazon Web Services Region that contains the source DB instance.</p>
6902
+ * <p>This setting applies only to Amazon Web Services GovCloud (US) Regions and
6903
+ * China Amazon Web Services Regions. It's ignored in other Amazon Web Services Regions.</p>
6709
6904
  * <p>You must specify this parameter when you create an encrypted read replica from
6710
6905
  * another Amazon Web Services Region by using the Amazon RDS API. Don't specify
6711
6906
  * <code>PreSignedUrl</code> when you are creating an encrypted read replica in the
6712
6907
  * same Amazon Web Services Region.</p>
6713
- * <p>The presigned URL must be a valid request for the <code>CreateDBInstanceReadReplica</code> API action
6714
- * that can be executed in the source Amazon Web Services Region that contains the encrypted source DB instance.
6715
- * The presigned URL request must contain the following parameter values:</p>
6908
+ * <p>The presigned URL must be a valid request for the
6909
+ * <code>CreateDBInstanceReadReplica</code> API operation that can run in the
6910
+ * source Amazon Web Services Region that contains the encrypted source DB instance. The presigned URL
6911
+ * request must contain the following parameter values:</p>
6716
6912
  * <ul>
6717
6913
  * <li>
6718
6914
  * <p>
6719
6915
  * <code>DestinationRegion</code> - The Amazon Web Services Region that the encrypted read
6720
6916
  * replica is created in. This Amazon Web Services Region is the same one where the
6721
- * <code>CreateDBInstanceReadReplica</code> action is called that contains this presigned URL.</p>
6722
- * <p>For example, if you create an encrypted DB instance in the us-west-1 Amazon Web Services Region,
6723
- * from a source DB instance in the us-east-2 Amazon Web Services Region,
6724
- * then you call the <code>CreateDBInstanceReadReplica</code> action in
6725
- * the us-east-1 Amazon Web Services Region and provide a presigned URL that contains a call to the
6726
- * <code>CreateDBInstanceReadReplica</code> action in the us-west-2 Amazon Web Services Region. For this
6727
- * example, the <code>DestinationRegion</code> in the presigned URL must be set to
6728
- * the us-east-1 Amazon Web Services Region.</p>
6917
+ * <code>CreateDBInstanceReadReplica</code> operation is called that contains
6918
+ * this presigned URL.</p>
6919
+ * <p>For example, if you create an encrypted DB instance in the us-west-1
6920
+ * Amazon Web Services Region, from a source DB instance in the us-east-2 Amazon Web Services Region, then you
6921
+ * call the <code>CreateDBInstanceReadReplica</code> operation in the us-east-1
6922
+ * Amazon Web Services Region and provide a presigned URL that contains a call to the
6923
+ * <code>CreateDBInstanceReadReplica</code> operation in the us-west-2
6924
+ * Amazon Web Services Region. For this example, the <code>DestinationRegion</code> in the
6925
+ * presigned URL must be set to the us-east-1 Amazon Web Services Region.</p>
6729
6926
  * </li>
6730
6927
  * <li>
6731
6928
  * <p>
6732
- * <code>KmsKeyId</code> - The Amazon Web Services KMS key identifier for the key to use to
6929
+ * <code>KmsKeyId</code> - The KMS key identifier for the key to use to
6733
6930
  * encrypt the read replica in the destination Amazon Web Services Region. This is the same
6734
- * identifier for both the <code>CreateDBInstanceReadReplica</code> action that is
6735
- * called in the destination Amazon Web Services Region, and the action contained in the presigned
6736
- * URL.</p>
6931
+ * identifier for both the <code>CreateDBInstanceReadReplica</code> operation that
6932
+ * is called in the destination Amazon Web Services Region, and the operation contained in the
6933
+ * presigned URL.</p>
6737
6934
  * </li>
6738
6935
  * <li>
6739
6936
  * <p>
@@ -6754,9 +6951,9 @@ export interface CreateDBInstanceReadReplicaMessage {
6754
6951
  * <code>SourceRegion</code> (or <code>--source-region</code> for the CLI)
6755
6952
  * instead of specifying <code>PreSignedUrl</code> manually. Specifying
6756
6953
  * <code>SourceRegion</code> autogenerates a presigned URL that is a valid request
6757
- * for the operation that can be executed in the source Amazon Web Services Region.</p>
6954
+ * for the operation that can run in the source Amazon Web Services Region.</p>
6758
6955
  * <p>
6759
- * <code>SourceRegion</code> isn't supported for SQL Server, because SQL Server on Amazon RDS
6956
+ * <code>SourceRegion</code> isn't supported for SQL Server, because Amazon RDS for SQL Server
6760
6957
  * doesn't support cross-Region read replicas.</p>
6761
6958
  * </note>
6762
6959
  * <p>This setting doesn't apply to RDS Custom.</p>
@@ -6788,7 +6985,36 @@ export interface CreateDBInstanceReadReplicaMessage {
6788
6985
  */
6789
6986
  PerformanceInsightsKMSKeyId?: string;
6790
6987
  /**
6791
- * <p>The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).</p>
6988
+ * <p>The number of days to retain Performance Insights data. The default is 7 days. The following values are valid:</p>
6989
+ * <ul>
6990
+ * <li>
6991
+ * <p>7</p>
6992
+ * </li>
6993
+ * <li>
6994
+ * <p>
6995
+ * <i>month</i> * 31, where <i>month</i> is a number of months from 1-23</p>
6996
+ * </li>
6997
+ * <li>
6998
+ * <p>731</p>
6999
+ * </li>
7000
+ * </ul>
7001
+ * <p>For example, the following values are valid:</p>
7002
+ * <ul>
7003
+ * <li>
7004
+ * <p>93 (3 months * 31)</p>
7005
+ * </li>
7006
+ * <li>
7007
+ * <p>341 (11 months * 31)</p>
7008
+ * </li>
7009
+ * <li>
7010
+ * <p>589 (19 months * 31)</p>
7011
+ * </li>
7012
+ * <li>
7013
+ * <p>731</p>
7014
+ * </li>
7015
+ * </ul>
7016
+ * <p>If you specify a retention period such as 94, which isn't a valid value, RDS issues an error.</p>
7017
+ *
6792
7018
  * <p>This setting doesn't apply to RDS Custom.</p>
6793
7019
  */
6794
7020
  PerformanceInsightsRetentionPeriod?: number;
@@ -7136,8 +7362,8 @@ export interface CreateDBProxyRequest {
7136
7362
  /**
7137
7363
  * <p>The kinds of databases that the proxy can connect to.
7138
7364
  * This value determines which database network protocol the proxy recognizes when it interprets
7139
- * network traffic to and from the database.
7140
- * The engine family applies to MySQL and PostgreSQL for both RDS and Aurora.</p>
7365
+ * network traffic to and from the database. For Aurora MySQL, RDS for MariaDB, and RDS for MySQL databases, specify <code>MYSQL</code>.
7366
+ * For Aurora PostgreSQL and RDS for PostgreSQL databases, specify <code>POSTGRESQL</code>.</p>
7141
7367
  */
7142
7368
  EngineFamily: EngineFamily | string | undefined;
7143
7369
  /**
@@ -7249,7 +7475,9 @@ export interface DBProxy {
7249
7475
  */
7250
7476
  Status?: DBProxyStatus | string;
7251
7477
  /**
7252
- * <p>The engine family applies to MySQL and PostgreSQL for both RDS and Aurora.</p>
7478
+ * <p>The kinds of databases that the proxy can connect to. This value determines which database network protocol
7479
+ * the proxy recognizes when it interprets network traffic to and from the database. <code>MYSQL</code> supports Aurora MySQL,
7480
+ * RDS for MariaDB, and RDS for MySQL databases. <code>POSTGRESQL</code> supports Aurora PostgreSQL and RDS for PostgreSQL databases.</p>
7253
7481
  */
7254
7482
  EngineFamily?: string;
7255
7483
  /**
@@ -7937,8 +8165,9 @@ export interface CreateGlobalClusterMessage {
7937
8165
  */
7938
8166
  DeletionProtection?: boolean;
7939
8167
  /**
7940
- * <p>The name for your database of up to 64 alpha-numeric characters. If you do not provide a name, Amazon
7941
- * Aurora will not create a database in the global database cluster you are creating.</p>
8168
+ * <p>The name for your database of up to 64 alphanumeric characters. If you do not provide
8169
+ * a name, Amazon Aurora will not create a database in the global database cluster you are
8170
+ * creating.</p>
7942
8171
  */
7943
8172
  DatabaseName?: string;
7944
8173
  /**