CmdID / aws / aws elasticache

aws elasticache create-replication-group

Creates a Valkey or Redis OSS (cluster mode disabled) or a Valkey or Redis OSS (cluster mode enabled) replication group. AWS CLI reference

1 example 40 options Its page in the AWS CLI reference

Examples

from aws-cli, each command read by CmdID

To create a replication group

The following create-replication-group example creates a Valkey (cluster mode disabled) replication group with in-transit encryption enabled. This operation is valid for Valkey and Redis OSS. For Valkey, you must specify --transit-encryption-enabled or --no-transit-encryption-enabled.

aws elasticache create-replication-group --replication-group-id "mygroup" --replication-group-description "my group" --engine "valkey" --cache-node-type "cache.m7g.large" --transit-encryption-enabled

Identify

--replication-group-idThe replication group identifier.

--replication-group-descriptionA user-created description for the replication group.

--engineThe name of the cache engine to be used for the clusters in this replication group.

--cache-node-typeThe compute and memory capacity of the nodes in the node group (shard).

--transit-encryption-enabledA flag that enables in-transit encryption when set to true.

Its output

{
    "ReplicationGroup": {
        "ReplicationGroupId": "mygroup",
        "Description": "my group",
        "GlobalReplicationGroupInfo": {},
        "Status": "creating",
        "PendingModifiedValues": {},
        "MemberClusters": [
            "mygroup-001"
        ],
        "AutomaticFailover": "disabled",
        "MultiAZ": "disabled",
        "SnapshotRetentionLimit": 0,
        "SnapshotWindow": "09:30-10:30",
        "ClusterEnabled": false,
        "CacheNodeType": "cache.m7g.large",
        "TransitEncryptionEnabled": true,
        "AtRestEncryptionEnabled": true,
        "ARN": "arn:aws:elasticache:us-west-2:123456789012:replicationgroup:mygroup",
        "LogDeliveryConfigurations": [],
        "ReplicationGroupCreateTime": "2026-10-26T14:21:45.460000+00:00",
        "DataTiering": "disabled",
        "AutoMinorVersionUpgrade": true,
        "NetworkType": "ipv4",
        "IpDiscovery": "ipv4",
        "TransitEncryptionMode": "required",
        "ClusterMode": "disabled",
        "Engine": "valkey"
    }
}

For more information, see Creating a Valkey or Redis OSS replication group in the Amazon ElastiCache User Guide.

Options

40 in the AWS CLI reference

Show its 40 options

--at-rest-encryption-enabledA flag that enables encryption at-rest on the replication group when set to true.

--auth-tokenReserved parameter.

--auto-minor-version-upgradeIf you are running Valkey 7.2 and above or Redis OSS engine version 6.0 and above, set this parameter to yes to opt-in to the next auto minor version upgrade campaign.

--automatic-failover-enabledSpecifies whether a read-only replica is automatically promoted to read/write primary if the existing primary fails.

--cache-node-typeThe compute and memory capacity of the nodes in the node group (shard).

--cache-parameter-group-nameThe name of the parameter group to associate with this replication group.

--cache-security-group-namesA list of cache security group names to associate with this replication group.

--cache-subnet-group-nameThe name of the cache subnet group to be used for the replication group.

--cluster-modeEnabled or Disabled.

--data-tiering-enabledEnables data tiering.

--durabilitySpecifies the durability setting for the replication group.

--engine-versionThe version number of the cache engine to be used for the clusters in this replication group.

--engineThe name of the cache engine to be used for the clusters in this replication group.

--global-replication-group-idThe name of the Global datastore

--ip-discoveryThe network type you choose when creating a replication group, either ipv4 | ipv6.

--kms-key-idThe ID of the KMS key used to encrypt the disk in the cluster.

--log-delivery-configurationsSpecifies the destination, format and type of the logs.

--multi-az-enabledA flag indicating if you have Multi-AZ enabled to enhance fault tolerance.

--network-typeMust be either ipv4 | ipv6 | dual_stack.

--node-group-configurationA list of node group (shard) configuration options.

--notification-topic-arnThe Amazon Resource Name (ARN) of the Amazon Simple Notification Service (SNS) topic to which notifications are sent.

--num-cache-clustersThe number of clusters this replication group initially has.

--num-node-groupsAn optional parameter that specifies the number of node groups (shards) for this Valkey or Redis OSS (cluster mode enabled) replication group.

--portThe port number on which each member of the replication group accepts connections.

--preferred-cache-cluster-azsA list of EC2 Availability Zones in which the replication group's clusters are created.

--preferred-maintenance-windowSpecifies the weekly time range during which maintenance on the cluster is performed.

--primary-cluster-idThe identifier of the cluster that serves as the primary for this replication group.

--replicas-per-node-groupAn optional parameter that specifies the number of replica nodes in each node group (shard).

--replication-group-descriptionA user-created description for the replication group.

--replication-group-idThe replication group identifier.

--security-group-idsOne or more Amazon VPC security groups associated with this replication group.

--serverless-cache-snapshot-nameThe name of the snapshot used to create a replication group.

--snapshot-arnsA list of Amazon Resource Names (ARN) that uniquely identify the Valkey or Redis OSS RDB snapshot files stored in Amazon S3.

--snapshot-nameThe name of a snapshot from which to restore data into the new replication group.

--snapshot-retention-limitThe number of days for which ElastiCache retains automatic snapshots before deleting them.

--snapshot-windowThe daily time range (in UTC) during which ElastiCache begins taking a daily snapshot of your node group (shard).

--tagsA list of tags to be added to this resource.

--transit-encryption-enabledA flag that enables in-transit encryption when set to true.

--transit-encryption-modeA setting that allows you to migrate your clients to use in-transit encryption, with no downtime.

--user-group-idsThe user group to associate with the replication group.