`mc admin bucket remote`

Description

The bm admin bucket remote command manages the ARN resources for use with bucket replication.

Use mc admin on Buckit Deployments Only

Buckit does not support using bm admin commands with other S3-compatible services, regardless of their claimed compatibility with Buckit deployments.

Examples

Add a New Replication Target

Use bm admin bucket remote add to create a new replication target ARN for use with bm replicate add:

mc admin bucket remote add SOURCE/BUCKET DESTINATION/BUCKET

Replace SOURCE with the alias of the Buckit deployment to use as the replication target. Replace BUCKET with the full path of the bucket into which Buckit replicates objects from the DESTINATION.
Replace DESTINATION with the alias of the Buckit deployment to use as the replication source. Replace BUCKET with the full path of the bucket from which Buckit replicates objects into the SOURCE.

Remove an Existing Replication Target

Use bm admin bucket remote rm to remove a replication target from a bucket:

mc admin bucket remote rm SOURCE/BUCKET --arn ARN

Replace SOURCE with the alias of the Buckit deployment being used as the replication source. Replace BUCKET with the full path of the bucket from which Buckit replicates objects.
Replace ARN with the ARN of the remote target.

Removing the target halts all in-progress bucket replication to the target.

Retrieve Configured Replication Targets

Use bm replicate ls to list a bucket’s configured replication targets:

mc replicate ls ALIAS/PATH

Replace ALIAS with the alias of the Buckit deployment being used as the replication source. Replace PATH with the full path of the bucket from which Buckit replicates objects.

Syntax

bm admin bucket remote add

Changed in version RELEASE.2022-12-24T15-21-38Z:

mc admin bucket remote add replaced by bm replicate add

Adds a remote target to a bucket on a Buckit deployment. The command has the following syntax:

mc admin bucket remote add SOURCE DESTINATION --service "replication" [FLAGS]

The command accepts the following arguments:

SOURCE

Required

The full path to the bucket to which the command adds the remote target. Specify the alias of a configured Buckit deployment as the prefix to the bucket path. For example:

mc admin bucket remote add play/mybucket

DESTINATION

Required

The target Buckit deployment and bucket.

Specify the full URL to the destination Buckit deployment and bucket using the following format:

http(s)://ACCESSKEY:SECRETKEY@DESTHOSTNAME/DESTBUCKET

Replace ACCESSKEY with the access key for a user on the destination Buckit deployment.
Replace SECRETKEY with the secret key for a user on the destination Buckit deployment.
Replace DESTHOSTNAME with the hostname and port of the Buckit deployment (i.e. minio-server.example.net:9000).
Replace DESTBUCKET with the bucket on the destination.

--service

Required

Specify "replication".

--region

The region of the DESTINATION.

Mutually exclusive with add

--path

The bucket path lookup supported by the destination server. Specify one of the following:

on
off
auto (Default)

Mutually exclusive with add

--sync

Enables synchronous replication, where Buckit attempts to replicate the object prior to returning the PUT object response. Synchronous replication may increase the time spent waiting for PUT operations to return successfully.

By default, bm admin bucket remote add operates in asynchronous mode, where Buckit attempts replicating objects after returning the PUT object response.

bm admin bucket remote ls

Changed in version RELEASE.2022-12-24T15-21-38Z:

mc admin bucket remote ls replaced by bm replicate ls

Lists all remote targets associated to a bucket on the Buckit deployment. Use mc admin bucket remote ls --help for usage syntax.

bm admin bucket remote rm, remove

Changed in version RELEASE.2022-12-24T15-21-38Z:

mc admin bucket remote rm replaced by bm replicate rm

Removes a remote target for a bucket on the Buckit deployment. The command has the following syntax:

mc admin bucket remote rm SOURCE --arn ARN

The command accepts the following arguments:

SOURCE

Required

The full path to the bucket from which the command removes the remote target. Specify the alias of a configured Buckit deployment as the prefix to the bucket path. For example:

mc admin bucket remote rm play/mybucket

ARN

Required

The ARN of the remote target for which the command removes from the target bucket. Use bm admin bucket remote ls to list all remote targets and their associated ARNs for a specific bucket.