@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.
package/CHANGELOG.md CHANGED
@@ -3,6 +3,14 @@
3
3
  All notable changes to this project will be documented in this file.
4
4
  See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
5
5
 
6
+ # [3.135.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.134.0...v3.135.0) (2022-07-21)
7
+
8
+ **Note:** Version bump only for package @aws-sdk/client-rds
9
+
10
+
11
+
12
+
13
+
6
14
  # [3.131.0](https://github.com/aws/aws-sdk-js-v3/compare/v3.130.0...v3.131.0) (2022-07-15)
7
15
 
8
16
  **Note:** Version bump only for package @aws-sdk/client-rds
@@ -251,7 +251,7 @@ export declare class RDS extends RDSClient {
251
251
  * Backtracking an Aurora DB Cluster</a> in the
252
252
  * <i>Amazon Aurora User Guide</i>.</p>
253
253
  * <note>
254
- * <p>This action only applies to Aurora MySQL DB clusters.</p>
254
+ * <p>This action applies only to Aurora MySQL DB clusters.</p>
255
255
  * </note>
256
256
  */
257
257
  backtrackDBCluster(args: BacktrackDBClusterCommandInput, options?: __HttpHandlerOptions): Promise<BacktrackDBClusterCommandOutput>;
@@ -274,9 +274,11 @@ export declare class RDS extends RDSClient {
274
274
  * <p>Copies a snapshot of a DB cluster.</p>
275
275
  * <p>To copy a DB cluster snapshot from a shared manual DB cluster snapshot, <code>SourceDBClusterSnapshotIdentifier</code>
276
276
  * must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.</p>
277
- * <p>You can copy an encrypted DB cluster snapshot from another Amazon Web Services Region. In that case, the Amazon Web Services Region where you call the <code>CopyDBClusterSnapshot</code> action
278
- * is the destination Amazon Web Services Region for the encrypted DB cluster snapshot to be copied to. To copy an encrypted DB cluster snapshot from another Amazon Web Services Region,
279
- * you must provide the following values:</p>
277
+ * <p>You can copy an encrypted DB cluster snapshot from another Amazon Web Services Region. In that case,
278
+ * the Amazon Web Services Region where you call the <code>CopyDBClusterSnapshot</code> operation is the
279
+ * destination Amazon Web Services Region for the encrypted DB cluster snapshot to be copied to. To copy
280
+ * an encrypted DB cluster snapshot from another Amazon Web Services Region, you must provide the
281
+ * following values:</p>
280
282
  * <ul>
281
283
  * <li>
282
284
  * <p>
@@ -285,49 +287,14 @@ export declare class RDS extends RDSClient {
285
287
  * </li>
286
288
  * <li>
287
289
  * <p>
288
- * <code>PreSignedUrl</code> - A URL that contains a Signature Version 4 signed request for the
289
- * <code>CopyDBClusterSnapshot</code> action to be called in the source Amazon Web Services Region where the DB cluster snapshot is copied from.
290
- * The pre-signed URL must be a valid request for the <code>CopyDBClusterSnapshot</code> API action that can be executed in the
291
- * source Amazon Web Services Region that contains the encrypted DB cluster snapshot to be copied.</p>
292
- * <p>The pre-signed URL request must contain the following parameter values:</p>
293
- * <ul>
294
- * <li>
295
- * <p>
296
- * <code>KmsKeyId</code> - The Amazon Web Services KMS key identifier for the KMS key to use to encrypt the copy of the DB
297
- * cluster snapshot in the destination Amazon Web Services Region. This is the same identifier for both the <code>CopyDBClusterSnapshot</code>
298
- * action that is called in the destination Amazon Web Services Region, and the action contained in the pre-signed URL.</p>
299
- * </li>
300
- * <li>
301
- * <p>
302
- * <code>DestinationRegion</code> - The name of the Amazon Web Services Region that the DB cluster snapshot is to be created in.</p>
303
- * </li>
304
- * <li>
305
- * <p>
306
- * <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB cluster
307
- * snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source Amazon Web Services Region. For example,
308
- * if you are copying an encrypted DB cluster snapshot from the us-west-2 Amazon Web Services Region, then your <code>SourceDBClusterSnapshotIdentifier</code>
309
- * looks like the following example: <code>arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115</code>.</p>
310
- * </li>
311
- * </ul>
312
- * <p>To learn how to generate a Signature Version 4 signed request, see
313
- * <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html">
314
- * Authenticating Requests: Using Query Parameters (Amazon Web Services Signature Version 4)</a> and
315
- * <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">
316
- * Signature Version 4 Signing Process</a>.</p>
317
- * <note>
318
- * <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)
319
- * instead of specifying <code>PreSignedUrl</code> manually. Specifying <code>SourceRegion</code> autogenerates a pre-signed URL that is a valid
320
- * request for the operation that can be executed in the source Amazon Web Services Region.</p>
321
- * </note>
322
- * </li>
323
- * <li>
324
- * <p>
325
290
  * <code>TargetDBClusterSnapshotIdentifier</code> - The identifier for the new copy of the DB cluster snapshot in the destination Amazon Web Services Region.</p>
326
291
  * </li>
327
292
  * <li>
328
293
  * <p>
329
- * <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied.
330
- * This identifier must be in the ARN format for the source Amazon Web Services Region and is the same value as the <code>SourceDBClusterSnapshotIdentifier</code> in the pre-signed URL.</p>
294
+ * <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot
295
+ * identifier for the encrypted DB cluster snapshot to be copied. This identifier
296
+ * must be in the ARN format for the source Amazon Web Services Region and is the same value as
297
+ * the <code>SourceDBClusterSnapshotIdentifier</code> in the presigned URL.</p>
331
298
  * </li>
332
299
  * </ul>
333
300
  * <p>To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified
@@ -353,9 +320,9 @@ export declare class RDS extends RDSClient {
353
320
  copyDBParameterGroup(args: CopyDBParameterGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CopyDBParameterGroupCommandOutput) => void): void;
354
321
  /**
355
322
  * <p>Copies the specified DB snapshot. The source DB snapshot must be in the <code>available</code> state.</p>
356
- * <p>You can copy a snapshot from one Amazon Web Services Region to another. In that case, the Amazon Web Services Region
357
- * where you call the <code>CopyDBSnapshot</code> action is the destination Amazon Web Services Region for the
358
- * DB snapshot copy.</p>
323
+ * <p>You can copy a snapshot from one Amazon Web Services Region to another. In that case, the
324
+ * Amazon Web Services Region where you call the <code>CopyDBSnapshot</code> operation is the destination
325
+ * Amazon Web Services Region for the DB snapshot copy.</p>
359
326
  * <p>This command doesn't apply to RDS Custom.</p>
360
327
  * <p>For more information about copying snapshots, see
361
328
  * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html#USER_CopyDBSnapshot">Copying a DB Snapshot</a> in the <i>Amazon RDS User Guide</i>.</p>
@@ -409,9 +376,7 @@ export declare class RDS extends RDSClient {
409
376
  * <p>Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.</p>
410
377
  * <p>You can use the <code>ReplicationSourceIdentifier</code> parameter to create an Amazon
411
378
  * Aurora DB cluster as a read replica of another DB cluster or Amazon RDS MySQL or
412
- * PostgreSQL DB instance. For cross-Region replication where the DB cluster identified by
413
- * <code>ReplicationSourceIdentifier</code> is encrypted, also specify the
414
- * <code>PreSignedUrl</code> parameter.</p>
379
+ * PostgreSQL DB instance.</p>
415
380
  * <p>For more information on Amazon Aurora, see
416
381
  * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html">
417
382
  * What is Amazon Aurora?</a> in the <i>Amazon Aurora User Guide</i>.</p>
@@ -425,7 +390,7 @@ export declare class RDS extends RDSClient {
425
390
  /**
426
391
  * <p>Creates a new custom endpoint and associates it with an Amazon Aurora DB cluster.</p>
427
392
  * <note>
428
- * <p>This action only applies to Aurora DB clusters.</p>
393
+ * <p>This action applies only to Aurora DB clusters.</p>
429
394
  * </note>
430
395
  */
431
396
  createDBClusterEndpoint(args: CreateDBClusterEndpointCommandInput, options?: __HttpHandlerOptions): Promise<CreateDBClusterEndpointCommandOutput>;
@@ -446,15 +411,15 @@ export declare class RDS extends RDSClient {
446
411
  * cluster without failover for the new DB cluster parameter group and associated settings to take effect.</p>
447
412
  * <important>
448
413
  * <p>After you create a DB cluster parameter group, you should wait at least 5 minutes
449
- * before creating your first DB cluster
450
- * that uses that DB cluster parameter group as the default parameter
451
- * group. This allows Amazon RDS to fully complete the create action before the DB cluster parameter
452
- * group is used as the default for a new DB cluster. This is especially important for parameters
453
- * that are critical when creating the default database for a DB cluster, such as the character set
454
- * for the default database defined by the <code>character_set_database</code> parameter. You can use the
455
- * <i>Parameter Groups</i> option of the <a href="https://console.aws.amazon.com/rds/">Amazon RDS console</a> or the
456
- * <code>DescribeDBClusterParameters</code> action to verify
457
- * that your DB cluster parameter group has been created or modified.</p>
414
+ * before creating your first DB cluster that uses that DB cluster parameter group as
415
+ * the default parameter group. This allows Amazon RDS to fully complete the create
416
+ * action before the DB cluster parameter group is used as the default for a new DB
417
+ * cluster. This is especially important for parameters that are critical when creating
418
+ * the default database for a DB cluster, such as the character set for the default
419
+ * database defined by the <code>character_set_database</code> parameter. You can use
420
+ * the <i>Parameter Groups</i> option of the <a href="https://console.aws.amazon.com/rds/">Amazon RDS console</a> or the
421
+ * <code>DescribeDBClusterParameters</code> operation to verify that your DB
422
+ * cluster parameter group has been created or modified.</p>
458
423
  * </important>
459
424
  * <p>For more information on Amazon Aurora, see
460
425
  * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html">
@@ -479,6 +444,14 @@ export declare class RDS extends RDSClient {
479
444
  createDBClusterSnapshot(args: CreateDBClusterSnapshotCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateDBClusterSnapshotCommandOutput) => void): void;
480
445
  /**
481
446
  * <p>Creates a new DB instance.</p>
447
+ * <p>The new DB instance can be an RDS DB instance, or it can be a DB instance in an Aurora DB cluster.
448
+ * For an Aurora DB cluster, you can call this operation multiple times to add more than one DB instance
449
+ * to the cluster.</p>
450
+ * <p>For more information about creating an RDS DB instance, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html">
451
+ * Creating an Amazon RDS DB instance</a> in the <i>Amazon RDS User Guide</i>.</p>
452
+ * <p>For more information about creating a DB instance in an Aurora DB cluster, see
453
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html">
454
+ * Creating an Amazon Aurora DB cluster</a> in the <i>Amazon Aurora User Guide</i>.</p>
482
455
  */
483
456
  createDBInstance(args: CreateDBInstanceCommandInput, options?: __HttpHandlerOptions): Promise<CreateDBInstanceCommandOutput>;
484
457
  createDBInstance(args: CreateDBInstanceCommandInput, cb: (err: any, data?: CreateDBInstanceCommandOutput) => void): void;
@@ -488,8 +461,8 @@ export declare class RDS extends RDSClient {
488
461
  * instance. You can create a read replica for a DB instance running MySQL, MariaDB,
489
462
  * Oracle, PostgreSQL, or SQL Server. For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html">Working with Read
490
463
  * Replicas</a> in the <i>Amazon RDS User Guide</i>.</p>
491
- * <p>Amazon Aurora doesn't support this action. Call the <code>CreateDBInstance</code>
492
- * action to create a DB instance for an Aurora DB cluster.</p>
464
+ * <p>Amazon Aurora doesn't support this operation. Call the <code>CreateDBInstance</code>
465
+ * operation to create a DB instance for an Aurora DB cluster.</p>
493
466
  * <p>All read replica DB instances are created with backups disabled. All other DB
494
467
  * instance attributes (including DB security groups and DB parameter groups) are inherited
495
468
  * from the source DB instance, except as specified.</p>
@@ -562,7 +535,7 @@ export declare class RDS extends RDSClient {
562
535
  createDBSubnetGroup(args: CreateDBSubnetGroupCommandInput, cb: (err: any, data?: CreateDBSubnetGroupCommandOutput) => void): void;
563
536
  createDBSubnetGroup(args: CreateDBSubnetGroupCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: CreateDBSubnetGroupCommandOutput) => void): void;
564
537
  /**
565
- * <p>Creates an RDS event notification subscription. This action requires a topic Amazon
538
+ * <p>Creates an RDS event notification subscription. This operation requires a topic Amazon
566
539
  * Resource Name (ARN) created by either the RDS console, the SNS console, or the SNS API.
567
540
  * To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the
568
541
  * topic. The ARN is displayed in the SNS console.</p>
@@ -600,7 +573,7 @@ export declare class RDS extends RDSClient {
600
573
  * Or you can specify an existing Aurora cluster during the create operation,
601
574
  * and this cluster becomes the primary cluster of the global database.</p>
602
575
  * <note>
603
- * <p>This action only applies to Aurora DB clusters.</p>
576
+ * <p>This action applies only to Aurora DB clusters.</p>
604
577
  * </note>
605
578
  */
606
579
  createGlobalCluster(args: CreateGlobalClusterCommandInput, options?: __HttpHandlerOptions): Promise<CreateGlobalClusterCommandOutput>;
@@ -1034,6 +1007,8 @@ export declare class RDS extends RDSClient {
1034
1007
  * <p>Returns events related to DB instances, DB clusters, DB parameter groups, DB security groups, DB snapshots, DB cluster snapshots, and RDS Proxies for the past 14 days.
1035
1008
  * Events specific to a particular DB instance, DB cluster, DB parameter group, DB security group, DB snapshot, DB cluster snapshot group, or RDS Proxy can be
1036
1009
  * obtained by providing the name as a parameter.</p>
1010
+ * <p>For more information on working with events, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/working-with-events.html">Monitoring Amazon RDS events</a> in the <i>Amazon RDS User Guide</i> and <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/working-with-events.html">Monitoring Amazon Aurora
1011
+ * events</a> in the <i>Amazon Aurora User Guide</i>.</p>
1037
1012
  * <note>
1038
1013
  * <p>By default, RDS returns events that were generated in the past hour.</p>
1039
1014
  * </note>
@@ -1132,7 +1107,7 @@ export declare class RDS extends RDSClient {
1132
1107
  * <p>For a Multi-AZ DB cluster, failover for a DB cluster promotes one of the readable standby DB instances (read-only instances)
1133
1108
  * in the DB cluster to be the primary DB instance (the cluster writer).</p>
1134
1109
  * <p>An Amazon Aurora DB cluster automatically fails over to an Aurora Replica, if one exists,
1135
- * when the primary DB instance fails. A Multi-AZ DB cluster automatically fails over to a readbable standby
1110
+ * when the primary DB instance fails. A Multi-AZ DB cluster automatically fails over to a readable standby
1136
1111
  * DB instance when the primary DB instance fails.</p>
1137
1112
  * <p>To simulate a failure of a primary instance for testing, you can force a failover.
1138
1113
  * Because each instance in a DB cluster has its own endpoint address, make sure to clean up and re-establish any existing
@@ -1279,7 +1254,7 @@ export declare class RDS extends RDSClient {
1279
1254
  * that are critical when creating the default database for a DB cluster, such as the character set
1280
1255
  * for the default database defined by the <code>character_set_database</code> parameter. You can use the
1281
1256
  * <i>Parameter Groups</i> option of the <a href="https://console.aws.amazon.com/rds/">Amazon RDS console</a> or the
1282
- * <code>DescribeDBClusterParameters</code> action to verify
1257
+ * <code>DescribeDBClusterParameters</code> operation to verify
1283
1258
  * that your DB cluster parameter group has been created or modified.</p>
1284
1259
  * <p>If the modified DB cluster parameter group is used by an Aurora Serverless v1 cluster, Aurora
1285
1260
  * applies the update immediately. The cluster restart might interrupt your workload. In that case,
@@ -1315,7 +1290,7 @@ export declare class RDS extends RDSClient {
1315
1290
  * parameter. You can't use <code>all</code> as a value for that parameter in this
1316
1291
  * case.</p>
1317
1292
  * <p>To view which Amazon Web Services accounts have access to copy or restore a manual DB cluster
1318
- * snapshot, or whether a manual DB cluster snapshot is public or private, use the <a>DescribeDBClusterSnapshotAttributes</a> API action. The accounts are
1293
+ * snapshot, or whether a manual DB cluster snapshot is public or private, use the <a>DescribeDBClusterSnapshotAttributes</a> API operation. The accounts are
1319
1294
  * returned as values for the <code>restore</code> attribute.</p>
1320
1295
  */
1321
1296
  modifyDBClusterSnapshotAttribute(args: ModifyDBClusterSnapshotAttributeCommandInput, options?: __HttpHandlerOptions): Promise<ModifyDBClusterSnapshotAttributeCommandOutput>;
@@ -1395,7 +1370,7 @@ export declare class RDS extends RDSClient {
1395
1370
  * list of authorized Amazon Web Services account IDs for the <code>ValuesToAdd</code> parameter. You
1396
1371
  * can't use <code>all</code> as a value for that parameter in this case.</p>
1397
1372
  * <p>To view which Amazon Web Services accounts have access to copy or restore a manual DB snapshot, or
1398
- * whether a manual DB snapshot public or private, use the <a>DescribeDBSnapshotAttributes</a> API action. The accounts are returned as
1373
+ * whether a manual DB snapshot public or private, use the <a>DescribeDBSnapshotAttributes</a> API operation. The accounts are returned as
1399
1374
  * values for the <code>restore</code> attribute.</p>
1400
1375
  */
1401
1376
  modifyDBSnapshotAttribute(args: ModifyDBSnapshotAttributeCommandInput, options?: __HttpHandlerOptions): Promise<ModifyDBSnapshotAttributeCommandOutput>;
@@ -1497,6 +1472,7 @@ export declare class RDS extends RDSClient {
1497
1472
  * <p>For more information about rebooting, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RebootInstance.html">Rebooting a DB Instance</a> in the <i>Amazon RDS User Guide.</i>
1498
1473
  * </p>
1499
1474
  * <p>This command doesn't apply to RDS Custom.</p>
1475
+ * <p>If your DB instance is part of a Multi-AZ DB cluster, you can reboot the DB cluster with the <code>RebootDBCluster</code> operation.</p>
1500
1476
  */
1501
1477
  rebootDBInstance(args: RebootDBInstanceCommandInput, options?: __HttpHandlerOptions): Promise<RebootDBInstanceCommandOutput>;
1502
1478
  rebootDBInstance(args: RebootDBInstanceCommandInput, cb: (err: any, data?: RebootDBInstanceCommandOutput) => void): void;
@@ -1812,7 +1788,7 @@ export declare class RDS extends RDSClient {
1812
1788
  stopDBInstance(args: StopDBInstanceCommandInput, options: __HttpHandlerOptions, cb: (err: any, data?: StopDBInstanceCommandOutput) => void): void;
1813
1789
  /**
1814
1790
  * <p>Stops automated backup replication for a DB instance.</p>
1815
- * <p>This command doesn't apply to RDS Custom.</p>
1791
+ * <p>This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora PostgreSQL.</p>
1816
1792
  * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html">
1817
1793
  * Replicating Automated Backups to Another Amazon Web Services Region</a> in the <i>Amazon RDS User Guide.</i>
1818
1794
  * </p>
@@ -13,7 +13,7 @@ export interface BacktrackDBClusterCommandOutput extends DBClusterBacktrack, __M
13
13
  * Backtracking an Aurora DB Cluster</a> in the
14
14
  * <i>Amazon Aurora User Guide</i>.</p>
15
15
  * <note>
16
- * <p>This action only applies to Aurora MySQL DB clusters.</p>
16
+ * <p>This action applies only to Aurora MySQL DB clusters.</p>
17
17
  * </note>
18
18
  * @example
19
19
  * Use a bare-bones client and the command you need to make an API call.
@@ -10,9 +10,11 @@ export interface CopyDBClusterSnapshotCommandOutput extends CopyDBClusterSnapsho
10
10
  * <p>Copies a snapshot of a DB cluster.</p>
11
11
  * <p>To copy a DB cluster snapshot from a shared manual DB cluster snapshot, <code>SourceDBClusterSnapshotIdentifier</code>
12
12
  * must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.</p>
13
- * <p>You can copy an encrypted DB cluster snapshot from another Amazon Web Services Region. In that case, the Amazon Web Services Region where you call the <code>CopyDBClusterSnapshot</code> action
14
- * is the destination Amazon Web Services Region for the encrypted DB cluster snapshot to be copied to. To copy an encrypted DB cluster snapshot from another Amazon Web Services Region,
15
- * you must provide the following values:</p>
13
+ * <p>You can copy an encrypted DB cluster snapshot from another Amazon Web Services Region. In that case,
14
+ * the Amazon Web Services Region where you call the <code>CopyDBClusterSnapshot</code> operation is the
15
+ * destination Amazon Web Services Region for the encrypted DB cluster snapshot to be copied to. To copy
16
+ * an encrypted DB cluster snapshot from another Amazon Web Services Region, you must provide the
17
+ * following values:</p>
16
18
  * <ul>
17
19
  * <li>
18
20
  * <p>
@@ -21,49 +23,14 @@ export interface CopyDBClusterSnapshotCommandOutput extends CopyDBClusterSnapsho
21
23
  * </li>
22
24
  * <li>
23
25
  * <p>
24
- * <code>PreSignedUrl</code> - A URL that contains a Signature Version 4 signed request for the
25
- * <code>CopyDBClusterSnapshot</code> action to be called in the source Amazon Web Services Region where the DB cluster snapshot is copied from.
26
- * The pre-signed URL must be a valid request for the <code>CopyDBClusterSnapshot</code> API action that can be executed in the
27
- * source Amazon Web Services Region that contains the encrypted DB cluster snapshot to be copied.</p>
28
- * <p>The pre-signed URL request must contain the following parameter values:</p>
29
- * <ul>
30
- * <li>
31
- * <p>
32
- * <code>KmsKeyId</code> - The Amazon Web Services KMS key identifier for the KMS key to use to encrypt the copy of the DB
33
- * cluster snapshot in the destination Amazon Web Services Region. This is the same identifier for both the <code>CopyDBClusterSnapshot</code>
34
- * action that is called in the destination Amazon Web Services Region, and the action contained in the pre-signed URL.</p>
35
- * </li>
36
- * <li>
37
- * <p>
38
- * <code>DestinationRegion</code> - The name of the Amazon Web Services Region that the DB cluster snapshot is to be created in.</p>
39
- * </li>
40
- * <li>
41
- * <p>
42
- * <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB cluster
43
- * snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source Amazon Web Services Region. For example,
44
- * if you are copying an encrypted DB cluster snapshot from the us-west-2 Amazon Web Services Region, then your <code>SourceDBClusterSnapshotIdentifier</code>
45
- * looks like the following example: <code>arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115</code>.</p>
46
- * </li>
47
- * </ul>
48
- * <p>To learn how to generate a Signature Version 4 signed request, see
49
- * <a href="https://docs.aws.amazon.com/AmazonS3/latest/API/sigv4-query-string-auth.html">
50
- * Authenticating Requests: Using Query Parameters (Amazon Web Services Signature Version 4)</a> and
51
- * <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">
52
- * Signature Version 4 Signing Process</a>.</p>
53
- * <note>
54
- * <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)
55
- * instead of specifying <code>PreSignedUrl</code> manually. Specifying <code>SourceRegion</code> autogenerates a pre-signed URL that is a valid
56
- * request for the operation that can be executed in the source Amazon Web Services Region.</p>
57
- * </note>
58
- * </li>
59
- * <li>
60
- * <p>
61
26
  * <code>TargetDBClusterSnapshotIdentifier</code> - The identifier for the new copy of the DB cluster snapshot in the destination Amazon Web Services Region.</p>
62
27
  * </li>
63
28
  * <li>
64
29
  * <p>
65
- * <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied.
66
- * This identifier must be in the ARN format for the source Amazon Web Services Region and is the same value as the <code>SourceDBClusterSnapshotIdentifier</code> in the pre-signed URL.</p>
30
+ * <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot
31
+ * identifier for the encrypted DB cluster snapshot to be copied. This identifier
32
+ * must be in the ARN format for the source Amazon Web Services Region and is the same value as
33
+ * the <code>SourceDBClusterSnapshotIdentifier</code> in the presigned URL.</p>
67
34
  * </li>
68
35
  * </ul>
69
36
  * <p>To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified
@@ -8,9 +8,9 @@ export interface CopyDBSnapshotCommandOutput extends CopyDBSnapshotResult, __Met
8
8
  }
9
9
  /**
10
10
  * <p>Copies the specified DB snapshot. The source DB snapshot must be in the <code>available</code> state.</p>
11
- * <p>You can copy a snapshot from one Amazon Web Services Region to another. In that case, the Amazon Web Services Region
12
- * where you call the <code>CopyDBSnapshot</code> action is the destination Amazon Web Services Region for the
13
- * DB snapshot copy.</p>
11
+ * <p>You can copy a snapshot from one Amazon Web Services Region to another. In that case, the
12
+ * Amazon Web Services Region where you call the <code>CopyDBSnapshot</code> operation is the destination
13
+ * Amazon Web Services Region for the DB snapshot copy.</p>
14
14
  * <p>This command doesn't apply to RDS Custom.</p>
15
15
  * <p>For more information about copying snapshots, see
16
16
  * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CopySnapshot.html#USER_CopyDBSnapshot">Copying a DB Snapshot</a> in the <i>Amazon RDS User Guide</i>.</p>
@@ -10,9 +10,7 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M
10
10
  * <p>Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.</p>
11
11
  * <p>You can use the <code>ReplicationSourceIdentifier</code> parameter to create an Amazon
12
12
  * Aurora DB cluster as a read replica of another DB cluster or Amazon RDS MySQL or
13
- * PostgreSQL DB instance. For cross-Region replication where the DB cluster identified by
14
- * <code>ReplicationSourceIdentifier</code> is encrypted, also specify the
15
- * <code>PreSignedUrl</code> parameter.</p>
13
+ * PostgreSQL DB instance.</p>
16
14
  * <p>For more information on Amazon Aurora, see
17
15
  * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html">
18
16
  * What is Amazon Aurora?</a> in the <i>Amazon Aurora User Guide</i>.</p>
@@ -9,7 +9,7 @@ export interface CreateDBClusterEndpointCommandOutput extends DBClusterEndpoint,
9
9
  /**
10
10
  * <p>Creates a new custom endpoint and associates it with an Amazon Aurora DB cluster.</p>
11
11
  * <note>
12
- * <p>This action only applies to Aurora DB clusters.</p>
12
+ * <p>This action applies only to Aurora DB clusters.</p>
13
13
  * </note>
14
14
  * @example
15
15
  * Use a bare-bones client and the command you need to make an API call.
@@ -21,15 +21,15 @@ export interface CreateDBClusterParameterGroupCommandOutput extends CreateDBClus
21
21
  * cluster without failover for the new DB cluster parameter group and associated settings to take effect.</p>
22
22
  * <important>
23
23
  * <p>After you create a DB cluster parameter group, you should wait at least 5 minutes
24
- * before creating your first DB cluster
25
- * that uses that DB cluster parameter group as the default parameter
26
- * group. This allows Amazon RDS to fully complete the create action before the DB cluster parameter
27
- * group is used as the default for a new DB cluster. This is especially important for parameters
28
- * that are critical when creating the default database for a DB cluster, such as the character set
29
- * for the default database defined by the <code>character_set_database</code> parameter. You can use the
30
- * <i>Parameter Groups</i> option of the <a href="https://console.aws.amazon.com/rds/">Amazon RDS console</a> or the
31
- * <code>DescribeDBClusterParameters</code> action to verify
32
- * that your DB cluster parameter group has been created or modified.</p>
24
+ * before creating your first DB cluster that uses that DB cluster parameter group as
25
+ * the default parameter group. This allows Amazon RDS to fully complete the create
26
+ * action before the DB cluster parameter group is used as the default for a new DB
27
+ * cluster. This is especially important for parameters that are critical when creating
28
+ * the default database for a DB cluster, such as the character set for the default
29
+ * database defined by the <code>character_set_database</code> parameter. You can use
30
+ * the <i>Parameter Groups</i> option of the <a href="https://console.aws.amazon.com/rds/">Amazon RDS console</a> or the
31
+ * <code>DescribeDBClusterParameters</code> operation to verify that your DB
32
+ * cluster parameter group has been created or modified.</p>
33
33
  * </important>
34
34
  * <p>For more information on Amazon Aurora, see
35
35
  * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html">
@@ -8,6 +8,14 @@ export interface CreateDBInstanceCommandOutput extends CreateDBInstanceResult, _
8
8
  }
9
9
  /**
10
10
  * <p>Creates a new DB instance.</p>
11
+ * <p>The new DB instance can be an RDS DB instance, or it can be a DB instance in an Aurora DB cluster.
12
+ * For an Aurora DB cluster, you can call this operation multiple times to add more than one DB instance
13
+ * to the cluster.</p>
14
+ * <p>For more information about creating an RDS DB instance, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html">
15
+ * Creating an Amazon RDS DB instance</a> in the <i>Amazon RDS User Guide</i>.</p>
16
+ * <p>For more information about creating a DB instance in an Aurora DB cluster, see
17
+ * <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html">
18
+ * Creating an Amazon Aurora DB cluster</a> in the <i>Amazon Aurora User Guide</i>.</p>
11
19
  * @example
12
20
  * Use a bare-bones client and the command you need to make an API call.
13
21
  * ```javascript
@@ -11,8 +11,8 @@ export interface CreateDBInstanceReadReplicaCommandOutput extends CreateDBInstan
11
11
  * instance. You can create a read replica for a DB instance running MySQL, MariaDB,
12
12
  * Oracle, PostgreSQL, or SQL Server. For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReadRepl.html">Working with Read
13
13
  * Replicas</a> in the <i>Amazon RDS User Guide</i>.</p>
14
- * <p>Amazon Aurora doesn't support this action. Call the <code>CreateDBInstance</code>
15
- * action to create a DB instance for an Aurora DB cluster.</p>
14
+ * <p>Amazon Aurora doesn't support this operation. Call the <code>CreateDBInstance</code>
15
+ * operation to create a DB instance for an Aurora DB cluster.</p>
16
16
  * <p>All read replica DB instances are created with backups disabled. All other DB
17
17
  * instance attributes (including DB security groups and DB parameter groups) are inherited
18
18
  * from the source DB instance, except as specified.</p>
@@ -7,7 +7,7 @@ export interface CreateEventSubscriptionCommandInput extends CreateEventSubscrip
7
7
  export interface CreateEventSubscriptionCommandOutput extends CreateEventSubscriptionResult, __MetadataBearer {
8
8
  }
9
9
  /**
10
- * <p>Creates an RDS event notification subscription. This action requires a topic Amazon
10
+ * <p>Creates an RDS event notification subscription. This operation requires a topic Amazon
11
11
  * Resource Name (ARN) created by either the RDS console, the SNS console, or the SNS API.
12
12
  * To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the
13
13
  * topic. The ARN is displayed in the SNS console.</p>
@@ -18,7 +18,7 @@ export interface CreateGlobalClusterCommandOutput extends CreateGlobalClusterRes
18
18
  * Or you can specify an existing Aurora cluster during the create operation,
19
19
  * and this cluster becomes the primary cluster of the global database.</p>
20
20
  * <note>
21
- * <p>This action only applies to Aurora DB clusters.</p>
21
+ * <p>This action applies only to Aurora DB clusters.</p>
22
22
  * </note>
23
23
  * @example
24
24
  * Use a bare-bones client and the command you need to make an API call.
@@ -10,6 +10,8 @@ export interface DescribeEventsCommandOutput extends EventsMessage, __MetadataBe
10
10
  * <p>Returns events related to DB instances, DB clusters, DB parameter groups, DB security groups, DB snapshots, DB cluster snapshots, and RDS Proxies for the past 14 days.
11
11
  * Events specific to a particular DB instance, DB cluster, DB parameter group, DB security group, DB snapshot, DB cluster snapshot group, or RDS Proxy can be
12
12
  * obtained by providing the name as a parameter.</p>
13
+ * <p>For more information on working with events, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/working-with-events.html">Monitoring Amazon RDS events</a> in the <i>Amazon RDS User Guide</i> and <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/working-with-events.html">Monitoring Amazon Aurora
14
+ * events</a> in the <i>Amazon Aurora User Guide</i>.</p>
13
15
  * <note>
14
16
  * <p>By default, RDS returns events that were generated in the past hour.</p>
15
17
  * </note>
@@ -13,7 +13,7 @@ export interface FailoverDBClusterCommandOutput extends FailoverDBClusterResult,
13
13
  * <p>For a Multi-AZ DB cluster, failover for a DB cluster promotes one of the readable standby DB instances (read-only instances)
14
14
  * in the DB cluster to be the primary DB instance (the cluster writer).</p>
15
15
  * <p>An Amazon Aurora DB cluster automatically fails over to an Aurora Replica, if one exists,
16
- * when the primary DB instance fails. A Multi-AZ DB cluster automatically fails over to a readbable standby
16
+ * when the primary DB instance fails. A Multi-AZ DB cluster automatically fails over to a readable standby
17
17
  * DB instance when the primary DB instance fails.</p>
18
18
  * <p>To simulate a failure of a primary instance for testing, you can force a failover.
19
19
  * Because each instance in a DB cluster has its own endpoint address, make sure to clean up and re-establish any existing
@@ -19,7 +19,7 @@ export interface ModifyDBClusterParameterGroupCommandOutput extends DBClusterPar
19
19
  * that are critical when creating the default database for a DB cluster, such as the character set
20
20
  * for the default database defined by the <code>character_set_database</code> parameter. You can use the
21
21
  * <i>Parameter Groups</i> option of the <a href="https://console.aws.amazon.com/rds/">Amazon RDS console</a> or the
22
- * <code>DescribeDBClusterParameters</code> action to verify
22
+ * <code>DescribeDBClusterParameters</code> operation to verify
23
23
  * that your DB cluster parameter group has been created or modified.</p>
24
24
  * <p>If the modified DB cluster parameter group is used by an Aurora Serverless v1 cluster, Aurora
25
25
  * applies the update immediately. The cluster restart might interrupt your workload. In that case,
@@ -24,7 +24,7 @@ export interface ModifyDBClusterSnapshotAttributeCommandOutput extends ModifyDBC
24
24
  * parameter. You can't use <code>all</code> as a value for that parameter in this
25
25
  * case.</p>
26
26
  * <p>To view which Amazon Web Services accounts have access to copy or restore a manual DB cluster
27
- * snapshot, or whether a manual DB cluster snapshot is public or private, use the <a>DescribeDBClusterSnapshotAttributes</a> API action. The accounts are
27
+ * snapshot, or whether a manual DB cluster snapshot is public or private, use the <a>DescribeDBClusterSnapshotAttributes</a> API operation. The accounts are
28
28
  * returned as values for the <code>restore</code> attribute.</p>
29
29
  * @example
30
30
  * Use a bare-bones client and the command you need to make an API call.
@@ -22,7 +22,7 @@ export interface ModifyDBSnapshotAttributeCommandOutput extends ModifyDBSnapshot
22
22
  * list of authorized Amazon Web Services account IDs for the <code>ValuesToAdd</code> parameter. You
23
23
  * can't use <code>all</code> as a value for that parameter in this case.</p>
24
24
  * <p>To view which Amazon Web Services accounts have access to copy or restore a manual DB snapshot, or
25
- * whether a manual DB snapshot public or private, use the <a>DescribeDBSnapshotAttributes</a> API action. The accounts are returned as
25
+ * whether a manual DB snapshot public or private, use the <a>DescribeDBSnapshotAttributes</a> API operation. The accounts are returned as
26
26
  * values for the <code>restore</code> attribute.</p>
27
27
  * @example
28
28
  * Use a bare-bones client and the command you need to make an API call.
@@ -16,6 +16,7 @@ export interface RebootDBInstanceCommandOutput extends RebootDBInstanceResult, _
16
16
  * <p>For more information about rebooting, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_RebootInstance.html">Rebooting a DB Instance</a> in the <i>Amazon RDS User Guide.</i>
17
17
  * </p>
18
18
  * <p>This command doesn't apply to RDS Custom.</p>
19
+ * <p>If your DB instance is part of a Multi-AZ DB cluster, you can reboot the DB cluster with the <code>RebootDBCluster</code> operation.</p>
19
20
  * @example
20
21
  * Use a bare-bones client and the command you need to make an API call.
21
22
  * ```javascript
@@ -8,7 +8,7 @@ export interface StopDBInstanceAutomatedBackupsReplicationCommandOutput extends
8
8
  }
9
9
  /**
10
10
  * <p>Stops automated backup replication for a DB instance.</p>
11
- * <p>This command doesn't apply to RDS Custom.</p>
11
+ * <p>This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora PostgreSQL.</p>
12
12
  * <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html">
13
13
  * Replicating Automated Backups to Another Amazon Web Services Region</a> in the <i>Amazon RDS User Guide.</i>
14
14
  * </p>