ElastiCache (Redis OSS) terminology - Amazon ElastiCache (Redis OSS)
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).

ElastiCache (Redis OSS) terminology

In October 2016, Amazon ElastiCache launched support for Redis OSS 3.2. At that point, we added support for partitioning your data across up to 500 shards (called node groups in the ElastiCache API and Amazon CLI). To preserve compatibility with previous versions, we extended API version 2015-02-02 operations to include the new Redis OSS functionality.

At the same time, we began using terminology in the ElastiCache console that is used in this new functionality and common across the industry. These changes mean that at some points, the terminology used in the API and CLI might be different from the terminology used in the console. The following list identifies terms that might differ between the API and CLI and the console.

Cache cluster or node vs. node

There is a one-to-one relationship between a node and a cache cluster when there are no replica nodes. Thus, the ElastiCache console often used the terms interchangeably. The console now uses the term node throughout. The one exception is the Create Cluster button, which launches the process to create a cluster with or without replica nodes.

The ElastiCache API and Amazon CLI continue to use the terms as they have in the past.

Cluster vs. replication group

The console now uses the term cluster for all ElastiCache (Redis OSS) clusters. The console uses the term cluster in all these circumstances:

  • When the cluster is a single node Redis OSS cluster.

  • When the cluster is a Redis OSS (cluster mode disabled) cluster that supports replication within a single shard (in the API and CLI, called a node group).

  • When the cluster is a Redis OSS (cluster mode enabled) cluster that supports replication within 1-90 shards or up to 500 with a limit increase request. To request a limit increase, see Amazon service limits and choose the limit type Nodes per cluster per instance type.

For more information on replication groups, see High availability using replication groups.

The following diagram illustrates the various topologies of ElastiCache (Redis OSS) clusters from the console's perspective.

Image: ElastiCache (Redis OSS) clusters (Console view)

The ElastiCache API and Amazon CLI operations still distinguish single node ElastiCache (Redis OSS) clusters from multi-node replication groups. The following diagram illustrates the various ElastiCache (Redis OSS) topologies from the ElastiCache API and Amazon CLI perspective.

Image: ElastiCache (Redis OSS) cluster and replication groups (API and CLI view)
Replication group vs. global datastore

A global datastore is a collection of one or more clusters that replicate to one another across Regions, whereas a replication group replicates data across a cluster mode enabled cluster with multiple shards. A global datastore consists of the following:

  • Primary (active) cluster – A primary cluster accepts writes that are replicated to all clusters within the global datastore. A primary cluster also accepts read requests.

  • Secondary (passive) cluster – A secondary cluster only accepts read requests and replicates data updates from a primary cluster. A secondary cluster needs to be in a different Amazon Region than the primary cluster.

For information on global datastores, see Replication across Amazon Regions using global datastores.