MinIO 物件鎖定
總覽
MinIO 物件鎖定(「物件保留」)強制執行一次寫入多次讀取 (WORM) 不可變性,以保護已版本控制的物件免遭刪除。MinIO 支援基於持續時間的物件保留和無限期的法律保留。
根據Cohasset Associates的說法,MinIO 物件鎖定提供關鍵的資料保留合規性,並符合 SEC17a-4(f)、FINRA 4511(C) 和 CFTC 1.31(c)-(d) 的要求。
刪除操作在已版本控制的儲存貯體中遵循正常行為,其中 MinIO 會為物件建立一個 DeleteMarker
。但是,物件的非刪除標記版本仍受保留規則的約束,並且不會受到任何特定刪除或覆寫嘗試的影響。
MinIO 物件鎖定在功能和 API 上與 AWS S3 相容。本頁總結了 MinIO 實作的物件鎖定/保留概念。如需其他資源,請參閱 AWS S3 文件,了解S3 物件鎖定如何運作。
根據S3 行為,您只能在建立儲存貯體時啟用物件鎖定。您無法在未啟用鎖定的情況下建立的儲存貯體上啟用物件鎖定。然後,您可以隨時設定物件保留規則。物件鎖定需要版本控制,並會隱式啟用該功能。
與版本控制的互動
受 WORM 鎖定保護的物件在鎖定過期或明確解除鎖定之前是不可變的。鎖定是按物件版本進行的,其中每個版本都是獨立不可變的。
如果應用程式對已鎖定的物件執行未版本化的刪除操作,則該操作會產生刪除標記。任何嘗試明確刪除任何 WORM 鎖定物件的操作都會失敗並顯示錯誤。刪除標記不符合 WORM 鎖定下的保護資格。如需更多資訊,請參閱 S3 文件,了解管理刪除標記和物件生命週期。
例如,考慮以下預設啟用GOVERNANCE 模式鎖定的儲存桶
$ 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 Mode)
在 COMPLIANCE
鎖定下的物件會受到所有使用者的寫入操作保護,包括 MinIO root 使用者。
帶有 COMPLIANCE
鎖定的物件會強制執行鎖定物件的完全不可變性。在設定的保留期限經過之前,您無法變更或移除鎖定。
MinIO 的 COMPLIANCE
鎖定在功能上與 S3 COMPLIANCE 模式相同。
法律保留 (Legal Hold)
在法律保留下的物件會受到所有使用者的寫入操作保護,包括 MinIO root 使用者。
法律保留是無限期的,並強制執行鎖定物件的完全不可變性。只有具有 s3:PutObjectLegalHold
權限的特權使用者才能設定或解除法律保留。
法律保留適用於物件層級。如果您為一群物件啟用法律保留,例如儲存貯體 (bucket) 的內容,則該儲存貯體中後續建立的物件不會受到影響。
法律保留與 GOVERNANCE 模式 和 COMPLIANCE 模式 保留設定都是互補的。受到法律保留且具有 GOVERNANCE/COMPLIANCE
保留規則約束的物件,將保持 WORM 鎖定狀態,直到解除法律保留且規則過期為止。
對於 GOVERNANCE
鎖定的物件,即使使用者具有繞過保留的必要權限,法律保留也會阻止變更物件。