DeleteServerlessCache
Deletes a specified existing serverless cache.
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 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.
- 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 Redis 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: