CmdID / aws / aws elasticache
aws elasticache test-failover
Represents the input of a TestFailover operation which tests automatic failover on a specified node group (called shard in the console) in a replication group (called cluster in the console). AWS CLI reference
1 example 2 options Its page in the AWS CLI reference
Examples
To test failover of a node group
The following test-failover example tests automatic failover on the specified node group (called a shard in the console) in a replication group (called a cluster in the console).
aws elasticache test-failover --replication-group-id "mycluster" --node-group-id "0001"Identify--replication-group-idThe name of the replication group (console: cluster) whose automatic failover is being tested by this operation.--node-group-idThe name of the node group (called shard in the console) in this replication group on which automatic failover is to be tested.Its output, shortened
{
"ReplicationGroup": {
"ReplicationGroupId": "mycluster",
"Description": "My Cluster",
"Status": "available",
"PendingModifiedValues": {},
"MemberClusters": [
"mycluster-0001-001",
"mycluster-0001-002",
"mycluster-0001-003",
"mycluster-0002-001",
"mycluster-0002-002",
"mycluster-0002-003",
"mycluster-0003-001",
"mycluster-0003-002",
"mycluster-0003-003"
],
"NodeGroups": [
{
"NodeGroupId": "0001",
"Status": "available",
"Slots": "0-5461",
"NodeGroupMembers": [
{
"CacheClusterId": "mycluster-0001-001",
"CacheNodeId": "0001",
"PreferredAvailabilityZone": "us-west-2b"
},
{
"CacheClusterId": "mycluster-0001-002",
… 68 more linesFor more information, see Minimizing downtime in ElastiCache by using Multi-AZ with Valkey and Redis OSS in the Amazon ElastiCache User Guide.
Options
--node-group-idThe name of the node group (called shard in the console) in this replication group on which automatic failover is to be tested.--replication-group-idThe name of the replication group (console: cluster) whose automatic failover is being tested by this operation.