34cf55934a
mc RELEASE.2023-07-18T21-05-38Z - Replaces mc replicate diff with mc replicate backlog - Adds mc support top net mc RELEASE.2023-07-07T05-25-51Z - Adds mc support perf site-replication - Deprecates mc admin replicate --sync flag in favor of new mc admihn replicate --mode flag - Updates output example of mc admin user info to show authentication info Partially addresses #930
5.1 KiB
mc replicate backlog
minio
Table of Contents
mc replicate diff
mc replicate backlog
mc.RELEASE.2023-07-18T21-05-38Z
mc replicate diff has been renamed
mc replicate backlog. No functionality has changed.
Description
The mc replicate backlog shows a list of unreplicated new
or deleted objects.
You can list the replication status of objects for a particular
remote target. To do so, you must have the ARN of the remote target. You
can use retrieve the remote targets configured for a bucket <minio-retrieve-remote-bucket-targets>
to find the ARN.
Syntax
EXAMPLE
The following command shows new or deleted objects in the
notes bucket of the teamorange/projects prefix
on the myminio alias that have not yet replicated to a
specific remote target bucket. The remote target's ARN is
arn:minio:replication::3bb8c736-4014-42c5-b3cb-d64e3ebaa75e:notes.
mc replicate backlog myminio/notes/teamorange/projects --arn arn:minio:replication::3bb8c736-4014-42c5-b3cb-d64e3ebaa75e:notesIf any new or deleted objects have not yet replicated, the command outputs something similar to the following:
[0001-01-01 00:00:00 UTC] [2022-10-06 17:18:59 UTC] 478efe49-aa9d-46ab-8268-45b70cc4c341 PUT agenda.docx
[0001-01-01 00:00:00 UTC] [2022-10-06 17:18:15 UTC] b283bf43-319f-455a-a779-3c2e669fad88 PUT budget-meeting.docxIn the output, PUT corresponds to a new object. Deleted
objects or versions would show DEL.
SYNTAX
The command has the following syntax:
mc [GLOBALFLAGS] replicate backlog \
[--arn "string"] \
TARGETParameters
TARGET
The path to the alias, prefix, or object.
arn
The ARN of the remote bucket to check for new or deleted objects that have not yet replicated.
When specified, the command returns a list of any new or deleted objects that have not replicated to the remote target. If not specified, the command returns a list of new or deleted objects on the source deployment that have not replicated to any remote target.
Global Flags
Examples
View Unreplicated Versions of Objects at a Prefix
Display unreplicated PUT and DELETE actions
for a prefix:
mc replicate backlog myminio/mybucket/path/to/prefix- Replace
myminio/mybucketwith the~mc replicate add ALIASand full bucket path for which to create the replication configuration. - Replace
path/to/prefixwith the prefix or object to use for the request.
If unreplicated objects exist, the output returns a list of the actions that created or removed objects at the prefix that have not replicated to a remote target:
[0001-01-01 00:00:00 UTC] [2022-10-06 17:18:59 UTC] 478efe49-aa9d-46ab-8268-45b70cc4c341 PUT agenda.docx
[0001-01-01 00:00:00 UTC] [2022-10-06 17:18:15 UTC] b283bf43-319f-455a-a779-3c2e669fad88 PUT budget-meeting.docxView Unreplicated Objects at a Specific Remote Target
The following mc replicate backlog command shows unreplicated objects
at an alias/bucket/prefix path for a specific remote target:
mc replicate backlog myminio/mybucket/path/to/prefix --arn <remote-arn>- Replace
myminio/mybucketwith the~mc replicate add ALIASand full bucket path for which to show unreplicated objects. - Replace the
path/to/prefixwith the desired prefix or object path. - Replace
<remote-arn>with the resource number for a specific remote target.
If unreplicated objects exist, the output returns a list of the actions that created or removed objects that have not replicated to the remote target:
[0001-01-01 00:00:00 UTC] [2022-10-06 17:18:59 UTC] 478efe49-aa9d-46ab-8268-45b70cc4c341 PUT agenda.docx
[0001-01-01 00:00:00 UTC] [2022-10-06 17:18:15 UTC] b283bf43-319f-455a-a779-3c2e669fad88 PUT budget-meeting.docx