DeleteServerlessCache - Amazon ElastiCache

DeleteServerlessCache

Deletes a specified existing serverless cache.

Note

CreateServerlessCacheSnapshot permission is required to create a final snapshot. Without this permission, the API call will fail with an Access Denied exception.

Request Parameters

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

ServerlessCacheName

The identifier of the serverless cache to be deleted.

Type: String

Required: Yes

FinalSnapshotName

Name of the final snapshot to be taken before the serverless cache is deleted. Available for Valkey, Redis OSS 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.

ServerlessCache

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

Type: ServerlessCache object

Errors

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

InvalidCredentials

You must enter valid credentials.

HTTP Status Code: 408

InvalidParameterCombination

Two or more incompatible parameters were specified.

HTTP Status Code: 400

InvalidParameterValue

The value for a parameter is invalid.

HTTP Status Code: 400

InvalidServerlessCacheStateFault

The account for these credentials is not currently active.

HTTP Status Code: 400

ServerlessCacheNotFoundFault

The serverless cache was not found or does not exist.

HTTP Status Code: 404

ServerlessCacheSnapshotAlreadyExistsFault

A serverless cache snapshot with this name already exists. 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

Examples

DeleteServerlessCache

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": "my-serverless-cache-xxxxx.serverless.use1qa.cache.amazonaws.com", "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 AWS SDKs, see the following: