mc replicate update

参数

ALIAS

Required

MinIO 部署的别名（ alias ）以及要修改复制规则的存储桶或存储桶前缀的完整路径。 例如：

mc replicate update --id "c75nrap4b0talo3ipthg" [FLAGS]

--id

Required

指定配置的复制规则的唯一 ID。 使用 mc replicate ls 命令来列出一个存储桶的复制规则。

--bandwidth

Optional

将带宽限制设置为不超过指定的速率，单位可以是 KiB/s（千字节每秒）、MiB/s（兆字节每秒）或 GiB/s（吉字节每秒）。 有效单位包括：

• B for bytes

• K for kilobytes

• G for gigabytes

• T for terabytes

• Ki for kibibytes

• Gi for gibibytes

• Ti for tebibytes

例如，要将带宽速率限制为不超过 1 GiB/s，请使用以下命令：

--limit-upload 1Gi

如果未指定，MinIO 不会限制带宽速率。

--healthcheck-seconds

Optional

远程桶健康状态检查之间的时间长度，以秒为单位。

如果未指定，MinIO 默认使用 60 秒的时间间隔进行健康检查。

--limit-download

Optional

将下载速率限制在不超过指定的速率，单位可以是 KiB/s（千字节每秒）、MiB/s（兆字节每秒）或 GiB/s（吉字节每秒）。 有效单位包括：

• B for bytes

• K for kilobytes

• G for gigabytes

• T for terabytes

• Ki for kibibytes

• Gi for gibibytes

• Ti for tebibytes

例如，如果要将下载速率限制在不超过1 GiB/s，可以使用以下命令：

--limit-download 1G

如果未指定，MinIO 将使用不限下载速率。

--limit-upload

:optional:

将上传速率限制在不超过指定的速率，单位可以是 KiB/s（千字节每秒）、MiB/s（兆字节每秒）或 GiB/s（吉字节每秒）。 有效单位包括：

• B for bytes

• K for kilobytes

• G for gigabytes

• T for terabytes

• Ki for kibibytes

• Gi for gibibytes

• Ti for tebibytes

例如，要将上传速率限制为不超过1 GiB/s，可以使用以下方法：

--limit-upload 1G

如果未指定，MinIO将使用无限上传速率。

--path

Optional

为远程存储桶启用路径式查找支持。

有效值包括：

• on - 使用路径查找来查找远程桶

• off - 使用资源定位器风格（如域名或IP地址）查找远程桶

• auto - 请MinIO确定使用哪种查找方式来找到远程桶。

当未定义时，MinIO 使用默认值 auto 。

--priority

Optional

指定复制规则的整数优先级。 该值 必须 在源桶上的所有其他规则中是唯一的。 较高值意味着 高于 所有其他规则的优先级。

--proxy

Optional

在定义桶之间的活跃-活跃复制时，不要使用代理。

有效值包括：

• enable - 在active-active复制中启用代理。

• disable - 在active-active复制中禁用代理。

默认情况下，MinIO 设置为 enable 。

--remote-bucket

Optional

指定远程位置的凭据、目标部署和桶。 值可以是 alias 和桶、基于位置的（IP或URL）或基于路径的。

例如，基于URL的目标可能如下所示：

--remote-bucket https://user:secret@myminio.cloudprovider.tld:9001/bucket

基于别名的目标可能如下所示：

--remote-bucket minio-target/my-bucket

--replicate

Optional

指定以下值的逗号分隔列表以启用扩展复制功能：

• delete - 指示MinIO将:ref:DELETE operations <minio-object-delete> 复制到目标桶。

• delete-marker - 指示MinIO将删除标记复制到目标桶。

• replica-metadata-sync - 指示 MinIO 将复制的对象上仅包含元数据的变化同步回源。 此功能仅影响 two-way active-active 复制配置。

省略此值将指示MinIO停止将仅包含元数据的更改复制回源。

• existing-objects - 指示 MinIO 复制在配置或启用复制之前创建的对象。 MinIO 默认 不会 将现有的对象同步到远程目标。

  更多信息，请参见 现有对象的复制。

--state

Optional

启用或禁用复制规则。 请指定以下之一值：

• enable - 启用复制规则。

• disable - 禁用复制规则。

在复制禁用期间创建的对象，在启用规则后并不会立即符合复制条件。 你必须显式启用现有对象的复制，通过将 existing-objects 包含在传递给 mc replicate update --replicate 的复制特性列表中。

更多信息，请参见 现有对象的复制。

--storage-class

Optional

指定应用于复制对象的 MinIO 存储类。

--sync

Optional

为这个远程目标启用同步复制。

默认情况下，MinIO 使用异步复制。

--tags

Optional

指定一个或多个由与号 & 分隔的键值对标签，MinIO 使用这些标签来过滤要复制的对象。例如：

mc replicate update --id "ID" --tags "TAG1=VALUE&TAG2=VALUE&TAG3=VALUE"

MinIO 将复制规则应用于任何具有指定复制标签的 标签集的对象。

全局标记

此命令支持任何 全局标志。

修改现有复制规则

使用 mc replicate update 修改现有的复制规则。

mc replicate update ALIAS/PATH \
   --id ID                     \
   [--FLAGS]

• 将 ALIAS 替换为 MinIO 部署的 alias。

• 将 PATH 替换为规则存在的存储桶或存储桶前缀的路径。

• 将 ID 替换为要修改的规则的唯一标识符。 使用 mc replicate ls 命令来检索存储桶上的复制规则及其相应的标识符列表。

更新现有复制规则的凭据

使用 mc replicate update 修改现有的复制规则。

mc replicate update ALIAS/PATH \
   --id ID                     \
   --remote-bucket https://user:secret@minio.mycloud.tld:9001/mybucket

• 将 ALIAS 替换为 MinIO 部署的 alias。

• 将 PATH 替换为规则存在的存储桶或存储桶前缀的路径。

• 将 ID 替换为更新的凭据、路径和存储桶。

禁用或启用现有复制规则

使用 mc replicate update 命令配合 --state 标志来禁用或启用一个复制规则。

mc replicate update ALIAS/PATH \
   --id ID \
   --state "disable"|"enable"

• 将 ALIAS 替换为 MinIO 部署的 alias。

• 将 PATH 替换为规则存在的存储桶或存储桶前缀的路径。

• 将 ID 替换为要修改的规则的唯一标识符。 使用 mc replicate ls 命令来检索存储桶上的复制规则及其相应的标识符列表。

• 向 --state 标志指定 disable 或 enable 来禁用或启用复制规则。

所需权限

MinIO 强烈建议为支持存储桶复制操作创建特定的用户。 有关向 MinIO 部署添加用户和策略的更完整文档，请参见 mc admin user 和 mc admin policy。

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Action": [
                "admin:SetBucketTarget",
                "admin:GetBucketTarget"
            ],
            "Effect": "Allow",
            "Sid": "EnableRemoteBucketConfiguration"
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ListBucket",
                "s3:ListBucketMultipartUploads",
                "s3:GetBucketLocation",
                "s3:GetBucketVersioning",
                "s3:GetObjectRetention",
                "s3:GetObjectLegalHold",
                "s3:PutReplicationConfiguration"
            ],
            "Resource": [
                "arn:aws:s3:::*"
            ],
            "Sid": "EnableReplicationRuleConfiguration"
        }
    ]
}

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ListBucket",
                "s3:ListBucketMultipartUploads",
                "s3:GetBucketLocation",
                "s3:GetBucketVersioning",
                "s3:GetBucketObjectLockConfiguration",
                "s3:GetEncryptionConfiguration"
            ],
            "Resource": [
                "arn:aws:s3:::*"
            ],
            "Sid": "EnableReplicationOnBucket"
        },
        {
            "Effect": "Allow",
            "Action": [
                "s3:GetReplicationConfiguration",
                "s3:ReplicateTags",
                "s3:AbortMultipartUpload",
                "s3:GetObject",
                "s3:GetObjectVersion",
                "s3:GetObjectVersionTagging",
                "s3:PutObject",
                "s3:PutObjectRetention",
                "s3:PutBucketObjectLockConfiguration",
                "s3:PutObjectLegalHold",
                "s3:DeleteObject",
                "s3:ReplicateObject",
                "s3:ReplicateDelete"
            ],
            "Resource": [
                "arn:aws:s3:::*"
            ],
            "Sid": "EnableReplicatingDataIntoBucket"
        }
    ]
}

S3兼容性

mc 命令行工具是为了与 AWS S3 API 兼容而构建的，并且已经过测试， 以确保在与 MinIO 和 AWS S3 配合使用时，功能和行为符合预期。

MinIO 不对其他 S3 兼容服务提供任何保证，因为它们的 S3 API 实现是 未知的，因此不受支持。尽管 mc 命令 可能 如文档中所 述工作，但任何此类使用都是您自己的风险。