---
title: "s3replicationpeer list"
slug: "s3replicationpeer-list"
tags: ["5.4"]
updated: 2026-10-28T01:52:52Z
published: 2026-10-28T01:52:52Z
canonical: "docs.vastdata.com/s3replicationpeer-list"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vastdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# s3replicationpeer list

This command lists s3 replication peers.

##### Usage

```plaintext
s3replicationpeer list [--aws-region AWS_REGION]
                       [--bucket-name BUCKET_NAME]
                       [--custom-bucket-url CUSTOM_BUCKET_URL]
                       [--http-protocol http|https]
                       [--id ID]
                       [--name NAME]
```

##### Options

| `--aws-region AWS_REGION` | Filters the list by AWS region. |
| --- | --- |
| `--bucket-name BUCKET_NAME` | Filters the list by bucket name. |
| `--custom-bucket-url CUSTOM_BUCKET_URL` | Filters the list by custom bucket URL. |
| `--http-protocol http\|https` | Filters the list by HTTP protocol. |
| `--id ID` | Filters the list by ID. |
| `--name NAME` | Filters the list by target name. |

##### Example

This command lists S3 replication peers with the name *AWS-S3_TARGET*.

```plaintext
vcli: admin> s3replicationpeer list --name AWS-S3-TARGET
+----+---------------+----------+-------------+---------------+-------------------+------------+
| ID | Name          | State    | Bucket-name | Http-protocol | Custom-bucket-url | Aws-region |
+----+---------------+----------+-------------+---------------+-------------------+------------+
| 5  | AWS-S3-TARGET | ACTIVE   | my-s3-bucket| https         | None              | us-east-1  |
+----+---------------+----------+-------------+---------------+-------------------+------------+
```