@aws-sdk/client-rds 3.306.0 → 3.309.0

package/dist-types/commands/ModifyDBSnapshotAttributeCommand.d.ts

@@ -73,24 +73,66 @@ export interface ModifyDBSnapshotAttributeCommandOutput extends ModifyDBSnapshot
  *  <p>You have exceeded the maximum number of accounts that you can share a manual DB snapshot with.</p>
  *
  *
- * @example To change DB snapshot attributes
+ * @example To allow two AWS accounts to restore a DB snapshot
  * ```javascript
- * // This example adds the specified attribute for the specified DB snapshot.
+ * // The following example grants permission to two AWS accounts, with the identifiers 111122223333 and 444455556666, to restore the DB snapshot named mydbsnapshot.
  * const input = {
  *   "AttributeName": "restore",
  *   "DBSnapshotIdentifier": "mydbsnapshot",
  *   "ValuesToAdd": [
- *     "all"
+ *     "111122223333",
+ *     "444455556666"
  *   ]
  * };
  * const command = new ModifyDBSnapshotAttributeCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "DBSnapshotAttributesResult": {}
+ *   "DBSnapshotAttributesResult": {
+ *     "DBSnapshotAttributes": [
+ *       {
+ *         "AttributeName": "restore",
+ *         "AttributeValues": [
+ *           "111122223333",
+ *           "444455556666"
+ *         ]
+ *       }
+ *     ],
+ *     "DBSnapshotIdentifier": "mydbsnapshot"
+ *   }
  * }
  * *\/
- * // example id: modify-db-snapshot-attribute-2e66f120-2b21-4a7c-890b-4474da88bde6
+ * // example id: to-allow-two-aws-accounts-to-restore-a-db-snapshot-1680389647513
+ * ```
+ *
+ * @example To prevent an AWS account from restoring a DB snapshot
+ * ```javascript
+ * // The following example removes permission from the AWS account with the identifier 444455556666 to restore the DB snapshot named mydbsnapshot.
+ * const input = {
+ *   "AttributeName": "restore",
+ *   "DBSnapshotIdentifier": "mydbsnapshot",
+ *   "ValuesToRemove": [
+ *     "444455556666"
+ *   ]
+ * };
+ * const command = new ModifyDBSnapshotAttributeCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DBSnapshotAttributesResult": {
+ *     "DBSnapshotAttributes": [
+ *       {
+ *         "AttributeName": "restore",
+ *         "AttributeValues": [
+ *           "111122223333"
+ *         ]
+ *       }
+ *     ],
+ *     "DBSnapshotIdentifier": "mydbsnapshot"
+ *   }
+ * }
+ * *\/
+ * // example id: to-prevent-an-aws-account-from-restoring-a-db-snapshot-1680389850879
  * ```
  *
  */

package/dist-types/commands/ModifyDBSnapshotCommand.d.ts

@@ -51,6 +51,46 @@ export interface ModifyDBSnapshotCommandOutput extends ModifyDBSnapshotResult, _
  *             <code>DBSnapshotIdentifier</code> doesn't refer to an existing DB snapshot.</p>
  *
  *
+ * @example To modify a DB snapshot
+ * ```javascript
+ * // The following example upgrades a PostgeSQL 10.6 snapshot named db5-snapshot-upg-test to PostgreSQL 11.7. The new DB engine version is shown after the snapshot has finished upgrading and its status is available.
+ * const input = {
+ *   "DBSnapshotIdentifier": "db5-snapshot-upg-test",
+ *   "EngineVersion": "11.7"
+ * };
+ * const command = new ModifyDBSnapshotCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DBSnapshot": {
+ *     "AllocatedStorage": 20,
+ *     "AvailabilityZone": "us-west-2a",
+ *     "DBInstanceIdentifier": "database-5",
+ *     "DBSnapshotArn": "arn:aws:rds:us-west-2:123456789012:snapshot:db5-snapshot-upg-test",
+ *     "DBSnapshotIdentifier": "db5-snapshot-upg-test",
+ *     "DbiResourceId": "db-GJMF75LM42IL6BTFRE4UZJ5YM4",
+ *     "Encrypted": false,
+ *     "Engine": "postgres",
+ *     "EngineVersion": "10.6",
+ *     "IAMDatabaseAuthenticationEnabled": false,
+ *     "InstanceCreateTime": "2020-03-27T19:59:04.735Z",
+ *     "LicenseModel": "postgresql-license",
+ *     "MasterUsername": "postgres",
+ *     "OptionGroupName": "default:postgres-11",
+ *     "PercentProgress": 100,
+ *     "Port": 5432,
+ *     "ProcessorFeatures": [],
+ *     "SnapshotCreateTime": "2020-03-27T20:49:17.092Z",
+ *     "SnapshotType": "manual",
+ *     "Status": "upgrading",
+ *     "StorageType": "gp2",
+ *     "VpcId": "vpc-2ff27557"
+ *   }
+ * }
+ * *\/
+ * // example id: to-modify-a-db-snapshot-1680381968028
+ * ```
+ *
  */
 export declare class ModifyDBSnapshotCommand extends $Command<ModifyDBSnapshotCommandInput, ModifyDBSnapshotCommandOutput, RDSClientResolvedConfig> {
     readonly input: ModifyDBSnapshotCommandInput;

package/dist-types/commands/ModifyDBSubnetGroupCommand.d.ts

@@ -61,24 +61,63 @@ export interface ModifyDBSubnetGroupCommandOutput extends ModifyDBSubnetGroupRes
  *  <p>The DB subnet is already in use in the Availability Zone.</p>
  *
  *
- * @example To change DB subnet group settings
+ * @example To modify a DB subnet group
  * ```javascript
- * // This example changes the specified setting for the specified DB subnet group.
+ * // The following example adds a subnet with the ID subnet-08e41f9e230222222 to the DB subnet group named mysubnetgroup. To keep the existing subnets in the subnet group, include their IDs as values in the --subnet-ids option. Make sure to have subnets with at least two different Availability Zones in the DB subnet group.
  * const input = {
- *   "DBSubnetGroupName": "mydbsubnetgroup",
+ *   "DBSubnetGroupDescription": "",
+ *   "DBSubnetGroupName": "mysubnetgroup",
  *   "SubnetIds": [
- *     "subnet-70e1975a",
- *     "subnet-747a5c49"
+ *     "subnet-0a1dc4e1a6f123456",
+ *     "subnet-070dd7ecb3aaaaaaa",
+ *     "subnet-00f5b198bc0abcdef",
+ *     "subnet-08e41f9e230222222"
  *   ]
  * };
  * const command = new ModifyDBSubnetGroupCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "DBSubnetGroup": {}
+ *   "DBSubnetGroup": {
+ *     "DBSubnetGroupArn": "arn:aws:rds:us-west-2:123456789012:subgrp:mysubnetgroup",
+ *     "DBSubnetGroupDescription": "test DB subnet group",
+ *     "DBSubnetGroupName": "mysubnetgroup",
+ *     "SubnetGroupStatus": "Complete",
+ *     "Subnets": [
+ *       {
+ *         "SubnetAvailabilityZone": {
+ *           "Name": "us-west-2a"
+ *         },
+ *         "SubnetIdentifier": "subnet-08e41f9e230222222",
+ *         "SubnetStatus": "Active"
+ *       },
+ *       {
+ *         "SubnetAvailabilityZone": {
+ *           "Name": "us-west-2b"
+ *         },
+ *         "SubnetIdentifier": "subnet-070dd7ecb3aaaaaaa",
+ *         "SubnetStatus": "Active"
+ *       },
+ *       {
+ *         "SubnetAvailabilityZone": {
+ *           "Name": "us-west-2d"
+ *         },
+ *         "SubnetIdentifier": "subnet-00f5b198bc0abcdef",
+ *         "SubnetStatus": "Active"
+ *       },
+ *       {
+ *         "SubnetAvailabilityZone": {
+ *           "Name": "us-west-2b"
+ *         },
+ *         "SubnetIdentifier": "subnet-0a1dc4e1a6f123456",
+ *         "SubnetStatus": "Active"
+ *       }
+ *     ],
+ *     "VpcId": "vpc-0f08e7610a1b2c3d4"
+ *   }
  * }
  * *\/
- * // example id: modify-db-subnet-group-e34a97d9-8fe6-4239-a4ed-ad6e73a956b0
+ * // example id: to-modify-a-db-subnet-group-1680383300785
  * ```
  *
  */

package/dist-types/commands/ModifyEventSubscriptionCommand.d.ts

@@ -68,26 +68,34 @@ export interface ModifyEventSubscriptionCommandOutput extends ModifyEventSubscri
  *  <p>The subscription name does not exist.</p>
  *
  *
- * @example To change event notification subscription settings
+ * @example To modify an event subscription
  * ```javascript
- * // This example changes the specified setting for the specified event notification subscription.
+ * // The following example turns off the specified event subscription, so that it no longer publishes notifications to the specified Amazon Simple Notification Service topic.
  * const input = {
- *   "Enabled": true,
- *   "EventCategories": [
- *     "deletion",
- *     "low storage"
- *   ],
- *   "SourceType": "db-instance",
- *   "SubscriptionName": "mymysqleventsubscription"
+ *   "Enabled": false,
+ *   "SubscriptionName": "my-instance-events"
  * };
  * const command = new ModifyEventSubscriptionCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "EventSubscription": {}
+ *   "EventSubscription": {
+ *     "CustSubscriptionId": "my-instance-events",
+ *     "CustomerAwsId": "123456789012",
+ *     "Enabled": false,
+ *     "EventCategoriesList": [
+ *       "backup",
+ *       "recovery"
+ *     ],
+ *     "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
+ *     "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
+ *     "SourceType": "db-instance",
+ *     "Status": "modifying",
+ *     "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018"
+ *   }
  * }
  * *\/
- * // example id: modify-event-subscription-405ac869-1f02-42cd-b8f4-6950a435f30e
+ * // example id: to-modify-an-event-subscription-1680383930434
  * ```
  *
  */

package/dist-types/commands/ModifyGlobalClusterCommand.d.ts

@@ -62,6 +62,33 @@ export interface ModifyGlobalClusterCommandOutput extends ModifyGlobalClusterRes
  *  <p>The global cluster is in an invalid state and can't perform the requested operation.</p>
  *
  *
+ * @example To modify a global database cluster
+ * ```javascript
+ * // The following example enables deletion protection for an Aurora MySQL-based global database cluster.
+ * const input = {
+ *   "DeletionProtection": true,
+ *   "GlobalClusterIdentifier": "myglobalcluster"
+ * };
+ * const command = new ModifyGlobalClusterCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "GlobalCluster": {
+ *     "DeletionProtection": true,
+ *     "Engine": "aurora-mysql",
+ *     "EngineVersion": "5.7.mysql_aurora.2.07.2",
+ *     "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
+ *     "GlobalClusterIdentifier": "myglobalcluster",
+ *     "GlobalClusterMembers": [],
+ *     "GlobalClusterResourceId": "cluster-f0e523bfe07aabb",
+ *     "Status": "available",
+ *     "StorageEncrypted": false
+ *   }
+ * }
+ * *\/
+ * // example id: to-modify-a-global-database-cluster-1680385137511
+ * ```
+ *
  */
 export declare class ModifyGlobalClusterCommand extends $Command<ModifyGlobalClusterCommandInput, ModifyGlobalClusterCommandOutput, RDSClientResolvedConfig> {
     readonly input: ModifyGlobalClusterCommandInput;

package/dist-types/commands/PromoteReadReplicaCommand.d.ts

@@ -68,20 +68,23 @@ export interface PromoteReadReplicaCommandOutput extends PromoteReadReplicaResul
  *
  * @example To promote a read replica
  * ```javascript
- * // This example promotes the specified read replica and sets its backup retention period and preferred backup window.
+ * // The following example promotes the specified read replica to become a standalone DB instance.
  * const input = {
- *   "BackupRetentionPeriod": 1,
- *   "DBInstanceIdentifier": "mydbreadreplica",
- *   "PreferredBackupWindow": "03:30-04:00"
+ *   "DBInstanceIdentifier": "test-instance-repl"
  * };
  * const command = new PromoteReadReplicaCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "DBInstance": {}
+ *   "DBInstance": {
+ *     "DBInstanceArn": "arn:aws:rds:us-east-1:123456789012:db:test-instance-repl",
+ *     "DBInstanceStatus": "modifying",
+ *     "ReadReplicaSourceDBInstanceIdentifier": "test-instance",
+ *     "StorageType": "standard"
+ *   }
  * }
  * *\/
- * // example id: promote-read-replica-cc580039-c55d-4035-838a-def4a1ae4181
+ * // example id: to-promote-a-read-replica-1680263877808
  * ```
  *
  */

package/dist-types/commands/PurchaseReservedDBInstancesOfferingCommand.d.ts

@@ -57,21 +57,42 @@ export interface PurchaseReservedDBInstancesOfferingCommandOutput extends Purcha
  *  <p>Specified offering does not exist.</p>
  *
  *
- * @example To purchase a reserved DB instance offering
+ * @example To purchase a reserved DB instance
  * ```javascript
- * // This example purchases a reserved DB instance offering that matches the specified settings.
+ * // The following example shows how to buy the reserved DB instance offering from the previous example.
  * const input = {
- *   "ReservedDBInstanceId": "myreservationid",
- *   "ReservedDBInstancesOfferingId": "fb29428a-646d-4390-850e-5fe89926e727"
+ *   "ReservedDBInstanceId": "8ba30be1-b9ec-447f-8f23-6114e3f4c7b4",
+ *   "ReservedDBInstancesOfferingId": ""
  * };
  * const command = new PurchaseReservedDBInstancesOfferingCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "ReservedDBInstance": {}
+ *   "ReservedDBInstance": {
+ *     "CurrencyCode": "USD",
+ *     "DBInstanceClass": "db.t2.micro",
+ *     "DBInstanceCount": 1,
+ *     "Duration": 31536000,
+ *     "FixedPrice": 51,
+ *     "MultiAZ": false,
+ *     "OfferingType": "Partial Upfront",
+ *     "ProductDescription": "mysql",
+ *     "RecurringCharges": [
+ *       {
+ *         "RecurringChargeAmount": 0.006,
+ *         "RecurringChargeFrequency": "Hourly"
+ *       }
+ *     ],
+ *     "ReservedDBInstanceArn": "arn:aws:rds:us-west-2:123456789012:ri:ri-2020-06-29-16-54-57-670",
+ *     "ReservedDBInstanceId": "ri-2020-06-29-16-54-57-670",
+ *     "ReservedDBInstancesOfferingId": "8ba30be1-b9ec-447f-8f23-6114e3f4c7b4",
+ *     "StartTime": "2020-06-29T16:54:57.670Z",
+ *     "State": "payment-pending",
+ *     "UsagePrice": 0
+ *   }
  * }
  * *\/
- * // example id: purchase-reserved-db-instances-offfering-f423c736-8413-429b-ba13-850fd4fa4dcd
+ * // example id: to-purchase-a-reserved-db-instance-1680263732858
  * ```
  *
  */

package/dist-types/commands/RebootDBInstanceCommand.d.ts

@@ -59,19 +59,29 @@ export interface RebootDBInstanceCommandOutput extends RebootDBInstanceResult, _
  *
  * @example To reboot a DB instance
  * ```javascript
- * // This example reboots the specified DB instance without forcing a failover.
+ * // The following example starts a reboot of the specified DB instance.
  * const input = {
- *   "DBInstanceIdentifier": "mymysqlinstance",
- *   "ForceFailover": false
+ *   "DBInstanceIdentifier": "test-mysql-instance"
  * };
  * const command = new RebootDBInstanceCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "DBInstance": {}
+ *   "DBInstance": {
+ *     "DBInstanceClass": "db.t3.micro",
+ *     "DBInstanceIdentifier": "test-mysql-instance",
+ *     "DBInstanceStatus": "rebooting",
+ *     "Endpoint": {
+ *       "Address": "test-mysql-instance.############.us-west-2.rds.amazonaws.com",
+ *       "HostedZoneId": "Z1PVIF0EXAMPLE",
+ *       "Port": 3306
+ *     },
+ *     "Engine": "mysql",
+ *     "MasterUsername": "admin"
+ *   }
  * }
  * *\/
- * // example id: reboot-db-instance-b9ce8a0a-2920-451d-a1f3-01d288aa7366
+ * // example id: to-reboot-a-db-instance-1680072870190
  * ```
  *
  */

package/dist-types/commands/RemoveFromGlobalClusterCommand.d.ts

@@ -56,6 +56,47 @@ export interface RemoveFromGlobalClusterCommandOutput extends RemoveFromGlobalCl
  *  <p>The global cluster is in an invalid state and can't perform the requested operation.</p>
  *
  *
+ * @example To detach an Aurora secondary cluster from an Aurora global database cluster
+ * ```javascript
+ * // The following example detaches an Aurora secondary cluster from an Aurora global database cluster. The cluster changes from being read-only to a standalone cluster with read-write capability.
+ * const input = {
+ *   "DbClusterIdentifier": "arn:aws:rds:us-west-2:123456789012:cluster:DB-1",
+ *   "GlobalClusterIdentifier": "myglobalcluster"
+ * };
+ * const command = new RemoveFromGlobalClusterCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "GlobalCluster": {
+ *     "DeletionProtection": false,
+ *     "Engine": "aurora-postgresql",
+ *     "EngineVersion": "10.11",
+ *     "GlobalClusterArn": "arn:aws:rds::123456789012:global-cluster:myglobalcluster",
+ *     "GlobalClusterIdentifier": "myglobalcluster",
+ *     "GlobalClusterMembers": [
+ *       {
+ *         "DBClusterArn": "arn:aws:rds:us-east-1:123456789012:cluster:js-global-cluster",
+ *         "IsWriter": true,
+ *         "Readers": [
+ *           "arn:aws:rds:us-west-2:123456789012:cluster:DB-1"
+ *         ]
+ *       },
+ *       {
+ *         "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:DB-1",
+ *         "GlobalWriteForwardingStatus": "disabled",
+ *         "IsWriter": false,
+ *         "Readers": []
+ *       }
+ *     ],
+ *     "GlobalClusterResourceId": "cluster-abc123def456gh",
+ *     "Status": "available",
+ *     "StorageEncrypted": true
+ *   }
+ * }
+ * *\/
+ * // example id: to-detach-an-aurora-secondary-cluster-from-an-aurora-global-database-cluster-1680072605847
+ * ```
+ *
  */
 export declare class RemoveFromGlobalClusterCommand extends $Command<RemoveFromGlobalClusterCommandInput, RemoveFromGlobalClusterCommandOutput, RDSClientResolvedConfig> {
     readonly input: RemoveFromGlobalClusterCommandInput;

package/dist-types/commands/RemoveRoleFromDBClusterCommand.d.ts

@@ -60,6 +60,18 @@ export interface RemoveRoleFromDBClusterCommandOutput extends __MetadataBearer {
  *  <p>The requested operation can't be performed while the cluster is in this state.</p>
  *
  *
+ * @example To disassociate an Identity and Access Management (IAM) role from a DB cluster
+ * ```javascript
+ * // The following example removes a role from a DB cluster.
+ * const input = {
+ *   "DBClusterIdentifier": "mydbcluster",
+ *   "RoleArn": "arn:aws:iam::123456789012:role/RDSLoadFromS3"
+ * };
+ * const command = new RemoveRoleFromDBClusterCommand(input);
+ * await client.send(command);
+ * // example id: to-disassociate-an-identity-and-access-management-iam-role-from-a-db-cluster-1680072359521
+ * ```
+ *
  */
 export declare class RemoveRoleFromDBClusterCommand extends $Command<RemoveRoleFromDBClusterCommandInput, RemoveRoleFromDBClusterCommandOutput, RDSClientResolvedConfig> {
     readonly input: RemoveRoleFromDBClusterCommandInput;

package/dist-types/commands/RemoveSourceIdentifierFromSubscriptionCommand.d.ts

@@ -47,21 +47,37 @@ export interface RemoveSourceIdentifierFromSubscriptionCommandOutput extends Rem
  *  <p>The subscription name does not exist.</p>
  *
  *
- * @example To remove a source identifier from a DB event subscription
+ * @example To remove a source identifier from a subscription
  * ```javascript
- * // This example removes the specified source identifier from the specified DB event subscription.
+ * // The following example removes the specified source identifier from an existing subscription.
  * const input = {
- *   "SourceIdentifier": "mymysqlinstance",
- *   "SubscriptionName": "myeventsubscription"
+ *   "SourceIdentifier": "test-instance-repl",
+ *   "SubscriptionName": "my-instance-events"
  * };
  * const command = new RemoveSourceIdentifierFromSubscriptionCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "EventSubscription": {}
+ *   "EventSubscription": {
+ *     "CustSubscriptionId": "my-instance-events",
+ *     "CustomerAwsId": "123456789012",
+ *     "Enabled": false,
+ *     "EventCategoriesList": [
+ *       "backup",
+ *       "recovery"
+ *     ],
+ *     "EventSubscriptionArn": "arn:aws:rds:us-east-1:123456789012:es:my-instance-events",
+ *     "SnsTopicArn": "arn:aws:sns:us-east-1:123456789012:interesting-events",
+ *     "SourceIdsList": [
+ *       "test-instance"
+ *     ],
+ *     "SourceType": "db-instance",
+ *     "Status": "modifying",
+ *     "SubscriptionCreationTime": "Tue Jul 31 23:22:01 UTC 2018"
+ *   }
  * }
  * *\/
- * // example id: remove-source-identifier-from-subscription-30d25493-c19d-4cf7-b4e5-68371d0d8770
+ * // example id: to-remove-a-source-identifier-from-a-subscription-1680072062459
  * ```
  *
  */

package/dist-types/commands/RemoveTagsFromResourceCommand.d.ts

@@ -71,16 +71,17 @@ export interface RemoveTagsFromResourceCommandOutput extends __MetadataBearer {
  *
  * @example To remove tags from a resource
  * ```javascript
- * // This example removes the specified tag associated with the specified DB option group.
+ * // The following example removes tags from a resource.
  * const input = {
- *   "ResourceName": "arn:aws:rds:us-east-1:992648334831:og:mydboptiongroup",
+ *   "ResourceName": "arn:aws:rds:us-east-1:123456789012:db:mydbinstance",
  *   "TagKeys": [
- *     "MyKey"
+ *     "Name",
+ *     "Environment"
  *   ]
  * };
  * const command = new RemoveTagsFromResourceCommand(input);
  * await client.send(command);
- * // example id: remove-tags-from-resource-49f00574-38f6-4d01-ac89-d3c668449ce3
+ * // example id: to-remove-tags-from-a-resource-1680070522922
  * ```
  *
  */

package/dist-types/commands/ResetDBClusterParameterGroupCommand.d.ts

@@ -83,16 +83,21 @@ export interface ResetDBClusterParameterGroupCommandOutput extends DBClusterPara
  *             this state.</p>
  *
  *
- * @example To reset the values of a DB cluster parameter group
+ * @example To reset all parameters to their default values
  * ```javascript
- * // This example resets all parameters for the specified DB cluster parameter group to their default values.
+ * // The following example resets all parameter values in a customer-created DB cluster parameter group to their default values.
  * const input = {
- *   "DBClusterParameterGroupName": "mydbclusterparametergroup",
+ *   "DBClusterParameterGroupName": "mydbclpg",
  *   "ResetAllParameters": true
  * };
  * const command = new ResetDBClusterParameterGroupCommand(input);
- * await client.send(command);
- * // example id: reset-db-cluster-parameter-group-b04aeaf7-7f73-49e1-9bb4-857573ea3ee4
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DBClusterParameterGroupName": "mydbclpg"
+ * }
+ * *\/
+ * // example id: to-reset-all-parameters-to-their-default-values-1680070254216
  * ```
  *
  */

package/dist-types/commands/ResetDBParameterGroupCommand.d.ts

@@ -75,16 +75,21 @@ export interface ResetDBParameterGroupCommandOutput extends DBParameterGroupName
  *             this state.</p>
  *
  *
- * @example To reset the values of a DB parameter group
+ * @example To reset all parameters to their default values
  * ```javascript
- * // This example resets all parameters for the specified DB parameter group to their default values.
+ * // The following example resets all parameter values in a customer-created DB parameter group to their default values.
  * const input = {
- *   "DBParameterGroupName": "mydbparametergroup",
+ *   "DBParameterGroupName": "mypg",
  *   "ResetAllParameters": true
  * };
  * const command = new ResetDBParameterGroupCommand(input);
- * await client.send(command);
- * // example id: reset-db-parameter-group-ed2ed723-de0d-4824-8af5-3c65fa130abf
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DBParameterGroupName": "mypg"
+ * }
+ * *\/
+ * // example id: to-reset-all-parameters-to-their-default-values-1680069721142
  * ```
  *
  */

package/dist-types/commands/RestoreDBClusterFromS3Command.d.ts

@@ -158,6 +158,72 @@ export interface RestoreDBClusterFromS3CommandOutput extends RestoreDBClusterFro
  *             available across all DB instances.</p>
  *
  *
+ * @example To restore an Amazon Aurora DB cluster from Amazon S3
+ * ```javascript
+ * // The following example restores an Amazon Aurora MySQL version 5.7-compatible DB cluster from a MySQL 5.7 DB backup file in Amazon S3.
+ * const input = {
+ *   "DBClusterIdentifier": "cluster-s3-restore",
+ *   "Engine": "aurora-mysql",
+ *   "MasterUserPassword": "mypassword",
+ *   "MasterUsername": "admin",
+ *   "S3BucketName": "mybucket",
+ *   "S3IngestionRoleArn": "arn:aws:iam::123456789012:role/service-role/TestBackup",
+ *   "S3Prefix": "test-backup",
+ *   "SourceEngine": "mysql",
+ *   "SourceEngineVersion": "5.7.28"
+ * };
+ * const command = new RestoreDBClusterFromS3Command(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DBCluster": {
+ *     "AllocatedStorage": 1,
+ *     "AssociatedRoles": [],
+ *     "AvailabilityZones": [
+ *       "us-west-2c",
+ *       "us-west-2a",
+ *       "us-west-2b"
+ *     ],
+ *     "BackupRetentionPeriod": 1,
+ *     "ClusterCreateTime": "2020-07-27T14:22:08.095Z",
+ *     "CopyTagsToSnapshot": false,
+ *     "CrossAccountClone": false,
+ *     "DBClusterArn": "arn:aws:rds:us-west-2:123456789012:cluster:cluster-s3-restore",
+ *     "DBClusterIdentifier": "cluster-s3-restore",
+ *     "DBClusterMembers": [],
+ *     "DBClusterParameterGroup": "default.aurora-mysql5.7",
+ *     "DBSubnetGroup": "default",
+ *     "DbClusterResourceId": "cluster-SU5THYQQHOWCXZZDGXREXAMPLE",
+ *     "DeletionProtection": false,
+ *     "DomainMemberships": [],
+ *     "Endpoint": "cluster-s3-restore.cluster-co3xyzabc123.us-west-2.rds.amazonaws.com",
+ *     "Engine": "aurora-mysql",
+ *     "EngineMode": "provisioned",
+ *     "EngineVersion": "5.7.12",
+ *     "HostedZoneId": "Z1PVIF0EXAMPLE",
+ *     "HttpEndpointEnabled": false,
+ *     "IAMDatabaseAuthenticationEnabled": false,
+ *     "MasterUsername": "admin",
+ *     "MultiAZ": false,
+ *     "Port": 3306,
+ *     "PreferredBackupWindow": "11:15-11:45",
+ *     "PreferredMaintenanceWindow": "thu:12:19-thu:12:49",
+ *     "ReadReplicaIdentifiers": [],
+ *     "ReaderEndpoint": "cluster-s3-restore.cluster-ro-co3xyzabc123.us-west-2.rds.amazonaws.com",
+ *     "Status": "creating",
+ *     "StorageEncrypted": false,
+ *     "VpcSecurityGroups": [
+ *       {
+ *         "Status": "active",
+ *         "VpcSecurityGroupId": "sg-########"
+ *       }
+ *     ]
+ *   }
+ * }
+ * *\/
+ * // example id: to-restore-an-amazon-aurora-db-cluster-from-amazon-s3-1680069516445
+ * ```
+ *
  */
 export declare class RestoreDBClusterFromS3Command extends $Command<RestoreDBClusterFromS3CommandInput, RestoreDBClusterFromS3CommandOutput, RDSClientResolvedConfig> {
     readonly input: RestoreDBClusterFromS3CommandInput;