# Viewing a replication group's details
<a name="Replication.ViewDetails"></a>

There are times you may want to view the details of a replication group. You can use the ElastiCache console, the AWS CLI for ElastiCache, or the ElastiCache API. The console process is different for Valkey or Redis OSS (cluster mode disabled) and Valkey or Redis OSS (cluster mode enabled).

**Contents**
+ [Viewing a Valkey or Redis OSS (Cluster Mode Disabled) with replicas](Replication.ViewDetails.Redis.md)
  + [Using the ElastiCache Console](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.CON)
  + [Using the AWS CLI](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.CLI)
  + [Using the ElastiCache API](Replication.ViewDetails.Redis.md#Replication.ViewDetails.Redis.API)
+ [Viewing a replication group: Valkey or Redis OSS (Cluster Mode Enabled)](Replication.ViewDetails.RedisCluster.md)
  + [Using the ElastiCache Console](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.CON)
  + [Using the AWS CLI](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.CLI)
  + [Using the ElastiCache API](Replication.ViewDetails.RedisCluster.md#Replication.ViewDetails.RedisCluster.API)
+ [Viewing a replication group's details (AWS CLI)](Replication.ViewDetails.CLI.md)
+ [Viewing a replication group's details (ElastiCache API)](Replication.ViewDetails.API.md)

# Viewing a Valkey or Redis OSS (Cluster Mode Disabled) with replicas
<a name="Replication.ViewDetails.Redis"></a>

You can view the details of a Valkey or Redis OSS (cluster mode disabled) cluster with replicas (API/CLI: *replication group*) using the ElastiCache console, the AWS CLI for ElastiCache, or the ElastiCache API.

**Contents**
+ [Using the ElastiCache Console](#Replication.ViewDetails.Redis.CON)
+ [Using the AWS CLI](#Replication.ViewDetails.Redis.CLI)
+ [Using the ElastiCache API](#Replication.ViewDetails.Redis.API)

## Viewing a Valkey or Redis OSS (Cluster Mode Disabled) Replication Group (Console)
<a name="Replication.ViewDetails.Redis.CON"></a>

To view the details of a Valkey or Redis OSS (cluster mode disabled) cluster with replicas using the ElastiCache console, see the topic [Viewing Valkey or Redis OSS (Cluster Mode Disabled) details (Console)](Clusters.ViewDetails.md#Clusters.ViewDetails.CON.Redis).

## Viewing a Valkey or Redis OSS (Cluster Mode Disabled) replication group (AWS CLI)
<a name="Replication.ViewDetails.Redis.CLI"></a>

For an AWS CLI example that displays a Valkey or Redis OSS (cluster mode disabled) replication group's details, see [Viewing a replication group's details (AWS CLI)](Replication.ViewDetails.CLI.md).

## Viewing a Valkey or Redis OSS (Cluster Mode Disabled) Replication Group (ElastiCache API)
<a name="Replication.ViewDetails.Redis.API"></a>

For an ElastiCache API example that displays a Valkey or Redis OSS (cluster mode disabled) replication group's details, see [Viewing a replication group's details (ElastiCache API)](Replication.ViewDetails.API.md).

# Viewing a replication group: Valkey or Redis OSS (Cluster Mode Enabled)
<a name="Replication.ViewDetails.RedisCluster"></a>

## Viewing a Valkey or Redis OSS (Cluster Mode Enabled) cluster (Console)
<a name="Replication.ViewDetails.RedisCluster.CON"></a>

To view the details of a Valkey or Redis OSS (cluster mode enabled) cluster using the ElastiCache console, see [Viewing details for a Valkey or Redis OSS (Cluster Mode Enabled) cluster (Console)](Clusters.ViewDetails.md#Clusters.ViewDetails.CON.RedisCluster).

## Viewing a Valkey or Redis OSS (Cluster Mode Enabled) cluster (AWS CLI)
<a name="Replication.ViewDetails.RedisCluster.CLI"></a>

For an ElastiCache CLI example that displays a Valkey or Redis OSS (cluster mode enabled) replication group's details, see [Viewing a replication group's details (AWS CLI)](Replication.ViewDetails.CLI.md).

## Viewing a Valkey or Redis OSS (Cluster Mode Enabled) Cluster (ElastiCache API)
<a name="Replication.ViewDetails.RedisCluster.API"></a>

For an ElastiCache API example that displays a Valkey or Redis OSS (cluster mode enabled) replication group's details, see [Viewing a replication group's details (ElastiCache API)](Replication.ViewDetails.API.md).

# Viewing a replication group's details (AWS CLI)
<a name="Replication.ViewDetails.CLI"></a>

You can view the details for a replication group using the AWS CLI `describe-replication-groups` command. Use the following optional parameters to refine the listing. Omitting the parameters returns the details for up to 100 replication groups.

**Optional Parameters**
+ `--replication-group-id` – Use this parameter to list the details of a specific replication group. If the specified replication group has more than one node group, results are returned grouped by node group.
+ `--max-items` – Use this parameter to limit the number of replication groups listed. The value of `--max-items` cannot be less than 20 or greater than 100.

**Example**  
The following code lists the details for up to 100 replication groups.  

```
aws elasticache describe-replication-groups
```
The following code lists the details for `sample-repl-group`.  

```
aws elasticache describe-replication-groups --replication-group-id sample-repl-group
```
The following code lists the details for `sample-repl-group`.  

```
aws elasticache describe-replication-groups --replication-group-id sample-repl-group
```
The following code list the details for up to 25 replication groups.  

```
aws elasticache describe-replication-groups --max-items 25
```
Output from this operation should look something like this (JSON format).  

```
{
   "ReplicationGroups": [
     {
       "Status": "available", 
       "Description": "test", 
       "NodeGroups": [
         {
            "Status": "available", 
               "NodeGroupMembers": [
                  {
                     "CurrentRole": "primary", 
                     "PreferredAvailabilityZone": "us-west-2a", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "rg-name-001.1abc4d.0001.usw2.cache.amazonaws.com"
                     }, 
                     "CacheClusterId": "rg-name-001"
                  }, 
                  {
                     "CurrentRole": "replica", 
                     "PreferredAvailabilityZone": "us-west-2b", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "rg-name-002.1abc4d.0001.usw2.cache.amazonaws.com"
                     }, 
                     "CacheClusterId": "rg-name-002"
                  }, 
                  {
                     "CurrentRole": "replica", 
                     "PreferredAvailabilityZone": "us-west-2c", 
                     "CacheNodeId": "0001", 
                     "ReadEndpoint": {
                        "Port": 6379, 
                        "Address": "rg-name-003.1abc4d.0001.usw2.cache.amazonaws.com"
                     }, 
                     "CacheClusterId": "rg-name-003"
                  }
               ], 
               "NodeGroupId": "0001", 
               "PrimaryEndpoint": {
                  "Port": 6379, 
                  "Address": "rg-name.1abc4d.ng.0001.usw2.cache.amazonaws.com"
               }
            }
         ], 
         "ReplicationGroupId": "rg-name", 
         "AutomaticFailover": "enabled", 
         "SnapshottingClusterId": "rg-name-002", 
         "MemberClusters": [
            "rg-name-001", 
            "rg-name-002", 
            "rg-name-003"
         ], 
         "PendingModifiedValues": {}
      }, 
      {
      ... some output omitted for brevity
      }
   ]
}
```

For more information, see the AWS CLI for ElastiCache topic [describe-replication-groups](https://docs.aws.amazon.com/cli/latest/reference/elasticache/describe-replication-groups.html).

# Viewing a replication group's details (ElastiCache API)
<a name="Replication.ViewDetails.API"></a>

You can view the details for a replication using the AWS CLI `DescribeReplicationGroups` operation. Use the following optional parameters to refine the listing. Omitting the parameters returns the details for up to 100 replication groups.

**Optional Parameters**
+ `ReplicationGroupId` – Use this parameter to list the details of a specific replication group. If the specified replication group has more than one node group, results are returned grouped by node group.
+ `MaxRecords` – Use this parameter to limit the number of replication groups listed. The value of `MaxRecords` cannot be less than 20 or greater than 100. The default is 100.

**Example**  
The following code list the details for up to 100 replication groups.  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=DescribeReplicationGroups
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```
The following code lists the details for `myReplGroup`.  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=DescribeReplicationGroups
   &ReplicationGroupId=myReplGroup
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```
The following code list the details for up to 25 clusters.  

```
https://elasticache.us-west-2.amazonaws.com/
   ?Action=DescribeReplicationGroups
   &MaxRecords=25
   &Version=2015-02-02
   &SignatureVersion=4
   &SignatureMethod=HmacSHA256
   &Timestamp=20150202T192317Z
   &X-Amz-Credential=<credential>
```

For more information, see the ElastiCache API reference topic [DescribeReplicationGroups](https://docs.aws.amazon.com/AmazonElastiCache/latest/APIReference/API_DescribeReplicationGroups.html).