mc admin bucket remote

描述

mc admin bucket remote 命令用于管理 ARN 资源, 供 bucket replication 使用。

示例

添加新的复制目标

使用 mc admin bucket remote add 创建一个新的复制目标 ARN,供 mc replicate add 使用:

mc admin bucket remote add SOURCE/BUCKET DESTINATION/BUCKET
  • SOURCE 替换为 作为复制目标的 MinIO 部署的 alias。 将 BUCKET 替换为存储桶完整路径,MinIO 会将来自 DESTINATION 的对象复制到该存储桶。
  • DESTINATION 替换为 作为复制源的 MinIO 部署的 alias。 将 BUCKET 替换为存储桶完整路径,MinIO 会从该存储桶复制对象到 SOURCE

删除现有复制目标

使用 mc admin bucket remote rm 从存储桶中删除复制目标:

mc admin bucket remote rm SOURCE/BUCKET --arn ARN
  • SOURCE 替换为 作为复制源使用的 MinIO 部署的 alias。 将 BUCKET 替换为 MinIO 复制对象来源存储桶的完整路径。
  • ARN 替换为 远程目标的 ARN。

删除该目标会停止所有正在进行的、 发往该目标的 bucket replication

查询已配置的复制目标

使用 mc replicate ls 列出存储桶已配置的复制目标:

mc replicate ls ALIAS/PATH
  • ALIAS 替换为 作为复制源使用的 MinIO 部署的 alias。 将 PATH 替换为 MinIO 复制对象来源存储桶的完整路径。

语法

mc admin bucket remote add

mc-cmd

在 MinIO 部署上的存储桶中添加远程目标。该命令语法如下:

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

该命令接受以下参数:

SOURCE

mc-cmd

Required

要添加远程目标的存储桶完整路径。 指定已配置 MinIO 部署的 alias 作为存储桶路径前缀。例如:

mc admin bucket remote add play/mybucket

DESTINATION

mc-cmd

Required

目标 MinIO 部署和存储桶。

使用以下格式指定目标 MinIO 部署和存储桶的完整 URL:

http(s)://ACCESSKEY:SECRETKEY@DESTHOSTNAME/DESTBUCKET
  • ACCESSKEY 替换为目标 MinIO 部署上某个用户的 access key。

  • SECRETKEY 替换为目标 MinIO 部署上某个用户的 secret key。

  • DESTHOSTNAME 替换为 MinIO 部署的主机名和端口

    (例如 minio-server.example.net:9000)。

  • DESTBUCKET 替换为目标端的存储桶。

--service

mc-cmd

Required

指定为 "replication"

--region

mc-cmd

DESTINATION 的地域。

add 互斥。

--path

mc-cmd

目标服务器支持的存储桶路径查找方式。指定以下之一:

  • on
  • off
  • auto(默认)

add 互斥。

--sync

mc-cmd

启用同步复制模式,MinIO 会在返回 PUT 对象响应之前尝试复制对象。 同步复制可能会增加等待 PUT 操作成功返回的时间。

默认情况下,mc admin bucket remote add 以异步模式运行, MinIO 会在返回 PUT 对象响应之后尝试复制对象。

mc admin bucket remote ls

mc-cmd

列出 MinIO 部署上与某个存储桶关联的所有远程目标。 使用 mc admin bucket remote ls --help 查看用法语法。

mc admin bucket remote rm, remove

mc-cmd

删除 MinIO 部署上某个存储桶的远程目标。该命令语法如下:

mc admin bucket remote rm SOURCE --arn ARN

该命令接受以下参数:

SOURCE

mc-cmd

Required

要删除远程目标的源存储桶完整路径。 指定已配置 MinIO 部署的 alias 作为存储桶路径前缀。 例如:

mc admin bucket remote rm play/mybucket

ARN

mc-cmd

Required

要从目标存储桶中删除的远程目标 ARN。 使用 mc admin bucket remote ls 列出指定存储桶的所有远程目标及其对应的 ARN。

最后修改 August 2, 2026: init commit (8338d5b)

本页部分内容改编自 MinIO 对象存储文档,© 2020–至今 MinIO, Inc.,依据 CC BY 4.0 授权,由 Silo 项目转换与维护。归属与署名

本页为非官方中文翻译。如与英文原文有出入,以英文原文为准。