docs(client-rds): Adds support for additional retention periods to Performance Insights.

awstools · awstools · commit 8ca8d965c526 · 2022-07-01T19:37:44.000Z
diff --git a/clients/client-rds/src/RDS.ts b/clients/client-rds/src/RDS.ts
diff --git a/clients/client-rds/src/commands/BacktrackDBClusterCommand.ts b/clients/client-rds/src/commands/BacktrackDBClusterCommand.ts
@@ -29,7 +29,7 @@ export interface BacktrackDBClusterCommandOutput extends DBClusterBacktrack, __M
  *                 Backtracking an Aurora DB Cluster</a> in the
  *             <i>Amazon Aurora User Guide</i>.</p>
  *         <note>
- *             <p>This action only applies to Aurora MySQL DB clusters.</p>
+ *             <p>This action applies only to Aurora MySQL DB clusters.</p>
  *         </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-rds/src/commands/CopyDBClusterSnapshotCommand.ts b/clients/client-rds/src/commands/CopyDBClusterSnapshotCommand.ts
@@ -27,9 +27,11 @@ export interface CopyDBClusterSnapshotCommandOutput extends CopyDBClusterSnapsho
  * <p>Copies a snapshot of a DB cluster.</p>
  *         <p>To copy a DB cluster snapshot from a shared manual DB cluster snapshot, <code>SourceDBClusterSnapshotIdentifier</code>
  *           must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.</p>
- *         <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
- *           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,
- *           you must provide the following values:</p>
+ *         <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> operation 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, you must provide the
+ *             following values:</p>
  *         <ul>
  *             <li>
  *                 <p>
@@ -38,49 +40,14 @@ export interface CopyDBClusterSnapshotCommandOutput extends CopyDBClusterSnapsho
  *             </li>
  *             <li>
  *                 <p>
- *                   <code>PreSignedUrl</code> -  A URL that contains a Signature Version 4 signed request for the
- *               <code>CopyDBClusterSnapshot</code> action to be called in the source Amazon Web Services Region where the DB cluster snapshot is copied from.
- *               The pre-signed URL must be a valid request for the <code>CopyDBClusterSnapshot</code> API action that can be executed in the
- *               source Amazon Web Services Region that contains the encrypted DB cluster snapshot to be copied.</p>
- *                 <p>The pre-signed URL request must contain the following parameter values:</p>
- *                 <ul>
- *                   <li>
- *                         <p>
- *                         <code>KmsKeyId</code> - The Amazon Web Services KMS key identifier for the KMS key to use to encrypt the copy of the DB
- *                       cluster snapshot in the destination Amazon Web Services Region. This is the same identifier for both the <code>CopyDBClusterSnapshot</code>
- *                       action that is called in the destination Amazon Web Services Region, and the action contained in the pre-signed URL.</p>
- *                     </li>
- *                   <li>
- *                         <p>
- *                         <code>DestinationRegion</code> - The name of the Amazon Web Services Region that the DB cluster snapshot is to be created in.</p>
- *                     </li>
- *                   <li>
- *                         <p>
- *                         <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB cluster
- *                       snapshot to be copied. This identifier must be in the Amazon Resource Name (ARN) format for the source Amazon Web Services Region. For example,
- *                       if you are copying an encrypted DB cluster snapshot from the us-west-2 Amazon Web Services Region, then your <code>SourceDBClusterSnapshotIdentifier</code>
- *                       looks like the following example: <code>arn:aws:rds:us-west-2:123456789012:cluster-snapshot:aurora-cluster1-snapshot-20161115</code>.</p>
- *                     </li>
- *                </ul>
- *                 <p>To learn how to generate a Signature Version 4 signed request, see
- *                   <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
- *                   <a href="https://docs.aws.amazon.com/general/latest/gr/signature-version-4.html">
- *                       Signature Version 4 Signing Process</a>.</p>
- *                 <note>
- *                     <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)
- *                       instead of specifying <code>PreSignedUrl</code> manually. Specifying <code>SourceRegion</code> autogenerates a pre-signed URL that is a valid
- *                       request for the operation that can be executed in the source Amazon Web Services Region.</p>
- *                 </note>
- *             </li>
- *             <li>
- *                 <p>
  *                   <code>TargetDBClusterSnapshotIdentifier</code> - The identifier for the new copy of the DB cluster snapshot in the destination Amazon Web Services Region.</p>
  *             </li>
  *             <li>
  *                 <p>
- *                   <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot identifier for the encrypted DB cluster snapshot to be copied.
- *               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>
+ *                   <code>SourceDBClusterSnapshotIdentifier</code> - The DB cluster snapshot
+ *                     identifier for the encrypted DB cluster snapshot to be copied. 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 presigned URL.</p>
  *             </li>
  *          </ul>
  *         <p>To cancel the copy operation once it is in progress, delete the target DB cluster snapshot identified
diff --git a/clients/client-rds/src/commands/CopyDBSnapshotCommand.ts b/clients/client-rds/src/commands/CopyDBSnapshotCommand.ts
@@ -25,9 +25,9 @@ export interface CopyDBSnapshotCommandOutput extends CopyDBSnapshotResult, __Met
 
 /**
  * <p>Copies the specified DB snapshot. The source DB snapshot must be in the <code>available</code> state.</p>
- *         <p>You can copy a snapshot from one Amazon Web Services Region to another. In that case, the Amazon Web Services Region
- *             where you call the <code>CopyDBSnapshot</code> action is the destination Amazon Web Services Region for the
- *             DB snapshot copy.</p>
+ *         <p>You can copy a snapshot from one Amazon Web Services Region to another. In that case, the
+ *             Amazon Web Services Region where you call the <code>CopyDBSnapshot</code> operation is the destination
+ *             Amazon Web Services Region for the DB snapshot copy.</p>
  *         <p>This command doesn't apply to RDS Custom.</p>
  *         <p>For more information about copying snapshots, see
  *             <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>
diff --git a/clients/client-rds/src/commands/CreateDBClusterCommand.ts b/clients/client-rds/src/commands/CreateDBClusterCommand.ts
@@ -27,9 +27,7 @@ export interface CreateDBClusterCommandOutput extends CreateDBClusterResult, __M
  * <p>Creates a new Amazon Aurora DB cluster or Multi-AZ DB cluster.</p>
  *         <p>You can use the <code>ReplicationSourceIdentifier</code> parameter to create an Amazon
  *             Aurora DB cluster as a read replica of another DB cluster or Amazon RDS MySQL or
- *             PostgreSQL DB instance. For cross-Region replication where the DB cluster identified by
- *                 <code>ReplicationSourceIdentifier</code> is encrypted, also specify the
- *                 <code>PreSignedUrl</code> parameter.</p>
+ *             PostgreSQL DB instance.</p>
  *         <p>For more information on Amazon Aurora, see
  *           <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html">
  *               What is Amazon Aurora?</a> in the <i>Amazon Aurora User Guide</i>.</p>
diff --git a/clients/client-rds/src/commands/CreateDBClusterEndpointCommand.ts b/clients/client-rds/src/commands/CreateDBClusterEndpointCommand.ts
@@ -25,7 +25,7 @@ export interface CreateDBClusterEndpointCommandOutput extends DBClusterEndpoint,
 /**
  * <p>Creates a new custom endpoint and associates it with an Amazon Aurora DB cluster.</p>
  *         <note>
- *             <p>This action only applies to Aurora DB clusters.</p>
+ *             <p>This action applies only to Aurora DB clusters.</p>
  *         </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-rds/src/commands/CreateDBClusterParameterGroupCommand.ts b/clients/client-rds/src/commands/CreateDBClusterParameterGroupCommand.ts
@@ -39,15 +39,15 @@ export interface CreateDBClusterParameterGroupCommandOutput
  *           cluster without failover for the new DB cluster parameter group and associated settings to take effect.</p>
  *         <important>
  *             <p>After you create a DB cluster parameter group, you should wait at least 5 minutes
- *                 before creating your first DB cluster
- *                 that uses that DB cluster parameter group as the default parameter
- *                 group. This allows Amazon RDS to fully complete the create action before the DB cluster parameter
- *                 group is used as the default for a new DB cluster. This is especially important for parameters
- *                 that are critical when creating the default database for a DB cluster, such as the character set
- *                 for the default database defined by the <code>character_set_database</code> parameter. You can use the
- *                 <i>Parameter Groups</i> option of the <a href="https://console.aws.amazon.com/rds/">Amazon RDS console</a> or the
- *                 <code>DescribeDBClusterParameters</code> action to verify
- *                 that your DB cluster parameter group has been created or modified.</p>
+ *                 before creating your first DB cluster that uses that DB cluster parameter group as
+ *                 the default parameter group. This allows Amazon RDS to fully complete the create
+ *                 action before the DB cluster parameter group is used as the default for a new DB
+ *                 cluster. This is especially important for parameters that are critical when creating
+ *                 the default database for a DB cluster, such as the character set for the default
+ *                 database defined by the <code>character_set_database</code> parameter. You can use
+ *                 the <i>Parameter Groups</i> option of the <a href="https://console.aws.amazon.com/rds/">Amazon RDS console</a> or the
+ *                     <code>DescribeDBClusterParameters</code> operation to verify that your DB
+ *                 cluster parameter group has been created or modified.</p>
  *         </important>
  *         <p>For more information on Amazon Aurora, see
  *           <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/CHAP_AuroraOverview.html">
diff --git a/clients/client-rds/src/commands/CreateDBInstanceCommand.ts b/clients/client-rds/src/commands/CreateDBInstanceCommand.ts
@@ -24,6 +24,14 @@ export interface CreateDBInstanceCommandOutput extends CreateDBInstanceResult, _
 
 /**
  * <p>Creates a new DB instance.</p>
+ *         <p>The new DB instance can be an RDS DB instance, or it can be a DB instance in an Aurora DB cluster.
+ *            For an Aurora DB cluster, you can call this operation multiple times to add more than one DB instance
+ *            to the cluster.</p>
+ *         <p>For more information about creating an RDS DB instance, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_CreateDBInstance.html">
+ *             Creating an Amazon RDS DB instance</a> in the <i>Amazon RDS User Guide</i>.</p>
+ *         <p>For more information about creating a DB instance in an Aurora DB cluster, see
+ *             <a href="https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.CreateInstance.html">
+ *             Creating an Amazon Aurora DB cluster</a> in the <i>Amazon Aurora User Guide</i>.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
  * ```javascript
diff --git a/clients/client-rds/src/commands/CreateDBInstanceReadReplicaCommand.ts b/clients/client-rds/src/commands/CreateDBInstanceReadReplicaCommand.ts
@@ -28,8 +28,8 @@ export interface CreateDBInstanceReadReplicaCommandOutput extends CreateDBInstan
  *             instance. You can create a read replica for a DB instance running MySQL, MariaDB,
  *             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
  *                 Replicas</a> in the <i>Amazon RDS User Guide</i>.</p>
- *         <p>Amazon Aurora doesn't support this action. Call the <code>CreateDBInstance</code>
- *             action to create a DB instance for an Aurora DB cluster.</p>
+ *         <p>Amazon Aurora doesn't support this operation. Call the <code>CreateDBInstance</code>
+ *             operation to create a DB instance for an Aurora DB cluster.</p>
  *         <p>All read replica DB instances are created with backups disabled. All other DB
  *             instance attributes (including DB security groups and DB parameter groups) are inherited
  *             from the source DB instance, except as specified.</p>
diff --git a/clients/client-rds/src/commands/CreateEventSubscriptionCommand.ts b/clients/client-rds/src/commands/CreateEventSubscriptionCommand.ts
@@ -23,7 +23,7 @@ export interface CreateEventSubscriptionCommandInput extends CreateEventSubscrip
 export interface CreateEventSubscriptionCommandOutput extends CreateEventSubscriptionResult, __MetadataBearer {}
 
 /**
- * <p>Creates an RDS event notification subscription. This action requires a topic Amazon
+ * <p>Creates an RDS event notification subscription. This operation requires a topic Amazon
  *             Resource Name (ARN) created by either the RDS console, the SNS console, or the SNS API.
  *             To obtain an ARN with SNS, you must create a topic in Amazon SNS and subscribe to the
  *             topic. The ARN is displayed in the SNS console.</p>
diff --git a/clients/client-rds/src/commands/CreateGlobalClusterCommand.ts b/clients/client-rds/src/commands/CreateGlobalClusterCommand.ts
@@ -34,7 +34,7 @@ export interface CreateGlobalClusterCommandOutput extends CreateGlobalClusterRes
  *         Or you can specify an existing Aurora cluster during the create operation,
  *         and this cluster becomes the primary cluster of the global database.</p>
  *         <note>
- *             <p>This action only applies to Aurora DB clusters.</p>
+ *             <p>This action applies only to Aurora DB clusters.</p>
  *         </note>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-rds/src/commands/DescribeEventsCommand.ts b/clients/client-rds/src/commands/DescribeEventsCommand.ts
@@ -26,6 +26,8 @@ export interface DescribeEventsCommandOutput extends EventsMessage, __MetadataBe
  * <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.
  *           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
  *           obtained by providing the name as a parameter.</p>
+ *         <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
+ *                 events</a> in the <i>Amazon Aurora User Guide</i>.</p>
  *         <note>
  *             <p>By default, RDS returns events that were generated in the past hour.</p>
  *         </note>
diff --git a/clients/client-rds/src/commands/FailoverDBClusterCommand.ts b/clients/client-rds/src/commands/FailoverDBClusterCommand.ts
@@ -29,7 +29,7 @@ export interface FailoverDBClusterCommandOutput extends FailoverDBClusterResult,
  *         <p>For a Multi-AZ DB cluster, failover for a DB cluster promotes one of the readable standby DB instances (read-only instances)
  *           in the DB cluster to be the primary DB instance (the cluster writer).</p>
  *         <p>An Amazon Aurora DB cluster automatically fails over to an Aurora Replica, if one exists,
- *           when the primary DB instance fails. A Multi-AZ DB cluster automatically fails over to a readbable standby
+ *           when the primary DB instance fails. A Multi-AZ DB cluster automatically fails over to a readable standby
  *           DB instance when the primary DB instance fails.</p>
  *         <p>To simulate a failure of a primary instance for testing, you can force a failover.
  *           Because each instance in a DB cluster has its own endpoint address, make sure to clean up and re-establish any existing
diff --git a/clients/client-rds/src/commands/ModifyDBClusterParameterGroupCommand.ts b/clients/client-rds/src/commands/ModifyDBClusterParameterGroupCommand.ts
@@ -37,7 +37,7 @@ export interface ModifyDBClusterParameterGroupCommandOutput
  *                 that are critical when creating the default database for a DB cluster, such as the character set
  *                 for the default database defined by the <code>character_set_database</code> parameter. You can use the
  *                 <i>Parameter Groups</i> option of the <a href="https://console.aws.amazon.com/rds/">Amazon RDS console</a> or the
- *                 <code>DescribeDBClusterParameters</code> action to verify
+ *                 <code>DescribeDBClusterParameters</code> operation to verify
  *                 that your DB cluster parameter group has been created or modified.</p>
  *             <p>If the modified DB cluster parameter group is used by an Aurora Serverless v1 cluster, Aurora
  *                applies the update immediately. The cluster restart might interrupt your workload. In that case,
diff --git a/clients/client-rds/src/commands/ModifyDBClusterSnapshotAttributeCommand.ts b/clients/client-rds/src/commands/ModifyDBClusterSnapshotAttributeCommand.ts
@@ -42,7 +42,7 @@ export interface ModifyDBClusterSnapshotAttributeCommandOutput
  *             parameter. You can't use <code>all</code> as a value for that parameter in this
  *             case.</p>
  *         <p>To view which Amazon Web Services accounts have access to copy or restore a manual DB cluster
- *             snapshot, or whether a manual DB cluster snapshot is public or private, use the <a>DescribeDBClusterSnapshotAttributes</a> API action. The accounts are
+ *             snapshot, or whether a manual DB cluster snapshot is public or private, use the <a>DescribeDBClusterSnapshotAttributes</a> API operation. The accounts are
  *             returned as values for the <code>restore</code> attribute.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-rds/src/commands/ModifyDBSnapshotAttributeCommand.ts b/clients/client-rds/src/commands/ModifyDBSnapshotAttributeCommand.ts
@@ -38,7 +38,7 @@ export interface ModifyDBSnapshotAttributeCommandOutput extends ModifyDBSnapshot
  *             list of authorized Amazon Web Services account IDs for the <code>ValuesToAdd</code> parameter. You
  *             can't use <code>all</code> as a value for that parameter in this case.</p>
  *         <p>To view which Amazon Web Services accounts have access to copy or restore a manual DB snapshot, or
- *             whether a manual DB snapshot public or private, use the <a>DescribeDBSnapshotAttributes</a> API action. The accounts are returned as
+ *             whether a manual DB snapshot public or private, use the <a>DescribeDBSnapshotAttributes</a> API operation. The accounts are returned as
  *             values for the <code>restore</code> attribute.</p>
  * @example
  * Use a bare-bones client and the command you need to make an API call.
diff --git a/clients/client-rds/src/commands/StopDBInstanceAutomatedBackupsReplicationCommand.ts b/clients/client-rds/src/commands/StopDBInstanceAutomatedBackupsReplicationCommand.ts
@@ -30,7 +30,7 @@ export interface StopDBInstanceAutomatedBackupsReplicationCommandOutput
 
 /**
  * <p>Stops automated backup replication for a DB instance.</p>
- *         <p>This command doesn't apply to RDS Custom.</p>
+ *         <p>This command doesn't apply to RDS Custom, Aurora MySQL, and Aurora PostgreSQL.</p>
  *         <p>For more information, see <a href="https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_ReplicateBackups.html">
  *             Replicating Automated Backups to Another Amazon Web Services Region</a> in the <i>Amazon RDS User Guide.</i>
  *          </p>
diff --git a/clients/client-rds/src/models/models_0.ts b/clients/client-rds/src/models/models_0.ts
diff --git a/clients/client-rds/src/models/models_1.ts b/clients/client-rds/src/models/models_1.ts
diff --git a/codegen/sdk-codegen/aws-models/rds.json b/codegen/sdk-codegen/aws-models/rds.json
