@aws-sdk/client-rds 3.306.0 → 3.309.0

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

@@ -59,6 +59,221 @@ export interface DescribeBlueGreenDeploymentsCommandOutput extends DescribeBlueG
  *             <code>BlueGreenDeploymentIdentifier</code> doesn't refer to an existing blue/green deployment.</p>
  *
  *
+ * @example To describe a blue/green deployment of an RDS DB instance after creation completes
+ * ```javascript
+ * // The following example retrieves the details of a blue/green deployment after creation completes.
+ * const input = {
+ *   "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake"
+ * };
+ * const command = new DescribeBlueGreenDeploymentsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "BlueGreenDeployments": [
+ *     {
+ *       "BlueGreenDeploymentIdentifier": "bgd-v53303651eexfake",
+ *       "BlueGreenDeploymentName": "bgd-cli-test-instance",
+ *       "CreateTime": "2022-02-25T21:18:51.183000+00:00",
+ *       "Source": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
+ *       "Status": "AVAILABLE",
+ *       "SwitchoverDetails": [
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance",
+ *           "Status": "AVAILABLE",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1",
+ *           "Status": "AVAILABLE",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-1-green-j382ha"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2",
+ *           "Status": "AVAILABLE",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-2-green-ejv4ao"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3",
+ *           "Status": "AVAILABLE",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-replica-3-green-vlpz3t"
+ *         }
+ *       ],
+ *       "Target": "arn:aws:rds:us-east-1:123456789012:db:my-db-instance-green-rkfbpe",
+ *       "Tasks": [
+ *         {
+ *           "Name": "CREATING_READ_REPLICA_OF_SOURCE",
+ *           "Status": "COMPLETED"
+ *         },
+ *         {
+ *           "Name": "DB_ENGINE_VERSION_UPGRADE",
+ *           "Status": "COMPLETED"
+ *         },
+ *         {
+ *           "Name": "CONFIGURE_BACKUPS",
+ *           "Status": "COMPLETED"
+ *         },
+ *         {
+ *           "Name": "CREATING_TOPOLOGY_OF_SOURCE",
+ *           "Status": "COMPLETED"
+ *         }
+ *       ]
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-a-bluegreen-deployment-of-an-rds-db-instance-after-creation-completes-1680211143527
+ * ```
+ *
+ * @example To describe a blue/green deployment for an Aurora MySQL DB cluster
+ * ```javascript
+ * // The following example retrieves the details of a blue/green deployment.
+ * const input = {
+ *   "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake"
+ * };
+ * const command = new DescribeBlueGreenDeploymentsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "BlueGreenDeployments": [
+ *     {
+ *       "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
+ *       "BlueGreenDeploymentName": "my-blue-green-deployment",
+ *       "CreateTime": "2022-02-25T21:12:00.288000+00:00",
+ *       "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
+ *       "Status": "AVAILABLE",
+ *       "SwitchoverDetails": [
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
+ *           "Status": "AVAILABLE",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1",
+ *           "Status": "AVAILABLE",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-green-gpmaxf"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2",
+ *           "Status": "AVAILABLE",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-green-j2oajq"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3",
+ *           "Status": "AVAILABLE",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-green-mkxies"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint",
+ *           "Status": "AVAILABLE",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-green-4sqjrq"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint",
+ *           "Status": "AVAILABLE",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-green-gwwzlg"
+ *         }
+ *       ],
+ *       "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-green-3rnukl",
+ *       "Tasks": [
+ *         {
+ *           "Name": "CREATING_READ_REPLICA_OF_SOURCE",
+ *           "Status": "COMPLETED"
+ *         },
+ *         {
+ *           "Name": "DB_ENGINE_VERSION_UPGRADE",
+ *           "Status": "COMPLETED"
+ *         },
+ *         {
+ *           "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
+ *           "Status": "COMPLETED"
+ *         },
+ *         {
+ *           "Name": "CREATE_CUSTOM_ENDPOINTS",
+ *           "Status": "COMPLETED"
+ *         }
+ *       ]
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-a-bluegreen-deployment-for-an-aurora-mysql-db-cluster-1680211228214
+ * ```
+ *
+ * @example To describe a blue/green deployment for an Aurora MySQL cluster after switchover
+ * ```javascript
+ * // The following example retrieves the details about a blue/green deployment after the green environment is promoted to be the production environment.
+ * const input = {
+ *   "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake"
+ * };
+ * const command = new DescribeBlueGreenDeploymentsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "BlueGreenDeployments": [
+ *     {
+ *       "BlueGreenDeploymentIdentifier": "bgd-wi89nwzglccsfake",
+ *       "BlueGreenDeploymentName": "my-blue-green-deployment",
+ *       "CreateTime": "2022-02-25T22:38:49.522000+00:00",
+ *       "Source": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-old1",
+ *       "Status": "SWITCHOVER_COMPLETED",
+ *       "SwitchoverDetails": [
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster-old1",
+ *           "Status": "SWITCHOVER_COMPLETED",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1-old1",
+ *           "Status": "SWITCHOVER_COMPLETED",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-1"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2-old1",
+ *           "Status": "SWITCHOVER_COMPLETED",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-2"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3-old1",
+ *           "Status": "SWITCHOVER_COMPLETED",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:db:my-aurora-mysql-cluster-3"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint-old1",
+ *           "Status": "SWITCHOVER_COMPLETED",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-excluded-member-endpoint"
+ *         },
+ *         {
+ *           "SourceMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint-old1",
+ *           "Status": "SWITCHOVER_COMPLETED",
+ *           "TargetMember": "arn:aws:rds:us-east-1:123456789012:cluster-endpoint:my-reader-endpoint"
+ *         }
+ *       ],
+ *       "Target": "arn:aws:rds:us-east-1:123456789012:cluster:my-aurora-mysql-cluster",
+ *       "Tasks": [
+ *         {
+ *           "Name": "CREATING_READ_REPLICA_OF_SOURCE",
+ *           "Status": "COMPLETED"
+ *         },
+ *         {
+ *           "Name": "DB_ENGINE_VERSION_UPGRADE",
+ *           "Status": "COMPLETED"
+ *         },
+ *         {
+ *           "Name": "CREATE_DB_INSTANCES_FOR_CLUSTER",
+ *           "Status": "COMPLETED"
+ *         },
+ *         {
+ *           "Name": "CREATE_CUSTOM_ENDPOINTS",
+ *           "Status": "COMPLETED"
+ *         }
+ *       ]
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-a-bluegreen-deployment-for-an-aurora-mysql-cluster-after-switchover-1680211583831
+ * ```
+ *
  */
 export declare class DescribeBlueGreenDeploymentsCommand extends $Command<DescribeBlueGreenDeploymentsCommandInput, DescribeBlueGreenDeploymentsCommandOutput, RDSClientResolvedConfig> {
     readonly input: DescribeBlueGreenDeploymentsCommandInput;

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

@@ -60,16 +60,56 @@ export interface DescribeCertificatesCommandOutput extends CertificateMessage, _
  *         existing certificate.</p>
  *
  *
- * @example To list certificates
+ * @example To describe certificates
  * ```javascript
- * // This example lists up to 20 certificates for the specified certificate identifier.
- * const input = {
- *   "CertificateIdentifier": "rds-ca-2015",
- *   "MaxRecords": 20
- * };
+ * // The following example retrieves the details of the certificate associated with the user's default region.
+ * const input = {};
  * const command = new DescribeCertificatesCommand(input);
- * await client.send(command);
- * // example id: describe-certificates-9d71a70d-7908-4444-b43f-321d842c62dc
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Certificates": [
+ *     {
+ *       "CertificateArn": "arn:aws:rds:us-east-1::cert:rds-ca-ecc384-g1",
+ *       "CertificateIdentifier": "rds-ca-ecc384-g1",
+ *       "CertificateType": "CA",
+ *       "CustomerOverride": false,
+ *       "Thumbprint": "24a97b91cbe86911190576c35c36aab4fEXAMPLE",
+ *       "ValidFrom": "2021-05-25T22:41:55+00:00",
+ *       "ValidTill": "2121-05-25T23:41:55+00:00"
+ *     },
+ *     {
+ *       "CertificateArn": "arn:aws:rds:us-east-1::cert:rds-ca-rsa4096-g1",
+ *       "CertificateIdentifier": "rds-ca-rsa4096-g1",
+ *       "CertificateType": "CA",
+ *       "CustomerOverride": false,
+ *       "Thumbprint": "9da6fa7fd2ec09c569a400d876b01b0c1EXAMPLE",
+ *       "ValidFrom": "2021-05-25T22:38:35+00:00",
+ *       "ValidTill": "2121-05-25T23:38:35+00:00"
+ *     },
+ *     {
+ *       "CertificateArn": "arn:aws:rds:us-east-1::cert:rds-ca-rsa2048-g1",
+ *       "CertificateIdentifier": "rds-ca-rsa2048-g1",
+ *       "CertificateType": "CA",
+ *       "CustomerOverride": true,
+ *       "CustomerOverrideValidTill": "2061-05-25T23:34:57+00:00",
+ *       "Thumbprint": "2fa77ef894d983ba9d37ad699c84ab0f6EXAMPLE",
+ *       "ValidFrom": "2021-05-25T22:34:57+00:00",
+ *       "ValidTill": "2061-05-25T23:34:57+00:00"
+ *     },
+ *     {
+ *       "CertificateArn": "arn:aws:rds:us-east-1::cert:rds-ca-2019",
+ *       "CertificateIdentifier": "rds-ca-2019",
+ *       "CertificateType": "CA",
+ *       "CustomerOverride": false,
+ *       "Thumbprint": "f0ed823ed14447bab557fdf3e49274669EXAMPLE",
+ *       "ValidFrom": "2019-09-19T18:16:53+00:00",
+ *       "ValidTill": "2024-08-22T17:08:50+00:00"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-certificates-1680211777663
  * ```
  *
  */

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

@@ -65,6 +65,39 @@ export interface DescribeDBClusterBacktracksCommandOutput extends DBClusterBackt
  *             <code>DBClusterIdentifier</code> doesn't refer to an existing DB cluster.</p>
  *
  *
+ * @example To describe backtracks for a DB cluster
+ * ```javascript
+ * // The following example retrieves details about the specified DB cluster.
+ * const input = {
+ *   "DBClusterIdentifier": "mydbcluster"
+ * };
+ * const command = new DescribeDBClusterBacktracksCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DBClusterBacktracks": [
+ *     {
+ *       "BacktrackIdentifier": "2f5f5294-0dd2-44c9-9f50-EXAMPLE",
+ *       "BacktrackRequestCreationTime": "2021-02-12T14:36:18.819Z",
+ *       "BacktrackTo": "2021-02-12T04:59:22Z",
+ *       "BacktrackedFrom": "2021-02-12T14:37:31.640Z",
+ *       "DBClusterIdentifier": "mydbcluster",
+ *       "Status": "COMPLETED"
+ *     },
+ *     {
+ *       "BacktrackIdentifier": "3c7a6421-af2a-4ea3-ae95-EXAMPLE",
+ *       "BacktrackRequestCreationTime": "2021-02-12T00:07:53.487Z",
+ *       "BacktrackTo": "2021-02-11T22:53:46Z",
+ *       "BacktrackedFrom": "2021-02-12T00:09:27.006Z",
+ *       "DBClusterIdentifier": "mydbcluster",
+ *       "Status": "COMPLETED"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-backtracks-for-a-db-cluster-1680212191454
+ * ```
+ *
  */
 export declare class DescribeDBClusterBacktracksCommand extends $Command<DescribeDBClusterBacktracksCommandInput, DescribeDBClusterBacktracksCommandOutput, RDSClientResolvedConfig> {
     readonly input: DescribeDBClusterBacktracksCommandInput;

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

@@ -58,6 +58,68 @@ export interface DescribeDBClusterEndpointsCommandOutput extends DBClusterEndpoi
  *             <code>DBClusterIdentifier</code> doesn't refer to an existing DB cluster.</p>
  *
  *
+ * @example To describe DB cluster endpoints
+ * ```javascript
+ * // The following example retrieves details for your DB cluster endpoints. The most common kinds of Aurora clusters have two endpoints. One endpoint has type WRITER. You can use this endpoint for all SQL statements. The other endpoint has type READER. You can use this endpoint only for SELECT and other read-only SQL statements.
+ * const input = {};
+ * const command = new DescribeDBClusterEndpointsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DBClusterEndpoints": [
+ *     {
+ *       "DBClusterIdentifier": "my-database-1",
+ *       "Endpoint": "my-database-1.cluster-cnpexample.us-east-1.rds.amazonaws.com",
+ *       "EndpointType": "WRITER",
+ *       "Status": "creating"
+ *     },
+ *     {
+ *       "DBClusterIdentifier": "my-database-1",
+ *       "Endpoint": "my-database-1.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
+ *       "EndpointType": "READER",
+ *       "Status": "creating"
+ *     },
+ *     {
+ *       "DBClusterIdentifier": "mydbcluster",
+ *       "Endpoint": "mydbcluster.cluster-cnpexamle.us-east-1.rds.amazonaws.com",
+ *       "EndpointType": "WRITER",
+ *       "Status": "available"
+ *     },
+ *     {
+ *       "DBClusterIdentifier": "mydbcluster",
+ *       "Endpoint": "mydbcluster.cluster-ro-cnpexample.us-east-1.rds.amazonaws.com",
+ *       "EndpointType": "READER",
+ *       "Status": "available"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-db-cluster-endpoints-1680212701970
+ * ```
+ *
+ * @example To describe DB cluster endpoints of a single DB cluster
+ * ```javascript
+ * // The following example retrieves details for the DB cluster endpoints of a single specified DB cluster. Aurora Serverless clusters have only a single endpoint with a type of WRITER.
+ * const input = {
+ *   "DBClusterIdentifier": "serverless-cluster"
+ * };
+ * const command = new DescribeDBClusterEndpointsCommand(input);
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DBClusterEndpoints": [
+ *     {
+ *       "DBClusterIdentifier": "serverless-cluster",
+ *       "Endpoint": "serverless-cluster.cluster-cnpexample.us-east-1.rds.amazonaws.com",
+ *       "EndpointType": "WRITER",
+ *       "Status": "available"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-db-cluster-endpoints-of-a-single-db-cluster-1680212863842
+ * ```
+ *
  */
 export declare class DescribeDBClusterEndpointsCommand extends $Command<DescribeDBClusterEndpointsCommandInput, DescribeDBClusterEndpointsCommandOutput, RDSClientResolvedConfig> {
     readonly input: DescribeDBClusterEndpointsCommandInput;

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

@@ -63,15 +63,49 @@ export interface DescribeDBClusterParameterGroupsCommandOutput extends DBCluster
  *         existing DB parameter group.</p>
  *
  *
- * @example To list DB cluster parameter group settings
+ * @example To describe DB cluster parameter groups
  * ```javascript
- * // This example lists settings for the specified DB cluster parameter group.
- * const input = {
- *   "DBClusterParameterGroupName": "mydbclusterparametergroup"
- * };
+ * // The following example retrieves details for your DB cluster parameter groups.
+ * const input = {};
  * const command = new DescribeDBClusterParameterGroupsCommand(input);
- * await client.send(command);
- * // example id: describe-db-cluster-parameter-groups-cf9c6e66-664e-4f57-8e29-a9080abfc013
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DBClusterParameterGroups": [
+ *     {
+ *       "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora-mysql5.7",
+ *       "DBClusterParameterGroupName": "default.aurora-mysql5.7",
+ *       "DBParameterGroupFamily": "aurora-mysql5.7",
+ *       "Description": "Default cluster parameter group for aurora-mysql5.7"
+ *     },
+ *     {
+ *       "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora-postgresql9.6",
+ *       "DBClusterParameterGroupName": "default.aurora-postgresql9.6",
+ *       "DBParameterGroupFamily": "aurora-postgresql9.6",
+ *       "Description": "Default cluster parameter group for aurora-postgresql9.6"
+ *     },
+ *     {
+ *       "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:default.aurora5.6",
+ *       "DBClusterParameterGroupName": "default.aurora5.6",
+ *       "DBParameterGroupFamily": "aurora5.6",
+ *       "Description": "Default cluster parameter group for aurora5.6"
+ *     },
+ *     {
+ *       "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpg",
+ *       "DBClusterParameterGroupName": "mydbclusterpg",
+ *       "DBParameterGroupFamily": "aurora-mysql5.7",
+ *       "Description": "My DB cluster parameter group"
+ *     },
+ *     {
+ *       "DBClusterParameterGroupArn": "arn:aws:rds:us-east-1:123456789012:cluster-pg:mydbclusterpgcopy",
+ *       "DBClusterParameterGroupName": "mydbclusterpgcopy",
+ *       "DBParameterGroupFamily": "aurora-mysql5.7",
+ *       "Description": "Copy of mydbclusterpg parameter group"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-db-cluster-parameter-groups-1680213090883
  * ```
  *
  */

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

@@ -62,16 +62,48 @@ export interface DescribeDBClusterParametersCommandOutput extends DBClusterParam
  *         existing DB parameter group.</p>
  *
  *
- * @example To list DB cluster parameters
+ * @example To describe the parameters in a DB cluster parameter group
  * ```javascript
- * // This example lists system parameters for the specified DB cluster parameter group.
+ * // The following example retrieves details about the parameters in a DB cluster parameter group.
  * const input = {
- *   "DBClusterParameterGroupName": "mydbclusterparametergroup",
- *   "Source": "system"
+ *   "DBClusterParameterGroupName": "mydbclusterpg"
  * };
  * const command = new DescribeDBClusterParametersCommand(input);
- * await client.send(command);
- * // example id: describe-db-cluster-parameters-98043c28-e489-41a7-b118-bfd96dc779a1
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "Parameters": [
+ *     {
+ *       "AllowedValues": "0,1",
+ *       "ApplyMethod": "pending-reboot",
+ *       "ApplyType": "static",
+ *       "DataType": "boolean",
+ *       "Description": "Controls whether user-defined functions that have only an xxx symbol for the main function can be loaded",
+ *       "IsModifiable": false,
+ *       "ParameterName": "allow-suspicious-udfs",
+ *       "Source": "engine-default",
+ *       "SupportedEngineModes": [
+ *         "provisioned"
+ *       ]
+ *     },
+ *     {
+ *       "AllowedValues": "0,1",
+ *       "ApplyMethod": "pending-reboot",
+ *       "ApplyType": "static",
+ *       "DataType": "boolean",
+ *       "Description": "Enables new features in the Aurora engine.",
+ *       "IsModifiable": true,
+ *       "ParameterName": "aurora_lab_mode",
+ *       "ParameterValue": "0",
+ *       "Source": "engine-default",
+ *       "SupportedEngineModes": [
+ *         "provisioned"
+ *       ]
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-the-parameters-in-a-db-cluster-parameter-group-1680213275624
  * ```
  *
  */

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

@@ -51,20 +51,30 @@ export interface DescribeDBClusterSnapshotAttributesCommandOutput extends Descri
  *             <code>DBClusterSnapshotIdentifier</code> doesn't refer to an existing DB cluster snapshot.</p>
  *
  *
- * @example To list DB cluster snapshot attributes
+ * @example To describe the attribute names and values for a DB cluster snapshot
  * ```javascript
- * // This example lists attributes for the specified DB cluster snapshot.
+ * // The following example retrieves details of the attribute names and values for the specified DB cluster snapshot.
  * const input = {
- *   "DBClusterSnapshotIdentifier": "mydbclustersnapshot"
+ *   "DBClusterSnapshotIdentifier": "myclustersnapshot"
  * };
  * const command = new DescribeDBClusterSnapshotAttributesCommand(input);
  * const response = await client.send(command);
  * /* response ==
  * {
- *   "DBClusterSnapshotAttributesResult": {}
+ *   "DBClusterSnapshotAttributesResult": {
+ *     "DBClusterSnapshotAttributes": [
+ *       {
+ *         "AttributeName": "restore",
+ *         "AttributeValues": [
+ *           "123456789012"
+ *         ]
+ *       }
+ *     ],
+ *     "DBClusterSnapshotIdentifier": "myclustersnapshot"
+ *   }
  * }
  * *\/
- * // example id: describe-db-cluster-snapshot-attributes-6752ade3-0c7b-4b06-a8e4-b76bf4e2d3571
+ * // example id: to-describe-the-attribute-names-and-values-for-a-db-cluster-snapshot-1680216238905
  * ```
  *
  */

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

@@ -64,16 +64,71 @@ export interface DescribeDBClusterSnapshotsCommandOutput extends DBClusterSnapsh
  *             <code>DBClusterSnapshotIdentifier</code> doesn't refer to an existing DB cluster snapshot.</p>
  *
  *
- * @example To list DB cluster snapshots
+ * @example To describe a DB cluster snapshot for a DB cluster
  * ```javascript
- * // This example lists settings for the specified, manually-created cluster snapshot.
+ * // The following example retrieves the details for the DB cluster snapshots for the specified DB cluster.
  * const input = {
- *   "DBClusterSnapshotIdentifier": "mydbclustersnapshot",
- *   "SnapshotType": "manual"
+ *   "DBClusterIdentifier": "mydbcluster"
  * };
  * const command = new DescribeDBClusterSnapshotsCommand(input);
- * await client.send(command);
- * // example id: describe-db-cluster-snapshots-52f38af1-3431-4a51-9a6a-e6bb8c961b32
+ * const response = await client.send(command);
+ * /* response ==
+ * {
+ *   "DBClusterSnapshots": [
+ *     {
+ *       "AllocatedStorage": 0,
+ *       "AvailabilityZones": [
+ *         "us-east-1a",
+ *         "us-east-1b",
+ *         "us-east-1e"
+ *       ],
+ *       "ClusterCreateTime": "2019-04-15T14:18:42.785Z",
+ *       "DBClusterIdentifier": "mydbcluster",
+ *       "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:814387698303:cluster-snapshot:myclustersnapshotcopy",
+ *       "DBClusterSnapshotIdentifier": "myclustersnapshotcopy",
+ *       "Engine": "aurora-mysql",
+ *       "EngineVersion": "5.7.mysql_aurora.2.04.2",
+ *       "IAMDatabaseAuthenticationEnabled": false,
+ *       "KmsKeyId": "arn:aws:kms:us-east-1:123456789012:key/AKIAIOSFODNN7EXAMPLE",
+ *       "LicenseModel": "aurora-mysql",
+ *       "MasterUsername": "myadmin",
+ *       "PercentProgress": 100,
+ *       "Port": 0,
+ *       "SnapshotCreateTime": "2019-06-04T09:16:42.649Z",
+ *       "SnapshotType": "manual",
+ *       "Status": "available",
+ *       "StorageEncrypted": true,
+ *       "VpcId": "vpc-6594f31c"
+ *     },
+ *     {
+ *       "AllocatedStorage": 0,
+ *       "AvailabilityZones": [
+ *         "us-east-1a",
+ *         "us-east-1b",
+ *         "us-east-1e"
+ *       ],
+ *       "ClusterCreateTime": "2019-04-15T14:18:42.785Z",
+ *       "DBClusterIdentifier": "mydbcluster",
+ *       "DBClusterSnapshotArn": "arn:aws:rds:us-east-1:123456789012:cluster-snapshot:rds:mydbcluster-2019-06-20-09-16",
+ *       "DBClusterSnapshotIdentifier": "rds:mydbcluster-2019-06-20-09-16",
+ *       "Engine": "aurora-mysql",
+ *       "EngineVersion": "5.7.mysql_aurora.2.04.2",
+ *       "IAMDatabaseAuthenticationEnabled": false,
+ *       "KmsKeyId": "arn:aws:kms:us-east-1:814387698303:key/AKIAIOSFODNN7EXAMPLE",
+ *       "LicenseModel": "aurora-mysql",
+ *       "MasterUsername": "myadmin",
+ *       "PercentProgress": 100,
+ *       "Port": 0,
+ *       "SnapshotCreateTime": "2019-06-20T09:16:26.569Z",
+ *       "SnapshotType": "automated",
+ *       "Status": "available",
+ *       "StorageEncrypted": true,
+ *       "VpcId": "vpc-6594f31c"
+ *     }
+ *   ]
+ * }
+ * *\/
+ * // example id: to-describe-a-db-cluster-snapshot-for-a-db-cluster-1680216426182
  * ```
  *
  */