物件刪除
概觀
此頁面總結了 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/
前綴,因為它是明確地建立的。