Request Parameters Response Elements Errors Examples See Also

CopyServerlessCacheSnapshot

Creates a copy of an existing serverless cache’s snapshot. Available for Valkey, Redis OSS and Serverless Memcached only.

Request Parameters

For information about the parameters that are common to all actions, see Common Parameters.

SourceServerlessCacheSnapshotName

The identifier of the existing serverless cache’s snapshot to be copied. Available for Valkey, Redis OSS and Serverless Memcached only.

Type: String

Required: Yes

TargetServerlessCacheSnapshotName

The identifier for the snapshot to be created. Available for Valkey, Redis OSS and Serverless Memcached only.

Type: String

Required: Yes

KmsKeyId

The identifier of the KMS key used to encrypt the target snapshot. Available for Valkey, Redis OSS and Serverless Memcached only.

Type: String

Required: No

Tags.Tag.N

A list of tags to be added to the target snapshot resource. A tag is a key-value pair. Available for Valkey, Redis OSS and Serverless Memcached only. Default: NULL

Type: Array of Tag objects

Required: No

Response Elements

The following element is returned by the service.

ServerlessCacheSnapshot

The response for the attempt to copy the serverless cache snapshot. Available for Valkey, Redis OSS and Serverless Memcached only.

Type: ServerlessCacheSnapshot object

Errors

For information about the errors that are common to all actions, see Common Errors.

InvalidParameterCombination

Two or more incompatible parameters were specified.

HTTP Status Code: 400

InvalidParameterValue

The value for a parameter is invalid.

HTTP Status Code: 400

InvalidServerlessCacheSnapshotStateFault

The state of the serverless cache snapshot was not received. Available for Valkey, Redis OSS and Serverless Memcached only.

HTTP Status Code: 400

ServerlessCacheSnapshotAlreadyExistsFault

A serverless cache snapshot with this name already exists. Available for Valkey, Redis OSS and Serverless Memcached only.

HTTP Status Code: 400

ServerlessCacheSnapshotNotFoundFault

This serverless cache snapshot could not be found or does not exist. Available for Valkey, Redis OSS and Serverless Memcached only.

HTTP Status Code: 404

ServerlessCacheSnapshotQuotaExceededFault

The number of serverless cache snapshots exceeds the customer snapshot quota. Available for Valkey, Redis OSS and Serverless Memcached only.

HTTP Status Code: 400

ServiceLinkedRoleNotFoundFault

The specified service linked role (SLR) was not found.

HTTP Status Code: 400

TagQuotaPerResourceExceeded

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.

HTTP Status Code: 400

Examples

CopyServerlessCacheSnapshot

This example illustrates one usage of CopyServerlessCacheSnapshot.

Sample Request


{
    "input": {
        "SourceServerlessCacheSnapshotName": "my-serverless-cache-snapshot",
        "TargetServerlessCacheSnapshotName": "my-serverless-cache-snapshot-copy"
    },
    "output": {
        "ServerlessCacheSnapshot": {
            "ServerlessCacheSnapshotName": "my-serverless-cache-snapshot-copy",
            "ARN": "arn:aws:elasticache:us-east-1:222222222222:serverlesscachesnapshot:my-serverless-cache-snapshot-copy",
            "SnapshotType": "manual",
            "Status": "creating",
            "ServerlessCacheConfiguration": {
                "ServerlessCacheName": "my-serverless-cache",
                "Engine": "redis",
                "MajorEngineVersion": "7"
            }
        }
    }
}