@aws-sdk/client-rds 3.121.0 → 3.122.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;
@@ -3959,7 +4022,34 @@ export interface DBCluster {
3959
4022
  */
3960
4023
  PerformanceInsightsKMSKeyId?: string;
3961
4024
  /**
3962
- * <p>The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).</p>
4025
+ * <p>The number of days to retain Performance Insights data. The default is 7 days. The following values are valid:</p>
4026
+ * <ul>
4027
+ * <li>
4028
+ * <p>7</p>
4029
+ * </li>
4030
+ * <li>
4031
+ * <p>
4032
+ * <i>month</i> * 31, where <i>month</i> is a number of months from 1-23</p>
4033
+ * </li>
4034
+ * <li>
4035
+ * <p>731</p>
4036
+ * </li>
4037
+ * </ul>
4038
+ * <p>For example, the following values are valid:</p>
4039
+ * <ul>
4040
+ * <li>
4041
+ * <p>93 (3 months * 31)</p>
4042
+ * </li>
4043
+ * <li>
4044
+ * <p>341 (11 months * 31)</p>
4045
+ * </li>
4046
+ * <li>
4047
+ * <p>589 (19 months * 31)</p>
4048
+ * </li>
4049
+ * <li>
4050
+ * <p>731</p>
4051
+ * </li>
4052
+ * </ul>
3963
4053
  * <p>This setting is only for non-Aurora Multi-AZ DB clusters.</p>
3964
4054
  */
3965
4055
  PerformanceInsightsRetentionPeriod?: number;
@@ -4759,11 +4849,13 @@ export interface CreateDBInstanceMessage {
4759
4849
  */
4760
4850
  AllocatedStorage?: number;
4761
4851
  /**
4762
- * <p>The compute and memory capacity of the DB instance, for example db.m4.large.
4852
+ * <p>The compute and memory capacity of the DB instance, for example db.m5.large.
4763
4853
  * 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>
4854
+ * For the full list of DB instance classes, and availability for your engine, see
4855
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/Concepts.DBInstanceClass.html">DB instance
4856
+ * classes</a> in the <i>Amazon RDS User Guide</i> or
4857
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Concepts.DBInstanceClass.html">Aurora
4858
+ * DB instance classes</a> in the <i>Amazon Aurora User Guide</i>.</p>
4767
4859
  */
4768
4860
  DBInstanceClass: string | undefined;
4769
4861
  /**
@@ -4919,7 +5011,8 @@ export interface CreateDBInstanceMessage {
4919
5011
  MasterUserPassword?: string;
4920
5012
  /**
4921
5013
  * <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>
5014
+ * <p>This setting applies to the legacy EC2-Classic platform, which is no longer used to create
5015
+ * new DB instances. Use the <code>VpcSecurityGroupIds</code> setting instead.</p>
4923
5016
  */
4924
5017
  DBSecurityGroups?: string[];
4925
5018
  /**
@@ -5004,7 +5097,7 @@ export interface CreateDBInstanceMessage {
5004
5097
  * <p>Can't be set to 0 if the DB instance is a source to read replicas</p>
5005
5098
  * </li>
5006
5099
  * <li>
5007
- * <p>Can't be set to 0 or 35 for an RDS Custom for Oracle DB instance</p>
5100
+ * <p>Can't be set to 0 for an RDS Custom for Oracle DB instance</p>
5008
5101
  * </li>
5009
5102
  * </ul>
5010
5103
  */
@@ -5092,11 +5185,16 @@ export interface CreateDBInstanceMessage {
5092
5185
  * <p>A value that indicates whether the DB instance is a Multi-AZ deployment. You can't set
5093
5186
  * the <code>AvailabilityZone</code> parameter if the DB instance is a Multi-AZ deployment.</p>
5094
5187
  * <p>This setting doesn't apply to RDS Custom.</p>
5188
+ * <p>
5189
+ * <b>Amazon Aurora</b>
5190
+ * </p>
5191
+ * <p>Not applicable. DB instance Availability Zones (AZs) are managed by the DB cluster.</p>
5095
5192
  */
5096
5193
  MultiAZ?: boolean;
5097
5194
  /**
5098
5195
  * <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>
5196
+ * <p>For a list of valid engine versions, use the <code>DescribeDBEngineVersions</code>
5197
+ * operation.</p>
5100
5198
  * <p>The following are the database engines and links to information about the major and minor versions that are available with
5101
5199
  * Amazon RDS. Not every database engine is available for every Amazon Web Services Region.</p>
5102
5200
  * <p>
@@ -5156,6 +5254,10 @@ export interface CreateDBInstanceMessage {
5156
5254
  * <p>Valid values: <code>license-included</code> | <code>bring-your-own-license</code> | <code>general-public-license</code>
5157
5255
  * </p>
5158
5256
  * <p>This setting doesn't apply to RDS Custom.</p>
5257
+ * <p>
5258
+ * <b>Amazon Aurora</b>
5259
+ * </p>
5260
+ * <p>Not applicable.</p>
5159
5261
  */
5160
5262
  LicenseModel?: string;
5161
5263
  /**
@@ -5164,6 +5266,10 @@ export interface CreateDBInstanceMessage {
5164
5266
  * <p>Constraints: For MariaDB, MySQL, Oracle, and PostgreSQL DB instances, must be a multiple between .5 and 50
5165
5267
  * of the storage amount for the DB instance. For SQL Server DB instances, must be a multiple between 1 and 50
5166
5268
  * of the storage amount for the DB instance.</p>
5269
+ * <p>
5270
+ * <b>Amazon Aurora</b>
5271
+ * </p>
5272
+ * <p>Not applicable. Storage is managed by the DB cluster.</p>
5167
5273
  */
5168
5274
  Iops?: number;
5169
5275
  /**
@@ -5172,6 +5278,10 @@ export interface CreateDBInstanceMessage {
5172
5278
  * from an option group. Also, that option group can't be removed from a DB instance after it is
5173
5279
  * associated with a DB instance.</p>
5174
5280
  * <p>This setting doesn't apply to RDS Custom.</p>
5281
+ * <p>
5282
+ * <b>Amazon Aurora</b>
5283
+ * </p>
5284
+ * <p>Not applicable.</p>
5175
5285
  */
5176
5286
  OptionGroupName?: string;
5177
5287
  /**
@@ -5237,11 +5347,19 @@ export interface CreateDBInstanceMessage {
5237
5347
  * <p>Default: <code>io1</code> if the <code>Iops</code> parameter
5238
5348
  * is specified, otherwise <code>gp2</code>
5239
5349
  * </p>
5350
+ * <p>
5351
+ * <b>Amazon Aurora</b>
5352
+ * </p>
5353
+ * <p>Not applicable. Storage is managed by the DB cluster.</p>
5240
5354
  */
5241
5355
  StorageType?: string;
5242
5356
  /**
5243
5357
  * <p>The ARN from the key store with which to associate the instance for TDE encryption.</p>
5244
5358
  * <p>This setting doesn't apply to RDS Custom.</p>
5359
+ * <p>
5360
+ * <b>Amazon Aurora</b>
5361
+ * </p>
5362
+ * <p>Not applicable.</p>
5245
5363
  */
5246
5364
  TdeCredentialArn?: string;
5247
5365
  /**
@@ -5287,6 +5405,10 @@ export interface CreateDBInstanceMessage {
5287
5405
  * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/kerberos-authentication.html">
5288
5406
  * Kerberos Authentication</a> in the <i>Amazon RDS User Guide</i>.</p>
5289
5407
  * <p>This setting doesn't apply to RDS Custom.</p>
5408
+ * <p>
5409
+ * <b>Amazon Aurora</b>
5410
+ * </p>
5411
+ * <p>Not applicable. The domain is managed by the DB cluster.</p>
5290
5412
  */
5291
5413
  Domain?: string;
5292
5414
  /**
@@ -5320,6 +5442,10 @@ export interface CreateDBInstanceMessage {
5320
5442
  /**
5321
5443
  * <p>Specify the name of the IAM role to be used when making API calls to the Directory Service.</p>
5322
5444
  * <p>This setting doesn't apply to RDS Custom.</p>
5445
+ * <p>
5446
+ * <b>Amazon Aurora</b>
5447
+ * </p>
5448
+ * <p>Not applicable. The domain is managed by the DB cluster.</p>
5323
5449
  */
5324
5450
  DomainIAMRoleName?: string;
5325
5451
  /**
@@ -5341,11 +5467,14 @@ export interface CreateDBInstanceMessage {
5341
5467
  /**
5342
5468
  * <p>A value that indicates whether to enable mapping of Amazon Web Services Identity and Access Management
5343
5469
  * (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
5470
  * <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>
5471
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/UsingWithRDS.IAMDBAuth.html">
5472
+ * IAM Database Authentication for MySQL and PostgreSQL</a> in the <i>Amazon RDS User Guide</i>.</p>
5473
+ * <p>This setting doesn't apply to RDS Custom.</p>
5474
+ * <p>
5475
+ * <b>Amazon Aurora</b>
5476
+ * </p>
5477
+ * <p>Not applicable. Mapping Amazon Web Services IAM accounts to database accounts is managed by the DB cluster.</p>
5349
5478
  */
5350
5479
  EnableIAMDatabaseAuthentication?: boolean;
5351
5480
  /**
@@ -5364,7 +5493,35 @@ export interface CreateDBInstanceMessage {
5364
5493
  */
5365
5494
  PerformanceInsightsKMSKeyId?: string;
5366
5495
  /**
5367
- * <p>The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).</p>
5496
+ * <p>The number of days to retain Performance Insights data. The default is 7 days. The following values are valid:</p>
5497
+ * <ul>
5498
+ * <li>
5499
+ * <p>7</p>
5500
+ * </li>
5501
+ * <li>
5502
+ * <p>
5503
+ * <i>month</i> * 31, where <i>month</i> is a number of months from 1-23</p>
5504
+ * </li>
5505
+ * <li>
5506
+ * <p>731</p>
5507
+ * </li>
5508
+ * </ul>
5509
+ * <p>For example, the following values are valid:</p>
5510
+ * <ul>
5511
+ * <li>
5512
+ * <p>93 (3 months * 31)</p>
5513
+ * </li>
5514
+ * <li>
5515
+ * <p>341 (11 months * 31)</p>
5516
+ * </li>
5517
+ * <li>
5518
+ * <p>589 (19 months * 31)</p>
5519
+ * </li>
5520
+ * <li>
5521
+ * <p>731</p>
5522
+ * </li>
5523
+ * </ul>
5524
+ * <p>If you specify a retention period such as 94, which isn't a valid value, RDS issues an error.</p>
5368
5525
  * <p>This setting doesn't apply to RDS Custom.</p>
5369
5526
  */
5370
5527
  PerformanceInsightsRetentionPeriod?: number;
@@ -5407,6 +5564,10 @@ export interface CreateDBInstanceMessage {
5407
5564
  /**
5408
5565
  * <p>The number of CPU cores and the number of threads per core for the DB instance class of the DB instance.</p>
5409
5566
  * <p>This setting doesn't apply to RDS Custom.</p>
5567
+ * <p>
5568
+ * <b>Amazon Aurora</b>
5569
+ * </p>
5570
+ * <p>Not applicable.</p>
5410
5571
  */
5411
5572
  ProcessorFeatures?: ProcessorFeature[];
5412
5573
  /**
@@ -5430,6 +5591,10 @@ export interface CreateDBInstanceMessage {
5430
5591
  * Managing capacity automatically with Amazon RDS storage autoscaling</a>
5431
5592
  * in the <i>Amazon RDS User Guide</i>.</p>
5432
5593
  * <p>This setting doesn't apply to RDS Custom.</p>
5594
+ * <p>
5595
+ * <b>Amazon Aurora</b>
5596
+ * </p>
5597
+ * <p>Not applicable. Storage is managed by the DB cluster.</p>
5433
5598
  */
5434
5599
  MaxAllocatedStorage?: number;
5435
5600
  /**
@@ -6236,7 +6401,34 @@ export interface DBInstance {
6236
6401
  */
6237
6402
  PerformanceInsightsKMSKeyId?: string;
6238
6403
  /**
6239
- * <p>The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).</p>
6404
+ * <p>The number of days to retain Performance Insights data. The default is 7 days. The following values are valid:</p>
6405
+ * <ul>
6406
+ * <li>
6407
+ * <p>7</p>
6408
+ * </li>
6409
+ * <li>
6410
+ * <p>
6411
+ * <i>month</i> * 31, where <i>month</i> is a number of months from 1-23</p>
6412
+ * </li>
6413
+ * <li>
6414
+ * <p>731</p>
6415
+ * </li>
6416
+ * </ul>
6417
+ * <p>For example, the following values are valid:</p>
6418
+ * <ul>
6419
+ * <li>
6420
+ * <p>93 (3 months * 31)</p>
6421
+ * </li>
6422
+ * <li>
6423
+ * <p>341 (11 months * 31)</p>
6424
+ * </li>
6425
+ * <li>
6426
+ * <p>589 (19 months * 31)</p>
6427
+ * </li>
6428
+ * <li>
6429
+ * <p>731</p>
6430
+ * </li>
6431
+ * </ul>
6240
6432
  */
6241
6433
  PerformanceInsightsRetentionPeriod?: number;
6242
6434
  /**
@@ -6579,8 +6771,8 @@ export interface CreateDBInstanceReadReplicaMessage {
6579
6771
  * uses the <code>DBParameterGroup</code> of source DB instance for a same Region read
6580
6772
  * replica, or the default <code>DBParameterGroup</code> for the specified DB engine for a
6581
6773
  * 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>
6774
+ * <p>Specifying a parameter group for this operation is only supported for MySQL and Oracle DB instances.
6775
+ * It isn't supported for RDS Custom.</p>
6584
6776
  * <p>Constraints:</p>
6585
6777
  * <ul>
6586
6778
  * <li>
@@ -6704,36 +6896,42 @@ export interface CreateDBInstanceReadReplicaMessage {
6704
6896
  */
6705
6897
  KmsKeyId?: string;
6706
6898
  /**
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>
6899
+ * <p>When you are creating a read replica from one Amazon Web Services GovCloud (US) Region to another or
6900
+ * from one China Amazon Web Services Region to another, the URL that contains a Signature Version 4
6901
+ * signed request for the <code>CreateDBInstanceReadReplica</code> API operation in the
6902
+ * source Amazon Web Services Region that contains the source DB instance.</p>
6903
+ * <p>This setting applies only to Amazon Web Services GovCloud (US) Regions and
6904
+ * China Amazon Web Services Regions. It's ignored in other Amazon Web Services Regions.</p>
6709
6905
  * <p>You must specify this parameter when you create an encrypted read replica from
6710
6906
  * another Amazon Web Services Region by using the Amazon RDS API. Don't specify
6711
6907
  * <code>PreSignedUrl</code> when you are creating an encrypted read replica in the
6712
6908
  * 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>
6909
+ * <p>The presigned URL must be a valid request for the
6910
+ * <code>CreateDBInstanceReadReplica</code> API operation that can run in the
6911
+ * source Amazon Web Services Region that contains the encrypted source DB instance. The presigned URL
6912
+ * request must contain the following parameter values:</p>
6716
6913
  * <ul>
6717
6914
  * <li>
6718
6915
  * <p>
6719
6916
  * <code>DestinationRegion</code> - The Amazon Web Services Region that the encrypted read
6720
6917
  * 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>
6918
+ * <code>CreateDBInstanceReadReplica</code> operation is called that contains
6919
+ * this presigned URL.</p>
6920
+ * <p>For example, if you create an encrypted DB instance in the us-west-1
6921
+ * Amazon Web Services Region, from a source DB instance in the us-east-2 Amazon Web Services Region, then you
6922
+ * call the <code>CreateDBInstanceReadReplica</code> operation in the us-east-1
6923
+ * Amazon Web Services Region and provide a presigned URL that contains a call to the
6924
+ * <code>CreateDBInstanceReadReplica</code> operation in the us-west-2
6925
+ * Amazon Web Services Region. For this example, the <code>DestinationRegion</code> in the
6926
+ * presigned URL must be set to the us-east-1 Amazon Web Services Region.</p>
6729
6927
  * </li>
6730
6928
  * <li>
6731
6929
  * <p>
6732
- * <code>KmsKeyId</code> - The Amazon Web Services KMS key identifier for the key to use to
6930
+ * <code>KmsKeyId</code> - The KMS key identifier for the key to use to
6733
6931
  * 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>
6932
+ * identifier for both the <code>CreateDBInstanceReadReplica</code> operation that
6933
+ * is called in the destination Amazon Web Services Region, and the operation contained in the
6934
+ * presigned URL.</p>
6737
6935
  * </li>
6738
6936
  * <li>
6739
6937
  * <p>
@@ -6754,9 +6952,9 @@ export interface CreateDBInstanceReadReplicaMessage {
6754
6952
  * <code>SourceRegion</code> (or <code>--source-region</code> for the CLI)
6755
6953
  * instead of specifying <code>PreSignedUrl</code> manually. Specifying
6756
6954
  * <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>
6955
+ * for the operation that can run in the source Amazon Web Services Region.</p>
6758
6956
  * <p>
6759
- * <code>SourceRegion</code> isn't supported for SQL Server, because SQL Server on Amazon RDS
6957
+ * <code>SourceRegion</code> isn't supported for SQL Server, because Amazon RDS for SQL Server
6760
6958
  * doesn't support cross-Region read replicas.</p>
6761
6959
  * </note>
6762
6960
  * <p>This setting doesn't apply to RDS Custom.</p>
@@ -6788,7 +6986,36 @@ export interface CreateDBInstanceReadReplicaMessage {
6788
6986
  */
6789
6987
  PerformanceInsightsKMSKeyId?: string;
6790
6988
  /**
6791
- * <p>The amount of time, in days, to retain Performance Insights data. Valid values are 7 or 731 (2 years).</p>
6989
+ * <p>The number of days to retain Performance Insights data. The default is 7 days. The following values are valid:</p>
6990
+ * <ul>
6991
+ * <li>
6992
+ * <p>7</p>
6993
+ * </li>
6994
+ * <li>
6995
+ * <p>
6996
+ * <i>month</i> * 31, where <i>month</i> is a number of months from 1-23</p>
6997
+ * </li>
6998
+ * <li>
6999
+ * <p>731</p>
7000
+ * </li>
7001
+ * </ul>
7002
+ * <p>For example, the following values are valid:</p>
7003
+ * <ul>
7004
+ * <li>
7005
+ * <p>93 (3 months * 31)</p>
7006
+ * </li>
7007
+ * <li>
7008
+ * <p>341 (11 months * 31)</p>
7009
+ * </li>
7010
+ * <li>
7011
+ * <p>589 (19 months * 31)</p>
7012
+ * </li>
7013
+ * <li>
7014
+ * <p>731</p>
7015
+ * </li>
7016
+ * </ul>
7017
+ * <p>If you specify a retention period such as 94, which isn't a valid value, RDS issues an error.</p>
7018
+ *
6792
7019
  * <p>This setting doesn't apply to RDS Custom.</p>
6793
7020
  */
6794
7021
  PerformanceInsightsRetentionPeriod?: number;
@@ -7937,8 +8164,9 @@ export interface CreateGlobalClusterMessage {
7937
8164
  */
7938
8165
  DeletionProtection?: boolean;
7939
8166
  /**
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>
8167
+ * <p>The name for your database of up to 64 alphanumeric characters. If you do not provide
8168
+ * a name, Amazon Aurora will not create a database in the global database cluster you are
8169
+ * creating.</p>
7942
8170
  */
7943
8171
  DatabaseName?: string;
7944
8172
  /**