物件刪除

概觀

此頁面總結了 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。

在 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/ 前綴，因為它是明確建立的。