mc replicate update

參數

別名

必要

要修改複寫規則的 MinIO 部署的別名和儲存貯體或儲存貯體前置詞的完整路徑。例如

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

--id

必要

指定已設定複寫規則的唯一 ID。使用 mc replicate ls 命令來列出儲存貯體的複寫規則。

--bandwidth

選用

將頻寬速率限制為不超過指定的 KiB/s、MiB/s 或 GiB/s 速率。有效單位包括

• B 代表位元組

• K 代表千位元組

• G 代表十億位元組

• T 代表兆位元組

• Ki 代表千位元二進位

• Gi 代表十億位元二進位

• Ti 代表兆位元二進位

例如，若要將頻寬速率限制為不超過 1 GiB/s，請使用以下命令

--limit-upload 1Gi

如果未指定，MinIO 不會限制頻寬速率。

--healthcheck-seconds

選用

檢查遠端儲存貯體健全狀況的間隔時間 (以秒為單位)。

如果未指定，MinIO 會使用 60 秒的間隔。

--limit-download

選用

將下載速率限制為不超過指定的 KiB/s、MiB/s 或 GiB/s 速率。有效單位包括

• B 代表位元組

• K 代表千位元組

• G 代表十億位元組

• T 代表兆位元組

• Ki 代表千位元二進位

• Gi 代表十億位元二進位

• Ti 代表兆位元二進位

例如，若要將下載速率限制為不超過 1 GiB/s，請使用以下命令

--limit-download 1G

如果未指定，MinIO 會使用無限制的下載速率。

--limit-upload

選用

將上傳速率限制為不超過指定的 KiB/s、MiB/s 或 GiB/s 速率。有效單位包括

• B 代表位元組

• K 代表千位元組

• G 代表十億位元組

• T 代表兆位元組

• Ki 代表千位元二進位

• Gi 代表十億位元二進位

• Ti 代表兆位元二進位

例如，若要將上傳速率限制為不超過 1 GiB/s，請使用以下命令

--limit-upload 1G

如果未指定，MinIO 會使用無限制的上傳速率。

--path

選用

啟用遠端儲存貯體的路徑樣式查閱支援。

有效值包括

• on - 使用路徑查閱來尋找遠端儲存貯體

• off - 使用資源定位器樣式 (例如網域或 IP 位址) 查閱來尋找遠端儲存貯體

• auto - 要求 MinIO 識別要用來尋找遠端儲存貯體的正確查閱類型

如果未定義，MinIO 會使用 auto 值。

--priority

選用

指定複寫規則的整數優先順序。此值在來源儲存貯體上的所有其他規則中必須是唯一的。較高的值表示優先順序高於所有其他規則。

--proxy

選用

在儲存貯體之間定義主動-主動複寫時，請勿使用 Proxy。

有效值包括

• enable - 在主動-主動複寫中啟用 Proxy。

• disable - 在主動-主動複寫中停用 Proxy。

預設情況下，MinIO 預設為 enable。

--remote-bucket

選用

指定遠端位置的認證、目的地部署和儲存貯體。值可以是別名和儲存貯體、基於位置 (IP 或 URL) 或基於路徑。

例如，基於 URL 的目標可能如下所示

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

基於別名的目標可能如下所示

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

--replicate

選用

指定以下值的逗號分隔清單，以啟用延伸複寫功能

• delete - 指示 MinIO 將DELETE 作業複寫到目的地儲存貯體。

• delete-marker - 指示 MinIO 將刪除標記複寫到目的地儲存貯體。

• replica-metadata-sync - 指示 MinIO 將已複寫物件上的僅限中繼資料變更同步回來源。此功能僅影響雙向主動-主動複寫組態。

  省略此值會指示 MinIO 停止將僅限中繼資料變更複寫回來源。

• existing-objects - 指示 MinIO 將在設定或啟用複寫之前建立的物件複寫。MinIO 預設情況下不會將現有物件同步到遠端目標。

  如需詳細資訊，請參閱現有物件的複寫。

--state

選用

啟用或停用複寫規則。指定下列其中一個值

• "enable" - 啟用複寫規則。

• "disable" - 停用複寫規則。

停用複寫時建立的物件在啟用規則後不會立即符合複寫資格。您必須明確啟用現有物件的複寫，方法是將 "existing-objects" 加入指定給 mc replicate update --replicate 的複寫功能清單。

如需詳細資訊，請參閱現有物件的複寫。

--storage-class

選用

指定要應用於複製物件的 MinIO 儲存類別。

--sync

選用

為此遠端目標啟用同步複製。

預設情況下，MinIO 使用非同步複製。

--tags

選用

指定一個或多個以 & 符號分隔的鍵值對標籤，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 部署的別名。

• 將 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 部署的別名。

• 將 PATH 替換為規則存在的儲存桶或儲存桶前綴路徑。

• 將 ID 替換為更新的憑證、路徑和儲存桶。

停用或啟用現有的複製規則

使用 mc replicate update 和 --state 標誌來停用或啟用複製規則。

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

• 將 ALIAS 替換為 MinIO 部署的別名。

• 將 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 命令可能會按照文件所述運作，但任何此類使用均由您自行承擔風險。