CreateServerlessCacheSnapshot - Amazon ElastiCache


This API creates a copy of an entire ServerlessCache at a specific moment in time. Available for Redis only.

Request Parameters

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


The name of an existing serverless cache. The snapshot is created from this cache. Available for Redis only.

Type: String

Required: Yes


The name for the snapshot being created. Must be unique for the customer account. Available for Redis only. Must be between 1 and 255 characters.

Type: String

Required: Yes


The ID of the KMS key used to encrypt the snapshot. Available for Redis only. Default: NULL

Type: String

Required: No


A list of tags to be added to the snapshot resource. A tag is a key-value pair. Available for Redis only.

Type: Array of Tag objects

Required: No

Response Elements

The following element is returned by the service.


The state of a serverless cache snapshot at a specific point in time, to the millisecond. Available for Redis only.

Type: ServerlessCacheSnapshot object


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


Two or more incompatible parameters were specified.

HTTP Status Code: 400


The value for a parameter is invalid.

HTTP Status Code: 400


The account for these credentials is not currently active.

HTTP Status Code: 400


The serverless cache was not found or does not exist.

HTTP Status Code: 404


A serverless cache snapshot with this name already exists. Available for Redis only.

HTTP Status Code: 400


The number of serverless cache snapshots exceeds the customer snapshot quota. Available for Redis only.

HTTP Status Code: 400


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

HTTP Status Code: 400


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



This example illustrates one usage of CreateServerlessCacheSnapshot.

Sample Request

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

See Also

For more information about using this API in one of the language-specific AWS SDKs, see the following: