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.
This is an asynchronous operation using the standard naming convention for .NET 4.5 or higher. For .NET 3.5 the operation is implemented as a pair of methods using the standard naming convention of BeginCopyDBClusterSnapshot and EndCopyDBClusterSnapshot.
Namespace: Amazon.RDS
Assembly: AWSSDK.RDS.dll
Version: 3.x.y.z
public abstract Task<CopyDBClusterSnapshotResponse> CopyDBClusterSnapshotAsync( CopyDBClusterSnapshotRequest request, CancellationToken cancellationToken )
Container for the necessary parameters to execute the CopyDBClusterSnapshot service method.
A cancellation token that can be used by other objects or threads to receive notice of cancellation.
| 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 Core App:
Supported in: 3.1
.NET Standard:
Supported in: 2.0
.NET Framework:
Supported in: 4.5