minio/docs
1
0
Fork 0
mirror of https://github.com/minio/docs.git synced 2025-07-02 05:02:40 +03:00
Code Activity
Files
rename
docs/source/reference/minio-mc/mc-replicate-status.rst
Daryl White 840417a6f7 Doc updates for mc RELEASE.2023-03-20T17-17-53Z (#799) 
- Adds note that `mc support proxy set|remove` no longer require
registration
- Adds info about stale ARNs for `mc replicate status` command
- Additional information for --dry-run flag in `mc rm`
- Thoroughly updates and restructures `mc admin policy` commands
- Adds new `mc batch cancel` command
- Updates deprecated commands for newly deprecated mc admin policy
functions
- Fixes toctree on mc admin page to allow for mc admin policy subcommand
nesting

Closes #766

Other fixes not part of the release:
- Updates `--fake` flag on `mc rm` to `--dry-run`
- Updates `--fake` flag on `mc mirror` to `--dry-run`
2023-04-05 10:50:40 -05:00

3.6 KiB
Raw Permalink Blame History

mc replicate status

minio

Table of Contents

mc replicate status

Syntax

The mc replicate status command displays the replication status <minio-bucket-replication-serverside> of a MinIO bucket. The status also lists the remote target path or location.

EXAMPLE

The following command displays the current replication status of the mydata bucket on the myminio MinIO deployment:

mc replicate status myminio/mydata

SYNTAX

The command has the following syntax:

mc [GLOBALFLAGS] replicate status TARGET
                           [--limit-upload value]
                           [--limit-download value]

Parameters

ALIAS

The alias <alias> of the MinIO deployment and full path to the bucket or bucket prefix for which to display the replication status. For example:

mc replicate status myminio/mybucket
--limit-download

Limit download rates to no more than a specified rate in KiB/s, MiB/s, or GiB/s. Valid units include:

  • B for bytes
  • K for kilobytes
  • G for gigabytes
  • T for terabytes
  • Ki for kibibytes
  • Gi for gibibytes
  • Ti for tebibytes

For example, to limit download rates to no more than 1 GiB/s, use the following:

--limit-download 1G

If not specified, MinIO uses an unlimited download rate.

--limit-upload

Limit upload rates to no more than the specified rate in KiB/s, MiB/s, or GiB/s. Valid units include:

  • B for bytes
  • K for kilobytes
  • G for gigabytes
  • T for terabytes
  • Ki for kibibytes
  • Gi for gibibytes
  • Ti for tebibytes

For example, to limit upload rates to no more than 1 GiB/s, use the following:

--limit-upload 1G

If not specified, MinIO uses an unlimited upload rate.

Global Flags

Examples

Display Replication Status

Use mc replicate status to show bucket replication status:

mc replicate status ALIAS/PATH
  • Replace ALIAS <mc replicate status ALIAS> with the alias <mc alias> of the MinIO deployment.
  • Replace PATH <mc replicate status ALIAS> with the path to the bucket or bucket prefix.

Behavior

Removed and Re-added ARNs

mc RELEASE.2023-03-20T17-17-53Z

The standard output of this command does not display ARNs previously removed from a replication configuration.

To list all ARNs, including ARNs no longer part of the replication, use the --json flag. The json output continues to show data replicated under old ARNs. This may be valuable if an ARN was removed and re-added for the same bucket.

New ARNs do not cause re-replication of previously synced objects.