文件

物件刪除

概觀

此頁面總結了 DELETE 操作如何根據包含物件的儲存桶配置影響物件。

以下因素的任何組合都可能影響 DELETE 操作的功能

權限

MinIO 使用 基於策略的存取控制 系統進行存取管理。使用者或服務帳戶必須提供正確的策略動作和條件,才能允許儲存桶和物件的 DELETE 操作。

未版本化的物件

當在未啟用版本控制的儲存桶中的物件上執行 DELETE 操作時,該操作非常簡單。在驗證使用者或服務帳戶有權執行 DELETE 操作後,MinIO 會永久移除物件。

請求刪除動作的使用者或服務帳戶必須具有儲存桶和物件的 s3:DeleteObject 動作權限。

版本化的物件

當物件被版本化時,DELETE 操作的工作方式會有所不同。

使用者或服務帳戶必須擁有針對儲存桶和物件的 s3:DeleteObjectVersion 動作權限。

對目前版本執行刪除操作

對未指定版本 UUID 的版本化物件執行 DELETE 操作,會導致建立一個 DeleteMarker,並將其放置在物件的 head 位置。

在此情況下,MinIO 實際上不會從磁碟中移除物件或其任何版本。物件的所有現有版本仍可透過指定版本的 UUID 來存取。當 DeleteMarker 是物件的 head 時,MinIO 不會為未指定版本 ID 的 GET 請求提供物件。相反地,MinIO 會傳回類似 404 的回應。

您可以使用 mc ls --versions 找到物件版本的 UUID。

若要從磁碟中移除物件的目前版本,請找到該版本的 UUID,然後使用 mc rm --version-id=UUID ... 來刪除目前版本。在此情況下,物件的前一個版本會立即成為目前版本,並用於未指定 UUID 的物件 GET 請求。

警告

在 DELETE 操作中指定 version-id 是不可逆的操作。MinIO 會從磁碟中移除指定的版本,且無法復原。

對先前版本執行刪除操作

若要刪除物件的先前版本,請指定版本的 UUID。您可以使用 mc ls --versions 檢索版本 UUID。當 DELETE 請求指定 version-id 且使用者具有刪除物件版本的正確權限時,MinIO 會從磁碟中永久移除指定的版本。

警告

在 DELETE 操作中指定 version-id 是不可逆的操作。MinIO 會從磁碟中移除指定的版本,且無法復原。

刪除所有版本

使用 mc rm --versions 來刪除物件的所有版本。此操作是不可逆的。

生命週期管理到期

您可以定義一個或多個 生命週期管理到期規則,以便在達到特定版本號碼計數或特定時間段後使物件過期。當存在的版本多於規則指定的數量,或當版本早於指定的時間時,MinIO 會從磁碟中永久移除物件版本。

這些規則依賴 掃描器 來處理儲存桶上的規則。掃描器以較低優先順序的持續程序運行,其中 READWRITE 動作具有較高的優先順序。因此,符合過期要求的物件版本可能不會立即從 MinIO 中移除。

請參閱掃描器頁面,以取得有關掃描器運作方式和組態選項的更多詳細資訊。

DeleteMarkers 是它們自己的物件。生命週期規則可以移除 DeleteMarkers,這些 DeleteMarkers 是物件唯一剩餘的版本。

在版本 MinIO 中變更:RELEASE.2024-05-01T01-11-10Z

透過 JSON,生命週期規則可以在指定的日期數後移除已刪除物件的所有版本。

保留的物件

MinIO 會保護受 鎖定規則 約束的物件,使其不會被覆寫或刪除。這些規則要求物件必須保留到規則到期或被移除為止。

在沒有指定版本的鎖定物件上執行 DELETE 操作,會為物件建立 DeleteMarker。但是,物件版本本身會依照鎖定的要求保留。

指定物件版本的 DELETE 操作受保留規則的約束。MinIO 會保護受鎖定約束的物件版本,使其不會被覆寫或刪除,直到鎖定到期或被移除為止。

複寫的物件

複寫會將物件從一個位置複製到另一個位置。MinIO 支援儲存桶層級或叢集(「站點」)層級的複寫。

刪除操作可能會或可能不會複寫,具體取決於複寫類型和複寫的設定方式。

站點複寫

對於啟用 多站點複寫 的叢集,MinIO 會將在任何叢集上執行的所有 delete 操作複寫到對等群組中的其他每個叢集。

任何單個對等點的刪除行為都遵循與任何 MinIO 部署相同的過程。

儲存桶複寫

透過 儲存桶複寫,MinIO 支援在來源儲存桶和已設定的遠端儲存桶之間複寫刪除操作。MinIO 會同步刪除特定物件版本新的 刪除標記。刪除操作複寫使用與所有其他複寫操作相同的複寫程序

MinIO 需要明確啟用版本化刪除和刪除標記複寫。使用 mc replicate add --replicate 欄位指定 deletedelete-marker 或兩者,以分別啟用版本化刪除和刪除標記複寫。若要同時啟用兩者,請使用逗號分隔符號指定兩個字串: delete,delete-marker

對於刪除標記複寫,MinIO 會在刪除操作建立刪除標記後開始複寫程序。MinIO 使用 X-Minio-Replication-DeleteMarker-Status 中繼資料欄位來追蹤刪除標記複寫狀態。在 主動-主動 複寫設定中,如果兩個叢集同時為某個物件建立刪除標記,如果一個或兩個叢集在複寫事件同步之前關閉,MinIO 可能會產生重複的刪除標記。

對於複寫特定物件版本的刪除,MinIO 會將物件版本標記為 PENDING,直到複寫完成。一旦遠端目標刪除該物件版本,MinIO 就會在來源上刪除該物件版本。雖然此程序可確保近乎同步的版本刪除,但它可能會導致在初始刪除操作之後,清單操作傳回物件版本。MinIO 使用 X-Minio-Replication-Delete-Status 來追蹤刪除版本複寫狀態。

MinIO 僅複寫明確的客戶端驅動的刪除操作。MinIO 不會複寫被 生命週期管理到期規則 刪除的物件。對於 主動-主動 設定,請在所有複寫儲存桶上設定相同的到期規則,以確保物件到期的一致應用。