Step 3: Create a DAX cluster using the AWS CLI
Follow this procedure to use the AWS Command Line Interface (AWS CLI) to create an Amazon DynamoDB Accelerator (DAX) cluster in your default Amazon VPC.
To create a DAX cluster
-
Get the Amazon Resource Name (ARN) for your service role.
aws iam get-role \ --role-name DAXServiceRoleForDynamoDBAccess \ --query "Role.Arn" --output text
In the output, note the service role ARN, as in the following example.
arn:aws:iam::123456789012:role/DAXServiceRoleForDynamoDBAccess
-
Create the DAX cluster. Replace
with the ARN from the previous step.roleARN
aws dax create-cluster \ --cluster-name mydaxcluster \ --node-type dax.r4.large \ --replication-factor 3 \ --iam-role-arn
roleARN
\ --subnet-group my-subnet-group \ --sse-specification Enabled=true \ --region us-west-2All of the nodes in the cluster are of type
dax.r4.large
(--node-type
). There are three nodes (--replication-factor
)—one primary node and two replicas.Note
Since
sudo
andgrep
are reserved keywords, you cannot create a DAX cluster with these words in the cluster name. For example,sudo
andsudocluster
are invalid cluster names.
To view the cluster status, enter the following command.
aws dax describe-clusters
The status is shown in the output—for example, "Status":
"creating"
.
Note
Creating the cluster takes several minutes. When the cluster is ready, its
status changes to available
. In the meantime, proceed to Step 4: Configure security
group inbound rules using the AWS CLI and follow the
instructions there.