AWS::ElastiCache::ReplicationGroup NodeGroupConfiguration
NodeGroupConfiguration
is a property of the AWS::ElastiCache::ReplicationGroup
resource that configures an Amazon ElastiCache (ElastiCache) Valkey or Redis OSS cluster node group.
Syntax
To declare this entity in your AWS CloudFormation template, use the following syntax:
JSON
{ "NodeGroupId" :
String
, "PrimaryAvailabilityZone" :String
, "ReplicaAvailabilityZones" :[ String, ... ]
, "ReplicaCount" :Integer
, "Slots" :String
}
YAML
NodeGroupId:
String
PrimaryAvailabilityZone:String
ReplicaAvailabilityZones:- String
ReplicaCount:Integer
Slots:String
Properties
NodeGroupId
-
Either the ElastiCache supplied 4-digit id or a user supplied id for the node group these configuration values apply to.
Required: No
Type: String
Pattern:
\d+
Minimum:
1
Maximum:
4
Update requires: No interruption
PrimaryAvailabilityZone
-
The Availability Zone where the primary node of this node group (shard) is launched.
Required: No
Type: String
Update requires: No interruption
ReplicaAvailabilityZones
-
A list of Availability Zones to be used for the read replicas. The number of Availability Zones in this list must match the value of
ReplicaCount
orReplicasPerNodeGroup
if not specified.Required: No
Type: Array of String
Update requires: No interruption
ReplicaCount
-
The number of read replica nodes in this node group (shard).
Required: No
Type: Integer
Update requires: No interruption
Slots
-
A string of comma-separated values where the first set of values are the slot numbers (zero based), and the second set of values are the keyspaces for each slot. The following example specifies three slots (numbered 0, 1, and 2):
0,1,2,0-4999,5000-9999,10000-16,383
.If you don't specify a value, ElastiCache allocates keys equally among each slot.
When you use an
UseOnlineResharding
update policy to update the number of node groups without interruption, ElastiCache evenly distributes the keyspaces between the specified number of slots. This cannot be updated later. Therefore, after updating the number of node groups in this way, you should remove the value specified for theSlots
property of eachNodeGroupConfiguration
from the stack template, as it no longer reflects the actual values in each node group. For more information, see UseOnlineResharding Policy.Required: No
Type: String
Update requires: No interruption