Erasure Code 計算器 
參考硬體 mc retention set
語法
mc retention set 命令會為儲存貯體中的物件或物件設定一次寫入多次讀取 (WORM) 鎖定設定。您也可以設定儲存貯體的預設物件鎖定設定，其中所有沒有明確物件鎖定設定的物件都會繼承儲存貯體的預設值。
若要在法律保留下鎖定物件，請使用mc legalhold set。
mc retention set需要指定儲存貯體已啟用物件鎖定。您只能在建立儲存貯體時啟用物件鎖定。如需建立已啟用物件鎖定的儲存貯體的文件，請參閱mc mb --with-lock。
以下命令會在 myminio MinIO 部署上的 mydata 儲存桶設定預設的 30 天 GOVERNANCE 物件鎖定。
mc retention set --default GOVERNANCE "30d" myminio/mydata
此命令具有以下語法：
mc [GLOBALFLAGS] retention set \
[--bypass] \
[--default] \
[--recursive] \
[--rewind "string"] \
[--versions] \
[--version-id "string"]* \
MODE \
"VALIDITY" \
ALIAS
方括號
[]表示選用參數。在同一行中顯示的參數彼此相關。
使用管線符號
|分隔的參數是互斥的。
將範例複製到文字編輯器中，並在終端機/Shell 中執行命令之前，根據需要修改。
mc retention set --version-id 與其他多個參數互斥。請參閱參考文件以獲取更多資訊。
參數
- MODE
- 必要
設定
ALIAS的鎖定模式。指定以下其中一個支援的值：governancecompliance
有關支援模式的更多資訊，請參閱 AWS S3 關於 物件鎖定概述的文件。
需要指定
VALIDITY。
- VALIDITY
- 必要
物件在建立後保持在指定
MODE中的持續時間。- 對於天數，請指定格式為
Nd的字串。例如： 30d表示物件建立後 30 天。
- 對於天數，請指定格式為
- 對於年數，請指定格式為
Ny的字串。例如： 1y表示物件建立後 1 年。
- 對於年數，請指定格式為
- ALIAS
- 必要
要設定物件鎖定組態的物件的完整路徑。指定 MinIO 或與 S3 相容服務的別名以及儲存桶的完整路徑。例如：
mc retention set play/mybucket/object.txt MODE VALIDITY如果
ALIAS指定儲存桶或儲存桶前綴，請包含--recursive，以將物件鎖定設定套用到儲存桶內容。mc retention set預設僅套用至最新的物件版本。使用--version-id或--versions分別將物件鎖定設定套用到特定版本或物件的所有版本。
- --bypass
- 選用
允許具有
s3:BypassGovernanceRetention權限的使用者修改物件。需要governance保留MODE
- --default
- 選用
使用
MODE和VALIDITY，將指定給ALIAS的儲存桶預設物件鎖定設定。除非使用mc retention set明確覆寫，否則在儲存桶中建立的任何物件都會繼承預設的物件鎖定設定。如果指定
--default，則mc retention set會忽略所有其他標幟。
- --recursive, --r
- 選用
將物件鎖定設定遞迴地套用到指定
ALIAS路徑中的所有物件。與
--version-id互斥。
- --rewind
- 選用
指示
mc retention set僅對指定時間點存在的物件版本執行操作。若要倒轉至過去的特定日期，請將日期指定為 ISO8601 格式的時間戳記。例如：
--rewind "2020.03.24T10:00"。若要倒轉一段時間，請將持續時間指定為
#d#hh#mm#ss格式的字串。例如：--rewind "1d2hh3mm4ss"。
--rewind要求指定的ALIAS是支援儲存桶版本控制的與 S3 相容的服務。對於 MinIO 部署，請使用mc version以啟用或停用儲存桶版本控制。
- --version-id, --vid
- 選用
指示
mc retention set僅對指定的物件版本執行操作。--version-id要求指定的ALIAS是支援儲存桶版本控制的與 S3 相容的服務。對於 MinIO 部署，請使用mc version以啟用或停用儲存桶版本控制。與下列任何旗標互斥：
- --versions
- 選用
指示
mc retention set對儲存桶中存在的所有物件版本執行操作。--versions要求指定的ALIAS是支援儲存桶版本控制的與 S3 相容的服務。對於 MinIO 部署，請使用mc version以啟用或停用儲存桶版本控制。同時使用
--versions和--rewind，以將保留設定套用到特定時間點存在的所有物件版本。
全域旗標
此命令支援任何全域旗標。
範例
設定預設儲存桶保留設定
搭配 --recursive 和 --default 使用 mc retention set 來設定預設儲存桶保留設定。
mc retention set --recursive --default MODE DURATION ALIAS/PATH
將
MODE替換為要啟用的保留模式。MinIO 支援 AWS S3 的保留模式governance和compliance。將
DURATION替換為物件鎖定應保持生效的持續時間。例如，要設定 30 天的保留期限，請指定30d。將
PATH替換為儲存貯體的路徑。
儲存貯體必須啟用物件鎖定才能使用此命令。您只能在建立儲存貯體時啟用物件鎖定。如需更多關於建立啟用物件鎖定的儲存貯體的資訊，請參閱
mc mb --with-lock。
設定版本化物件的物件鎖定配置
使用 mc retention set 以及 --version-id 將保留設定套用至特定物件版本。
mc retention set --version-id VERSION MODE DURATION ALIAS/PATH
使用 mc retention set 以及 --versions 將保留設定套用至特定物件版本。
mc retention set --versions MODE DURATION ALIAS/PATH
儲存貯體必須啟用物件鎖定才能使用此命令。您只能在建立儲存貯體時啟用物件鎖定。如需更多關於建立啟用物件鎖定的儲存貯體的資訊，請參閱
mc mb --with-lock。
行為
物件版本的保留
對於已啟用 版本控制 的儲存貯體，mc retention set 預設會對目標物件或物件的最新版本進行操作。mc retention set 包含特定的選項，當明確指定時，會指示命令對特定物件版本或物件的所有版本進行操作。
若要指示 mc retention set 對物件的特定版本進行操作，請包含 --version-id 引數。
若要指示 mc retention set 對物件的所有版本進行操作，請包含 --versions 引數。
與法律保留的互動
鎖定物件會阻止對該物件進行任何修改或刪除，類似於 COMPLIANCE 物件鎖定模式。物件可以同時擁有基於保留的鎖定和法律保留鎖定。
法律保留鎖定會覆寫任何保留鎖定，使得受法律保留的物件即使在保留期限到期後仍然處於鎖定狀態。在法律保留下的物件設定、修改或清除保留設定不會產生任何影響，直到法律保留到期或明確停用為止。
如需更多關於物件法律保留的資訊，請參閱 mc legalhold。
S3 相容性
mc 命令列工具的建構是為了與 AWS S3 API 相容，並已在 MinIO 和 AWS S3 上進行測試，以確保預期的功能和行為。
MinIO 不保證其他 S3 相容服務的功能，因為它們的 S3 API 實作未知，因此不支援。雖然 mc 命令可能會按照文件所述運作，但任何此類使用均由您自行承擔風險。
