AWS services or capabilities described in AWS Documentation may vary by region/location. Click Getting Started with Amazon AWS to see specific differences applicable to the China (Beijing) Region.
Copies a snapshot of a DB cluster.
To copy a DB cluster snapshot from a shared manual DB cluster snapshot, SourceDBClusterSnapshotIdentifier
must be the Amazon Resource Name (ARN) of the shared DB cluster snapshot.
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 CopyDBClusterSnapshot
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:
KmsKeyId
- The Amazon Web Services Key Management System (Amazon Web Services
KMS) key identifier for the key to use to encrypt the copy of the DB cluster snapshot
in the destination Amazon Web Services Region.
TargetDBClusterSnapshotIdentifier
- The identifier for the new copy of the
DB cluster snapshot in the destination Amazon Web Services Region.
SourceDBClusterSnapshotIdentifier
- 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 SourceDBClusterSnapshotIdentifier
in the presigned URL.
To cancel the copy operation once it is in progress, delete the target DB cluster
snapshot identified by TargetDBClusterSnapshotIdentifier
while that DB cluster
snapshot is in "copying" status.
For more information on copying encrypted Amazon Aurora DB cluster snapshots from one Amazon Web Services Region to another, see Copying a Snapshot in the Amazon Aurora User Guide.
For more information on Amazon Aurora DB clusters, see What is Amazon Aurora? in the Amazon Aurora User Guide.
For more information on Multi-AZ DB clusters, see Multi-AZ DB cluster deployments in the Amazon RDS User Guide.
For .NET Core this operation is only available in asynchronous form. Please refer to CopyDBClusterSnapshotAsync.
Namespace: Amazon.RDS
Assembly: AWSSDK.RDS.dll
Version: 3.x.y.z
public virtual CopyDBClusterSnapshotResponse CopyDBClusterSnapshot( CopyDBClusterSnapshotRequest request )
Container for the necessary parameters to execute the CopyDBClusterSnapshot service method.
Exception | Condition |
---|---|
DBClusterSnapshotAlreadyExistsException | The user already has a DB cluster snapshot with the given identifier. |
DBClusterSnapshotNotFoundException | DBClusterSnapshotIdentifier doesn't refer to an existing DB cluster snapshot. |
InvalidDBClusterSnapshotStateException | The supplied value isn't a valid DB cluster snapshot state. |
InvalidDBClusterStateException | The requested operation can't be performed while the cluster is in this state. |
KMSKeyNotAccessibleException | An error occurred accessing an Amazon Web Services KMS key. |
SnapshotQuotaExceededException | The request would result in the user exceeding the allowed number of DB snapshots. |
.NET Framework:
Supported in: 4.5, 4.0, 3.5