文档

mc replicate rm

Changed in version RELEASE.2022-12-24T15-21-38Z: mc replicate rm 替代 mc admin bucket remote rm 命令。 删除复制配置时会自动删除其底层远程目标。

语法

mc replicate rm 命令用于从 MinIO 存储桶中删除 replication rule

mc replicate remove 命令与 mc replicate rm 功能等价。

mc [GLOBALFLAGS] replicate rm FLAGS [FLAGS] ALIAS

以下命令从 myminio MinIO 部署中的 mydata 存储桶删除指定 id 的复制规则:

mc replicate rm --id "c76um9h4b0t1ijr36mug" myminio/mydata

命令语法如下:

mc [GLOBALFLAGS] replicate rm     \
                 --id "string"    \
                 [--all --force]  \
                 ALIAS
  • 方括号 [] 表示可选参数。

  • 同一行中的参数彼此相互依赖。

  • 使用管道符 | 分隔的参数彼此互斥。

请先将示例复制到文本编辑器中并按需修改,再在终端 / shell 中运行命令。

参数

ALIAS

必需 MinIO 部署的 alias,以及要删除复制规则的 存储桶或存储桶前缀的完整路径。例如:

mc replicate rm --id "ID" myminio/mybucket
--id

必需 指定已配置复制规则的唯一 ID。

如果指定 --all,则可省略此选项

--all

可选 删除指定存储桶上的所有复制规则。要求同时指定 --force 标志。

--force

可选 当指定 --all 时必需。

全局标志

此命令支持 全局标志 中的任意选项。

示例

从存储桶中删除一条复制规则

使用 mc replicate rm 删除存储桶复制规则:

mc replicate rm --id "ID" ALIAS/PATH
  • ID 替换为要删除的复制规则唯一 ID。 使用 mc replicate ls 列出该存储桶的所有复制规则。

  • ALIAS 替换为 MinIO 部署的 alias

  • PATH 替换为存储桶或存储桶前缀的路径。

从存储桶中删除所有复制规则

使用 mc replicate rm 删除存储桶复制规则:

mc replicate rm --all --force ALIAS/PATH
  • ALIAS 替换为 MinIO 部署的 alias

  • PATH 替换为存储桶或存储桶前缀的路径。

行为

删除复制规则不会影响已复制对象

删除存储桶的一条或全部复制规则,不会 删除已按这些规则复制的任何对象。

使用此命令或 mc rb 命令可删除远程目标上的已复制对象。 你可以通过 X-Amz-Replication-Status 元数据字段识别已复制对象,其值为 REPLICA。包含来自多个复制源对象的存储桶在删除前可能需要额外的 处理与过滤,以确定对象来源。

S3 兼容性

mc 命令行工具以兼容 AWS S3 API 为目标构建,并针对 MinIO 和 AWS S3 进行了测试,以验证预期的功能与行为。

对于其他 S3 兼容服务,MinIO 不提供任何保证,因为这些服务的 S3 API 实现未知, 因此不在支持范围内。虽然 mc 命令 可能 仍能按文档说明工作,但此类 用法需要你自行承担风险。