Amazon ElastiCache
API Reference (API Version 2015-02-02)


Deletes a previously provisioned cache cluster. DeleteCacheCluster deletes all associated cache nodes, node endpoints and the cache cluster itself. When you receive a successful response from this operation, Amazon ElastiCache immediately begins deleting the cache cluster; you cannot cancel or revert this operation.

This operation cannot be used to delete a cache cluster that is the last read replica of a replication group or node group (shard) that has Multi-AZ mode enabled or a cache cluster from a Redis (cluster mode enabled) replication group.


Due to current limitations on Redis (cluster mode disabled), this operation or parameter is not supported on Redis (cluster mode enabled) replication groups.

Request Parameters

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


The cache cluster identifier for the cluster to be deleted. This parameter is not case sensitive.

Type: String

Required: Yes


The user-supplied name of a final cache cluster snapshot. This is the unique name that identifies the snapshot. ElastiCache creates the snapshot, and then deletes the cache cluster immediately afterward.

Type: String

Required: No

Response Elements

The following element is returned by the service.


Contains all of the attributes of a specific cache cluster.

Type: CacheCluster object


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


The requested cache cluster ID does not refer to an existing cache cluster.

HTTP Status Code: 404


The requested cache cluster is not in the available state.

HTTP Status Code: 400


Two or more incompatible parameters were specified.

HTTP Status Code: 400


The value for a parameter is invalid.

HTTP Status Code: 400


You already have a snapshot with the given name.

HTTP Status Code: 400


You attempted one of the following operations:

  • Creating a snapshot of a Redis cache cluster running on a cache.t1.micro cache node.

  • Creating a snapshot of a cache cluster that is running Memcached rather than Redis.

Neither of these are supported by ElastiCache.

HTTP Status Code: 400


The request cannot be processed because it would exceed the maximum number of snapshots.

HTTP Status Code: 400


Sample Request

Copy ?Action=DeleteCacheCluster &CacheClusterId=simcoprod43 &Version=2015-02-02 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &Timestamp=20150202T192317Z &X-Amz-Credential=<credential>

Sample Response

<DeleteCacheClusterResponse xmlns=""> <DeleteCacheClusterResult> <CacheCluster> <CacheParameterGroup> <ParameterApplyStatus>in-sync</ParameterApplyStatus> <CacheParameterGroupName>default.memcached1.4</CacheParameterGroupName> <CacheNodeIdsToReboot/> </CacheParameterGroup> <CacheClusterId>simcoprod43</CacheClusterId> <CacheClusterStatus>deleting</CacheClusterStatus> <ConfigurationEndpoint> <Port>11211</Port> <Address></Address> </ConfigurationEndpoint> <CacheNodeType>cache.m1.large</CacheNodeType> <Engine>memcached</Engine> <PendingModifiedValues/> <PreferredAvailabilityZone>us-west-2b</PreferredAvailabilityZone> <CacheClusterCreateTime>2015-02-02T02:18:26.497Z</CacheClusterCreateTime> <EngineVersion>1.4.5</EngineVersion> <AutoMinorVersionUpgrade>true</AutoMinorVersionUpgrade> <PreferredMaintenanceWindow>mon:05:00-mon:06:00</PreferredMaintenanceWindow> <CacheSecurityGroups> <CacheSecurityGroup> <CacheSecurityGroupName>default</CacheSecurityGroupName> <Status>active</Status> </CacheSecurityGroup> </CacheSecurityGroups> <NumCacheNodes>3</NumCacheNodes> </CacheCluster> </DeleteCacheClusterResult> <ResponseMetadata> <RequestId>ab84aa7e-b7fa-11e0-9b0b-a9261be2b354</RequestId> </ResponseMetadata> </DeleteCacheClusterResponse>

See Also

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