Erasure Code Calculator 
參考硬體 MinIO 物件鎖定
概觀
MinIO 物件鎖定（「物件保留」）強制執行「一次寫入多次讀取」(WORM) 不可變性，以保護已版本化的物件免遭刪除。MinIO 支援基於時間長度的物件保留和無限期法律保留。
MinIO 物件鎖定提供關鍵資料保留合規性，並符合 Cohasset Associates 的 SEC17a-4(f)、FINRA 4511(C) 和 CFTC 1.31(c)-(d) 要求，如Cohasset Associates所示。
MinIO 版本控制保留了物件變更的完整歷史記錄。但是，應用程式可以明確刪除特定的物件版本。
對儲存貯體中的物件套用預設的 30 天 WORM 鎖定可確保所有物件版本的最短保留期和保護。
MinIO 物件鎖定在功能和 API 上與 AWS S3 相容。此頁面總結了 MinIO 實作的物件鎖定/保留概念。請參閱 AWS S3 文件中的S3 物件鎖定如何運作以取得其他資源。
您只能在建立儲存貯體時啟用物件鎖定，如S3 行為所述。您無法在未啟用鎖定的情況下建立的儲存貯體上啟用物件鎖定。然後，您可以隨時設定物件保留規則。物件鎖定需要版本控制，並隱式啟用此功能。
與版本控制的互動
在 WORM 鎖定下的物件在鎖定到期或明確解除之前是不可變的。鎖定是針對每個物件版本，其中每個版本都是獨立不可變的。
如果應用程式對已鎖定的物件執行未版本化的刪除作業，則該作業會產生刪除標記。嘗試明確刪除任何 WORM 鎖定的物件都會失敗並出現錯誤。刪除標記不符合 WORM 鎖定下的保護資格。請參閱 S3 文件中的管理刪除標記和物件生命週期以取得更多資訊。
例如，考慮以下儲存貯體，其中預設啟用治理模式鎖定
$ mc ls --versions play/locking-guide
[DATETIME] 29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
[DATETIME] 32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
[DATETIME] 23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv
由於物件鎖定設定，嘗試對 data.csv 的特定版本執行刪除作業會失敗
$ mc rm --version-id 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 play/data.csv
Removing `play/locking-guide/data.csv` (versionId=62429eb1-9cb7-4dc5-b507-9cc23d0cc691).
mc: <ERROR> Failed to remove `play/locking-guide/data.csv`.
Object, 'data.csv (Version ID=62429eb1-9cb7-4dc5-b507-9cc23d0cc691)' is
WORM protected and cannot be overwritten
嘗試對 data.csv 執行未版本化的刪除作業會成功，並為物件建立新的 DeleteMarker
$ mc rm play/locking-guide/data.csv
[DATETIME] 0B acce329f-ad32-46d9-8649-5fe8bf4ec6e0 v4 DEL data.csv
[DATETIME] 29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
[DATETIME] 32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
[DATETIME] 23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv
與生命週期管理的互動
MinIO 物件到期會遵守到期規則涵蓋的物件的任何使用中物件鎖定和保留設定。
對於僅對目前物件版本運作的到期規則，MinIO 會為已鎖定的物件建立刪除標記。
對於作用於非當前物件版本的過期規則，MinIO 只能在保留期限過後或已明確解除（例如，法律保留）的情況下，使非當前版本過期。
例如，考慮以下儲存桶，預設啟用 GOVERNANCE 模式 的鎖定，為期 45 天
$ mc ls --versions play/locking-guide
[7D] 29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
[30D] 32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
[60D] 23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv
為早於 7 天的當前物件建立過期規則，會產生該物件的刪除標記
$ mc ls --versions play/locking-guide
[0D] 0B acce329f-ad32-46d9-8649-5fe8bf4ec6e0 v4 DEL data.csv
[7D] 29B 62429eb1-9cb7-4dc5-b507-9cc23d0cc691 v3 PUT data.csv
[30D] 32B 78b3105a-02a1-4763-8054-e66add087710 v2 PUT data.csv
[60D] 23B c6b581ca-2883-41e2-9905-0a1867b535b8 v1 PUT data.csv
但是，針對早於 7 天的非當前物件的過期規則，只會在設定的 WORM 鎖過期後才會生效。由於儲存桶設定了 45 天的 GOVERNANCE 保留期，因此只有 data.csv 的 v1 版本被解鎖，因此符合刪除條件。
教學
建立啟用物件鎖定的儲存桶
您必須在建立儲存桶時啟用物件鎖定，如同 S3 的行為。您可以使用 MinIO 主控台、MinIO mc CLI，或使用相容於 S3 的 SDK，來建立啟用物件鎖定的儲存桶。
選取 MinIO 主控台的 儲存桶區段，以存取儲存桶的建立和管理功能。從儲存桶清單中選取儲存桶列。您可以使用 搜尋列來篩選清單。
點擊 建立儲存桶按鈕，開啟儲存桶建立模式視窗。切換 物件鎖定選擇器，以在儲存桶上啟用物件鎖定。
使用 mc mb 命令，並搭配 --with-lock 選項，建立啟用物件鎖定的儲存桶
mc mb --with-lock ALIAS/BUCKET
設定儲存桶預設物件保留
您可以使用 MinIO 主控台、MinIO mc CLI，或使用相容於 S3 的 SDK，來設定物件鎖定規則（「物件保留」）。
MinIO 支援設定儲存桶預設和每個物件的保留規則。以下範例設定儲存桶預設保留。如需每個物件的保留設定，請參考您慣用的 SDK 所使用的 PUT 操作文件。
選取 MinIO 主控台的 儲存桶區段，以存取儲存桶的建立和管理功能。您可以使用 搜尋列來篩選清單。
每個儲存桶列都有一個 管理按鈕，可開啟該儲存桶的管理檢視。
從 保留區段，選取 已啟用。此區段僅適用於建立時啟用物件鎖定的儲存桶。
從 設定保留設定模式視窗，設定所需的儲存桶預設保留設定。
針對 保留模式，選取 COMPLIANCE 或 GOVERNANCE。
針對 持續時間，選取 天或 年的保留持續時間單位。
針對 保留有效期，設定 MinIO 將物件依指定儲存桶保留模式持有的時間長度。
使用 mc retention set 命令，並搭配 --recursive 和 --default 選項，以設定儲存桶的預設保留模式
mc retention set --recursive --default MODE DURATION ALIAS/BUCKET
將
MODE替換為 COMPLIANCE 或 GOVERNANCE。將
DURATION替換為物件鎖定保持有效性的持續時間。將
BUCKET替換為要設定預設保留規則的儲存桶名稱。
啟用法律保留
您可以使用 MinIO 主控台、MinIO mc CLI，或使用相容於 S3 的 SDK，來啟用或停用物件的無限期法律保留。
您可以將法律保留放在已在 COMPLIANCE 或 GOVERNANCE 鎖定下的物件。即使保留鎖過期，物件仍會在法律保留下維持 WORM 鎖定。您或另一個具有必要權限的使用者必須明確解除法律保留，以移除 WORM 鎖定。
物件保留模式
MinIO 實作下列 S3 物件鎖定模式
模式 |
摘要 |
|---|---|
防止非特權使用者執行任何會變更或修改物件或其鎖定設定的操作。 在儲存桶或物件上具有 MinIO 會在設定的保留規則持續時間過後自動解除鎖定。 |
|
防止執行任何會變更或修改物件或其鎖定設定的操作。 沒有任何 MinIO 使用者可以修改物件或其設定，包括 MinIO 根使用者。 MinIO 會在設定的保留規則持續時間過後自動解除鎖定。 |
GOVERNANCE 模式
在 GOVERNANCE 鎖定下的物件會受到保護，免於非特權使用者的寫入操作。
GOVERNANCE 鎖定的物件會對鎖定的物件強制執行受管理的不可變性，其中具有 s3:BypassGovernanceRetention 操作權限的使用者，可以修改鎖定的物件、變更保留時間，或完全解除鎖定。繞過 GOVERNANCE 保留也需要在請求中設定 x-amz-bypass-governance-retention:true 標頭。
MinIO GOVERNANCE 鎖定的功能與 S3 GOVERNANCE 模式相同。
COMPLIANCE 模式
在 COMPLIANCE 鎖定下的物件會受到保護，免於所有使用者（包括 MinIO 根使用者）的寫入操作。
COMPLIANCE 鎖定的物件會對鎖定的物件強制執行完全的不可變性。在設定的保留持續時間過後，您無法變更或移除鎖定。
MinIO COMPLIANCE 鎖定的功能與 S3 COMPLIANCE 模式相同。
法律保留
在法律保留下的物件會受到保護，免於所有使用者（包括 MinIO 根使用者）的寫入操作。
法律保留是無限期的，並且對鎖定的物件強制執行完全的不可變性。只有具有 s3:PutObjectLegalHold 權限的特權使用者，才能設定或解除法律保留。
法律保留適用於物件層級。如果您為一組物件啟用法律保留，例如儲存桶的內容，則該儲存桶中後續建立的物件將不受影響。
法律保留是對治理模式（GOVERNANCE Mode）和合規模式（COMPLIANCE Mode）保留設定的補充。同時受到法律保留和 GOVERNANCE/COMPLIANCE保留規則約束的物件，將保持 WORM（一次寫入，多次讀取）鎖定，直到解除法律保留且規則到期。
對於 GOVERNANCE 鎖定的物件，法律保留會阻止修改物件，即使使用者擁有繞過保留的必要權限。
