`mc legalhold set`

語法

mc legalhold set 命令會在物件或多個物件上啟用法律保留一次寫入、多次讀取 (WORM) 物件鎖定。

mc legalhold 要求指定的儲存桶已啟用物件鎖定。您只能在建立儲存桶時啟用物件鎖定。請參閱 mc mb --with-lock 以了解如何建立已啟用物件鎖定的儲存桶的文件。

範例

以下命令會在 myminio MinIO 部署上的 mydata 儲存桶中，對所有現有物件啟用法律保留 WORM 鎖定

mc legalhold set --recursive myminio/mydata

語法

此命令具有以下語法

mc [GLOBALFLAGS] legalhold set  \
                 [--recursive]  \
                 [--rewind]     \
                 [--version-id] \
                 ALIAS

方括號 [] 表示選用參數。
同一行的參數彼此相依。
使用管道 | 運算子分隔的參數互斥。

將範例複製到文字編輯器，並在終端機/shell 中執行命令之前，根據需要進行修改。

參數

ALIAS

必填

MinIO 的別名和要啟用法律保留的物件路徑。例如：

mc legalhold set play/mybucket/myobjects/objects.txt

--recursive, r: 選用
將法律保留套用至 ALIAS 儲存桶或儲存桶前綴中的所有現有物件。

--recursive 僅適用於現有物件

若要為未來物件啟用法律保留，請在建立新物件時定期重複執行 mc legalhold 命令。

--rewind

選用

指示 mc legalhold set 僅對指定時間點存在的物件版本進行操作。

若要回溯到過去的特定日期，請將日期指定為 ISO8601 格式的時間戳記。例如：--rewind "2020.03.24T10:00"。
若要回溯一段時間，請以 #d#hh#mm#ss 格式指定持續時間字串。例如：--rewind "1d2hh3mm4ss"。

--rewind 要求指定的 ALIAS 必須是支援儲存桶版本控制的 S3 相容服務。對於 MinIO 部署，請使用 mc version 啟用或停用儲存桶版本控制。

--version-id, vid

選用

指示 mc legalhold set 僅對指定的物件版本進行操作。

--version-id 要求指定的 ALIAS 必須是支援儲存桶版本控制的 S3 相容服務。對於 MinIO 部署，請使用 mc version 啟用或停用儲存桶版本控制。

全域旗標

此命令支援任何全域旗標。

範例

使用 mc legalhold set 在物件上啟用法律保留

mc legalhold set [--recursive] ALIAS/PATH

將 ALIAS 替換為 S3 相容主機的別名。
將 PATH 替換為 S3 相容主機上儲存桶或物件的路徑。如果指定儲存桶或儲存桶前綴的路徑，請包含 --recursive 選項。

行為

法律保留需要明確移除

法律保留是無限期的，並強制鎖定物件的完全不可變性。只有具有 s3:PutObjectLegalHold 權限的特權使用者才能設定或解除法律保留。

法律保留與其他保留模式互補

法律保留與治理模式和合規模式保留設定互補。在法律保留和 治理/合規 保留規則下保留的物件，在解除法律保留且規則過期之前，仍會保持 WORM 鎖定。

對於 治理 鎖定的物件，法律保留會防止變更物件，即使使用者具有繞過保留的必要權限。

S3 相容性

mc 命令列工具是為與 AWS S3 API 相容而建置，並已使用 MinIO 和 AWS S3 進行測試，以確保預期的功能和行為。

MinIO 不保證其他 S3 相容服務，因為它們的 S3 API 實作未知，因此不受支援。雖然 mc 命令可能會如文件所述運作，但任何此類使用均由您自行承擔風險。