物件版本管理

設定 用量

物件版本管理功能會將已刪除的物件保留為非現行版本，這些物件仍可從值區存取，直到明確移除為止。這項功能可用於追蹤物件的變更，以及復原特定版本的物件。這個頁面將說明這項功能及可用選項。

建議您使用軟刪除，而非物件版本管理，以免因意外或惡意刪除而永久遺失資料。如要進一步瞭解何時該使用軟刪除和物件版本管理，請參閱「注意事項」。

簡介

您可以針對值區啟用物件版本管理。啟用後：

  • 只要您未指定使用中版本的版本編號，每當您取代或刪除使用中物件版本，Cloud Storage 就會保留非現行物件版本。

    • 非現行版本會保留物件名稱，但會以版本編號做為不重複的識別依據。

    • 只有在明確要求納入非最新版本時，系統才會在要求中顯示這類版本。

  • 如要刪除物件的非現行版本，請在刪除要求中加入產生編號，或使用物件生命週期管理。

  • 在啟用虛刪除功能的值區中，當您刪除非目前版本的物件時，Cloud Storage 會將其狀態變更為虛刪除。虛刪除的物件會在虛刪除保留期限屆滿後永久刪除。

  • 物件的非現行版本與任何使用中版本無關。

如果停用物件版本管理功能：

  • 值區不會再累積物件的新非目前版本。

  • 值區中現有的物件版本不受影響。

注意事項

  • 物件版本數量沒有預設限制。物件的每個非現行版本計費費率，都與該版本為使用中版本時相同。

  • 只有在從 bucket 中移除物件版本時，才會收取提前刪除費用，而非在版本變成非現行版本時。從 bucket 移除的版本，其儲存時間長度是根據加入 bucket 的時間，而非成為非現行版本的時間。

  • 假如您啟用版本管理功能，不妨一併使用物件生命週期管理；這樣系統就能在指定時間過後，或較新版本不再是現行版本時，移除舊版物件。如需其中一種可能的設定，請參閱刪除物件的生命週期設定範例。

  • 如要判斷是否要在值區中啟用物件版本管理或虛刪除功能，請考慮下列幾點：

    • 如要避免因意外或惡意刪除而導致資料永久遺失，請使用虛刪除功能，而非物件版本管理功能。虛刪除功能會保留所有最近刪除的使用中或非現行物件，提供值區層級的保護。這項功能也能防範值區層級的刪除事件。

    • 如果您有特定帳單需求，並已設定物件生命週期管理規則來保留指定數量的非現行版本，請使用物件版本管理。

      在這種情況下，您只能獲得部分保護，避免物件遭到誤刪，因為物件版本管理功能無法防範值區層級的事件，或非現行物件遭到不當刪除。

    • 非現行物件可供存取及讀取，而虛刪除的物件會保留在離線狀態，且無法讀取。如要還原已軟刪除的物件，必須具備 特定 IAM 權限，而 Storage 管理員 (roles/storage.admin) IAM 角色可提供這類權限。

      如要存取最近刪除的物件，並高度防範因意外和惡意刪除事件而永久遺失資料，您可以在同一個 bucket 中啟用物件版本管理和虛刪除功能。您可以設定物件生命週期管理政策，在特定天數後自動刪除非現行版本，然後使用軟刪除功能提供額外的保護層。

非現行物件中繼資料

物件的非現行版本有自己的中繼資料，可能與現行版本的中繼資料不同。最重要的是，非目前版本會保留其 ACL，而且不一定要具備與使用中版本同樣的權限。

不論是使用中或非現行版本，每個物件都有一組中繼資料，只有最新的中繼資料版本編號能用來指示中繼資料。您不能以較舊的中繼產生編號存取自其生成之後修改過的中繼資料。

您可以在要求中指定 generation，藉此更新非目前版本物件的中繼資料。如要維護讀取-修改-寫入語意的完整，您可以使用 metageneration-match 先決條件。一旦使用這項先決條件，在您讀取中繼資料後到傳送更新的這個期間，若您嘗試更新的中繼資料有所變更，就會導致更新失敗。

物件版本管理範例

本例說明一旦您啟用物件版本管理和虛刪除功能，日後取代、更新及刪除物件時，值區內的 cat.jpg 物件會發生什麼事。

上傳新映像檔

當您初次上傳 cat.jpg 到 Cloud Storage 後，其會收到generation 號碼和 metageneration 號碼各一組。本例中的版本編號是 1360887697105000。由於物件是新的，因此 metageneration 號碼是 1。

即使未啟用物件版本管理功能，cat.jpg 也會收到 generation 和 metageneration 號碼。您可以查看物件中繼資料來取得這些號碼。

啟用物件版本管理

在這個階段，您可以決定是否要讓值區啟用物件版本管理。啟用這項功能並不會影響 cat.jpg 的 generation 或 metageneration號碼。

變更映像檔的中繼資料

您可以藉由新增自訂中繼資料 color:black 來更新 cat.jpg 的中繼資料。更新中繼資料會使 cat.jpg 的 metageneration 值增加，在這種情況下會從 1 增加到 2。但由於物件本身維持不變，因此 Cloud Storage 會繼續只儲存 cat.jpg 的一個版本，且該版本的 generation 號碼也還是 1360887697105000。

上傳新版本映像檔

將 cat.jpg 的新版本上傳至 Cloud Storage bucket。 這時物件版本管理功能會將現有的 cat.jpg 物件移到非現行狀態。非現行版本會保留與先前相同的儲存空間級別及中繼資料。此外，只有在您執行顯示版本化清單時，非目前版本才會出現；一般清單指令並不會顯示非目前版本。非現行版本現在則使用 cat.jpg#1360887697105000 這個參照號碼。

與此同時，最新上傳的 cat.jpg 就會變成物件的使用中版本。這個新的 cat.jpg 可取得專屬的 generation 號碼，在本例中為 1360887759327000。並且也會取得專屬中繼資料和 metageneration 號碼 (也就是 1)，這代表其中並沒有 color:black 中繼資料，除非您予以指定。當您存取或修改 cat.jpg, 時，這就是系統將採用的版本。或者，您可以使用 generation 號碼來指出 cat.jpg 的這個版本。舉例來說，您使用 Google Cloud CLI 時可以將生成號碼視為 cat.jpg#1360887759327000。

刪除映像檔的使用中版本

您現在刪除了cat.jpg。當您執行這項動作，系統就會將生成號碼為 1360887759327000 的版本設為非現行版本。因此，您的值區現在有兩個 cat.jpg 非現行版本，但已經沒有任何使用中版本。您還是可以使用 generation 號碼來代表這兩個非現行版本之一，但如果您嘗試在沒有 generation 號碼的情況下存取 cat.jpg，這項作業就會失敗。

同樣地，值區的一般物件清單不會將 cat.jpg 顯示為值區中的任何一個物件。如需物件非現行版本清單的詳細資訊，請參閱「列出物件的非現行版本」一文。

停用物件版本管理

如果您停用物件版本管理功能，物件就不會變成非最新版本。現有的物件非現行版本仍會保留在 Cloud Storage 中。除非您刪除，否則就算物件版本管理功能已停用，cat.jpg#1360887697105000 和 cat.jpg#1360887759327000 仍會儲存在您的值區中。

還原其中一個非現行版本

即使物件版本管理功能已停用，您還是可以複製其中一個現有的非現行版本，有效還原該版本。完成還原後，您的 bucket 會有三個版本的 cat.jpg：兩個非目前版本，以及一個從還原作業取得的使用中版本。

刪除其中一個非現行版本

您可以手動或使用物件生命週期管理，刪除物件的非現行版本。

刪除非現行版本 cat.jpg#1360887697105000 時，系統會虛刪除該版本。這個虛刪除物件會保留一段時間，保留時長由 bucket 的虛刪除政策指定。保留期限屆滿後，Cloud Storage 會永久刪除這個物件的虛刪除版本。

還原其中一個虛刪除的物件版本

即使物件版本管理功能已停用，您還是可以還原非現行物件的虛刪除版本。系統會將暫時刪除的版本副本還原為使用中版本，並提供新的物件中繼資料和建立日期。原始虛刪除物件也會保留在 bucket 中，並在虛刪除保留期限屆滿後永久刪除。

物件版本管理參考資料

下表說明使用物件版本管理功能時，執行特定動作會發生什麼情況。

物件版本管理狀態 虛刪除狀態 動作 結果
已停用 已停用
刪除 dog.png。 dog.png已永久刪除。
指定版本編號，刪除 dog.png 的非現行版本。1 系統會永久刪除非現行版本。
將 dog.png 替換成新版本。 新版本會取代使用中版本，並取得新的版本編號。舊版使用中版本會永久刪除。
將非現行版本複製到現行版本。1dog.png 非現行版本副本會取代使用中版本，並獲得新的版本編號。舊版使用中版本會永久刪除。
已停用 已啟用
刪除 dog.png。 「dog.png」已虛刪除。
指定版本編號，刪除 dog.png 的非現行版本。1 非現行版本已虛刪除。
將 dog.png 替換成新版本。 新版本會取代使用中版本，並取得新的版本編號。舊的使用中版本會遭到虛刪除。
將非現行版本複製到現行版本。1dog.png 非現行版本副本會取代使用中版本，並獲得新的版本編號。舊的使用中版本會遭到虛刪除。
已啟用 已停用
刪除 dog.png 的使用中版本，但未指定產生號碼。 使用中的版本會變成非現行版本，並保留相同的版本編號。
指定 dog.png 的版本編號，刪除該物件的現行版本。 使用中的版本會永久刪除。
指定版本編號，刪除 dog.png 的非現行版本。 系統會永久刪除非現行版本。
將 dog.png 替換成新版本。 新版本會取代使用中版本，並取得新的版本編號。舊的使用中版本會變成非現行版本，並保留相同的版本編號。
將非現行版本的 dog.png 複製到現行版本。 非現行版本副本會取代使用中版本，並獲得新的版本編號。舊的使用中版本會變成非現行版本，並保留相同的版本編號。
已啟用 已啟用
刪除 dog.png 的使用中版本，但未指定產生號碼。 使用中的版本會變成非現行版本，並保留相同的版本編號。
指定 dog.png 的版本編號，刪除該物件的現行版本。 已虛刪除上線版本。
指定版本編號，刪除 dog.png 的非現行版本。 非現行版本已虛刪除。
將 dog.png 替換成新版本。 新版本會取代使用中版本，並取得新的版本編號。舊的使用中版本會變成非現行版本，並保留相同的版本編號。
將非現行版本的 dog.png 複製到現行版本。 非現行版本副本會取代使用中版本，並獲得新的版本編號。舊的使用中版本會變成非現行版本，並保留相同的版本編號。

1 如果值區先前已啟用物件版本管理功能，則可能存在非現行版本。

還原行為

您可以將非現行物件版本還原為目前的使用中版本。如需逐步操作說明，請參閱「還原非現行物件版本」一文。

如果您在物件版本管理功能已啟用的情況下進行這項動作，而值區中還有物件的使用中版本，則 Cloud Storage 將會取代現有的使用中版本，但也會將其保留為新的非現行版本。假如是這樣，您的值區接著就會包含已取代 (現在則是已非現行) 物件，以及兩個先前非現行的物件複本 (分別是使用中及仍為非現行狀態的複本)，而這些全部都會產生儲存空間費用。為避免不必要的費用，請刪除您已當做目前使用中複本來用的非現行版本，或設定物件生命週期管理，在非現行物件符合您指定的條件時將其移除。

後續步驟