Amazon ElastiCache for Redis
ElastiCache for Redis User Guide (API Version 2015-02-02)

Creating a Cluster (ElastiCache API)

To create a cluster using the ElastiCache API, use the CreateCacheCluster action.


As soon as your cluster becomes available, you're billed for each hour or partial hour that the cluster is active, even if you're not using it. To stop incurring charges for this cluster, you must delete it. See Deleting a Cluster.

Creating a Redis (Cluster Mode Disabled) Cache Cluster (ElastiCache API)

The following code creates a Redis (cluster mode disabled) cache cluster (ElastiCache API).

If you want to enable in-transit or at-rest encryption on this cluster, add these parameters:

  • TransitEncryptionEnabled=true

    If you enable in-transit encryption, the cluster must be created in a VPC based on the Amazon VPC service. You must also include the parameter -cache-subnet-group.

  • AuthToken with the customer specified string value for your AUTH token (password) needed to perform operations on this cluster.

  • AtRestEncryptionEnabled=true

Line breaks are added for ease of reading. ?Action=CreateCacheCluster &CacheClusterId=my-cluster &CacheNodeType=cache.r4.large &CacheParameterGroup=default.redis3.2 &Engine=redis &EngineVersion=3.2.4 &NumCacheNodes=1 &SignatureVersion=4 &SignatureMethod=HmacSHA256 &SnapshotArns.member.1=arn%3Aaws%3As3%3A%3A%3AmyS3Bucket%2Fdump.rdb &Timestamp=20150508T220302Z &Version=2015-02-02 &X-Amz-Algorithm=AWS4-HMAC-SHA256 &X-Amz-Credential=<credential> &X-Amz-Date=20150508T220302Z &X-Amz-Expires=20150508T220302Z &X-Amz-SignedHeaders=Host &X-Amz-Signature=<signature>

Creating a Cache Cluster in Redis (Cluster Mode Enabled) (ElastiCache API)

Redis (cluster mode enabled) clusters (API/CLI: replication groups) cannot be created using the CreateCacheCluster operation. To create a Redis (cluster mode enabled) cluster (API/CLI: replication group), see Creating a Replication Group in Redis (Cluster Mode Enabled) from Scratch (ElastiCache API).

For more information, see the ElastiCache API reference topic CreateReplicationGroup.