AWS SDK Version 3 for .NET
API Reference

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

Note:

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

Syntax

C#
public abstract CopySnapshotResponse CopySnapshot(
         CopySnapshotRequest request
)

Parameters

request
Type: Amazon.ElastiCache.Model.CopySnapshotRequest

Container for the necessary parameters to execute the CopySnapshot service method.

Return Value


The response from the CopySnapshot service method, as returned by ElastiCache.

Exceptions

ExceptionCondition
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.

Examples

Copies a snapshot to a specified name.

CopySnapshot


var client = new AmazonElastiCacheClient();
var response = client.CopySnapshot(new CopySnapshotRequest 
{
    SourceSnapshotName = "my-snapshot",
    TargetBucket = "",
    TargetSnapshotName = "my-snapshot-copy"
});

Snapshot snapshot = response.Snapshot;

            

Version Information

.NET Framework:
Supported in: 4.5, 4.0, 3.5

See Also