物件刪除
概觀
此頁面總結了 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 會從磁碟中永久移除物件版本。
這些規則依賴 掃描器 來處理儲存桶上的規則。掃描器以較低優先順序的持續程序運行,其中 READ
和 WRITE
動作具有較高的優先順序。因此,符合過期要求的物件版本可能不會立即從 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
欄位指定 delete
和 delete-marker
或兩者,以分別啟用版本化刪除和刪除標記複寫。若要同時啟用兩者,請使用逗號分隔符號指定兩個字串: delete,delete-marker
。
對於刪除標記複寫,MinIO 會在刪除操作建立刪除標記後開始複寫程序。MinIO 使用 X-Minio-Replication-DeleteMarker-Status
中繼資料欄位來追蹤刪除標記複寫狀態。在 主動-主動 複寫設定中,如果兩個叢集同時為某個物件建立刪除標記,或如果一個或兩個叢集在複寫事件同步之前關閉,MinIO 可能會產生重複的刪除標記。
對於複寫特定物件版本的刪除,MinIO 會將物件版本標記為 PENDING
,直到複寫完成。一旦遠端目標刪除該物件版本,MinIO 就會在來源上刪除該物件版本。雖然此程序可確保近乎同步的版本刪除,但它可能會導致在初始刪除操作之後,清單操作傳回物件版本。MinIO 使用 X-Minio-Replication-Delete-Status
來追蹤刪除版本複寫狀態。
MinIO 僅複寫明確的客戶端驅動的刪除操作。MinIO 不會複寫被 生命週期管理到期規則 刪除的物件。對於 主動-主動 設定,請在所有複寫儲存桶上設定相同的到期規則,以確保物件到期的一致應用。
MinIO 會修剪來源和遠端儲存桶上的空物件前綴
如果刪除操作移除儲存桶前綴中的最後一個物件,MinIO 會以遞迴方式移除前綴的每個空部分,直到儲存桶根目錄。MinIO 僅將遞迴移除套用於隱式建立為物件寫入操作一部分的前綴。MinIO 不會遞迴移除使用明確目錄建立命令(例如 mc mb
)建立的前綴。
如果複寫規則啟用複寫刪除操作,則複寫程序也會在目的地 MinIO 叢集上套用隱式前綴修剪行為。
例如,考慮一個具有以下物件前綴的儲存桶 photos
photos/2021/january/myphoto.jpg
//2021/january/
是根據物件名稱隱式建立的photos/2021/february/myotherphoto.jpg
//2021/february/
是根據物件名稱隱式建立的photos/NYE21/NewYears.jpg
//NYE21/
是在儲存桶中明確建立的
photos/NYE21
是使用 mc mb
明確建立的唯一前綴。所有其他前綴都是在寫入位於該前綴的物件時隱式建立的。
一個命令會移除
myphoto.jpg
。MinIO 會自動修剪空的/january/
前綴。接著,一個指令會移除
myotherphoto.jpg
。MinIO 會自動修剪掉/february/
前綴以及現在已為空的/2021
前綴。一個指令會移除
NewYears.jpg
物件。MinIO 會保留/NYE21/
前綴,因為它是明確地被建立的。