文件

MinIO 物件鎖定

概觀

MinIO 物件鎖定(「物件保留」)強制執行「一次寫入,多次讀取」(WORM) 不可變性,以保護版本控制物件免於刪除。MinIO 支援基於持續時間的物件保留無限期法律保留

MinIO 物件鎖定提供關鍵資料保留合規性,並符合 Cohasset Associates 的 SEC17a-4(f)、FINRA 4511(C) 和 CFTC 1.31(c)-(d) 要求,如 Cohasset Associates 所述。

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.csvv1 版本會被解除鎖定,因此有資格刪除。

教學

建立啟用物件鎖定的儲存貯體

您必須按照 S3 行為,在儲存貯體建立期間啟用物件鎖定。您可以使用 MinIO 主控台、MinIO mc CLI 或使用與 S3 相容的 SDK 建立啟用物件鎖定的儲存貯體。

選取 MinIO 主控台的儲存貯體區段,以存取儲存貯體建立和管理功能。從儲存貯體清單中選取儲存貯體列。您可以使用 搜尋列篩選清單。

MinIO Console Bucket Management

按一下建立儲存貯體按鈕以開啟儲存貯體建立模式。切換物件鎖定選取器以啟用儲存貯體上的物件鎖定。

MinIO Console Bucket Management

使用 mc mb 命令以及 --with-lock 選項,建立啟用物件鎖定的儲存貯體

mc mb --with-lock ALIAS/BUCKET
  • ALIAS 取代為已設定的 MinIO 部署的別名

  • BUCKET 取代為要建立的儲存貯體的名稱

設定儲存貯體預設物件保留

您可以使用 MinIO 主控台、MinIO mc CLI 或使用與 S3 相容的 SDK 設定物件鎖定規則(「物件保留」)。

MinIO 支援設定儲存貯體預設每個物件保留規則。以下範例設定儲存貯體預設保留。如需每個物件保留設定,請參考您偏好的 SDK 使用的 PUT 操作的文件。

選取 MinIO 主控台的儲存貯體區段,以存取儲存貯體建立和管理功能。您可以使用 搜尋列篩選清單。

MinIO Console Bucket Management

每個儲存貯體列都有一個管理按鈕,可開啟該儲存貯體的管理檢視。

MinIO Console Bucket Management

保留區段,選取已啟用。此區段僅適用於建立時已啟用物件鎖定的儲存貯體。

設定保留設定模式,設定所需的儲存貯體預設保留設定。

  • 針對保留模式,選取COMPLIANCEGOVERNANCE

  • 針對期間,選取的保留期間單位。

  • 針對保留有效性,設定 MinIO 在儲存貯體的指定保留模式下保留物件的時間長度。

使用 mc retention set 命令以及 --recursive--default 選項,設定儲存貯體的預設保留模式

mc retention set --recursive --default MODE DURATION ALIAS/BUCKET
  • MODE 取代為 COMPLIANCEGOVERNANCE

  • DURATION 取代為物件鎖定保持有效狀態的持續時間。

  • ALIAS 取代為已設定的 MinIO 部署的別名

  • BUCKET 取代為要設定預設保留規則的儲存貯體名稱。

物件保留模式

MinIO 實作了以下 S3 物件鎖定模式

模式

摘要

GOVERNANCE 模式

防止非特權使用者執行任何會變更或修改物件或其鎖定設定的操作。

對儲存桶或物件具有 s3:BypassGovernanceRetention 權限的使用者可以修改物件或其鎖定設定。

MinIO 會在設定的保留規則期間過後自動解除鎖定。

COMPLIANCE 模式

防止任何會變更或修改物件或其鎖定設定的操作。

沒有任何 MinIO 使用者可以修改物件或其設定,包括 MinIO 根 使用者。

MinIO 會在設定的保留規則期間過後自動解除鎖定。

治理模式

處於 GOVERNANCE 鎖定下的物件受到保護,免受非特權使用者的寫入操作。

GOVERNANCE 鎖定的物件會對鎖定的物件強制執行受管理的不變性,其中具有 s3:BypassGovernanceRetention 動作的使用者可以修改鎖定的物件、變更保留期間,或完全解除鎖定。略過 GOVERNANCE 保留也需要在請求中設定 x-amz-bypass-governance-retention:true 標頭。

MinIO 的 GOVERNANCE 鎖定在功能上與 S3 治理模式 完全相同。

合規模式

處於 COMPLIANCE 鎖定下的物件受到保護,免受所有使用者的寫入操作,包括 MinIO 根 使用者。

COMPLIANCE 鎖定的物件會對鎖定的物件強制執行完全的不變性。在設定的保留期間過後之前,您無法變更或移除鎖定。

MinIO 的 COMPLIANCE 鎖定在功能上與 S3 合規模式 完全相同。