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).

Using MemoryDB Multi-Region with the CLI

Below are ways to use MemoryDB Multi-Region with the CLI

Creating clusters with MemoryDBMulti Region

Create a Multi Region cluster

aws memorydb create-multi-region-cluster \
	--multi-region-cluster-name-suffix my-multi-region-cluster \
	--node-type db.r7g.xlarge \
	--engine valkey \
	--region us-east-1

Create a regional cluster in US East (N. Virginia) Region

aws memorydb create-cluster \
	--cluster-name my-cluster \
	--multi-region-cluster-name my-multi-region-cluster \
	--node-type db.r7g.xlarge \
	--acl-name open-access \
	--region us-east-1 \

Create a Region cluster in Europe (Ireland) Region

aws memorydb create-cluster \
	--cluster-name my-cluster \
	--multi-region-cluster-name my-multi-region-cluster \
	--node-type db.r7g.xlarge \
	--acl-name open-access \
	--region eu-west-1 \

Describe the Multi Region cluster from any Region

aws memorydb describe-multi-region-cluster \
	--multi-region-cluster-name my-multi-region-cluster \
	--region eu-west-1 

Update a Multi Region cluster

Modifying Node Type

aws memorydb update-multi-region-cluster \
	--multi-region-cluster-name my-multi-region-cluster \
	--node-type db.r7g.4xlarge \
	--region us-east-1

Modifying shard count

aws memorydb update-multi-region-cluster \
	--multi-region-cluster-name my-multi-region-cluster \
	--shard-configuration \
	ShardCount=3 \
	--update-strategy COORDINATED \
	--region us-east-1

Scaling MemoryDB clusters

First, list the nodes that can scale up or down with the list-allowed-node-type-updates command:

aws memorydb list-allowed-node-type-updates \
	--cluster-name my-cluster-name 

This will provide a list of nodes that can be scaled up or down. To then update them, you can use the update-cluster command:

aws memorydb update-cluster  \
	--cluster-name my-cluster \
	--node-type db.r6g.2xlarge

For more information on scaling with Multi-Region see Scaling with MemoryDB Multi-Region.

Deleting clusters in MemoryDB Multi-Region

Delete a regional cluster

aws memorydb delete-cluster \	
	--cluster-name my-cluster \
	--multi-region-cluster-name my-multi-region-cluster \
	--region us-east-1

Delete a Multi Region cluster

aws memorydb delete-multi-region-cluster \
	--multi-region-cluster-name my-multi-region-cluster \
	--region us-east-1