DeleteServerlessCache - Amazon ElastiCache
Services or capabilities described in Amazon Web Services documentation might vary by Region. To see the differences applicable to the China Regions, see Getting Started with Amazon Web Services in China (PDF).


Deletes a specified existing serverless cache.

Request Parameters

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


The identifier of the serverless cache to be deleted.

Type: String

Required: Yes


Name of the final snapshot to be taken before the serverless cache is deleted. Available for Redis and Serverless Memcached only. Default: NULL, i.e. a final snapshot is not taken.

Type: String

Required: No

Response Elements

The following element is returned by the service.


Provides the details of the specified serverless cache that is about to be deleted.

Type: ServerlessCache object


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


You must enter valid credentials.

HTTP Status Code: 408


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 and Serverless Memcached only.

HTTP Status Code: 400


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

HTTP Status Code: 400



This example illustrates one usage of DeleteServerlessCache.

Sample Request

{ "input": { "ServerlessCacheName": "my-serverless-cache" }, "output": { "ServerlessCache": { "ServerlessCacheName": "my-serverless-cache", "Description": "A serverless cache.", "Status": "deleting", "Engine": "redis", "MajorEngineVersion": "7", "FullEngineVersion": "7.0", "SubnetIds": [ "subnet-xxx8c982", "subnet-xxx382f3", "subnet-xxxb3e7c0" ], "SecurityGroupIds": [ "sg-xxx0c9af" ], "Endpoint": { "Address": "", "Port": 6379 }, "ARN": "arn:aws:elasticache:us-east-1:222222222222:serverlesscache:my-serverless-cache", "SnapshotRetentionLimit": 10, "DailySnapshotTime": "11:00" } } }

See Also

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