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.
Makes a copy of an existing snapshot.
This operation is valid for Redis only.
Users or groups that have permissions to use the CopySnapshot
operation can
create their own Amazon S3 buckets and copy snapshots to it. To control access to
your snapshots, use an IAM policy to control who has the ability to use the CopySnapshot
operation. For more information about using IAM to control the use of ElastiCache
operations, see Exporting
Snapshots and Authentication
& Access Control.
You could receive the following error messages.
Error Messages
Error Message: The S3 bucket %s is outside of the region.
Solution: Create an Amazon S3 bucket in the same region as your snapshot. For more information, see Step 1: Create an Amazon S3 Bucket in the ElastiCache User Guide.
Error Message: The S3 bucket %s does not exist.
Solution: Create an Amazon S3 bucket in the same region as your snapshot. For more information, see Step 1: Create an Amazon S3 Bucket in the ElastiCache User Guide.
Error Message: The S3 bucket %s is not owned by the authenticated user.
Solution: Create an Amazon S3 bucket in the same region as your snapshot. For more information, see Step 1: Create an Amazon S3 Bucket in the ElastiCache User Guide.
Error Message: The authenticated user does not have sufficient permissions to perform the desired activity.
Solution: Contact your system administrator to get the needed permissions.
Error Message: The S3 bucket %s already contains an object with key %s.
Solution: Give the TargetSnapshotName
a new and unique value. If exporting
a snapshot, you could alternatively create a new Amazon S3 bucket and use this same
value for TargetSnapshotName
.
Error Message: ElastiCache has not been granted READ permissions %s on the S3 Bucket.
Solution: Add List and Read permissions on the bucket. For more information, see Step 2: Grant ElastiCache Access to Your Amazon S3 Bucket in the ElastiCache User Guide.
Error Message: ElastiCache has not been granted WRITE permissions %s on the S3 Bucket.
Solution: Add Upload/Delete permissions on the bucket. For more information, see Step 2: Grant ElastiCache Access to Your Amazon S3 Bucket in the ElastiCache User Guide.
Error Message: ElastiCache has not been granted READ_ACP permissions %s on the S3 Bucket.
Solution: Add View Permissions on the bucket. For more information, see Step 2: Grant ElastiCache Access to Your Amazon S3 Bucket in the ElastiCache User Guide.
For .NET Core this operation is only available in asynchronous form. Please refer to CopySnapshotAsync.
Namespace: Amazon.ElastiCache
Assembly: AWSSDK.ElastiCache.dll
Version: 3.x.y.z
public abstract CopySnapshotResponse CopySnapshot( CopySnapshotRequest request )
Container for the necessary parameters to execute the CopySnapshot service method.
Exception | Condition |
---|---|
InvalidParameterCombinationException | Two or more incompatible parameters were specified. |
InvalidParameterValueException | The value for a parameter is invalid. |
InvalidSnapshotStateException | The current state of the snapshot does not allow the requested operation to occur. |
SnapshotAlreadyExistsException | You already have a snapshot with the given name. |
SnapshotNotFoundException | The requested snapshot name does not refer to an existing snapshot. |
SnapshotQuotaExceededException | The request cannot be processed because it would exceed the maximum number of snapshots. |
TagQuotaPerResourceExceededException | The request cannot be processed because it would cause the resource to have more than the allowed number of tags. The maximum number of tags permitted on a resource is 50. |
Copies a snapshot to a specified name.
var client = new AmazonElastiCacheClient(); var response = client.CopySnapshot(new CopySnapshotRequest { SourceSnapshotName = "my-snapshot", TargetBucket = "", TargetSnapshotName = "my-snapshot-copy" }); Snapshot snapshot = response.Snapshot;
.NET Framework:
Supported in: 4.5, 4.0, 3.5