オブジェクトのバージョニング

サンプルに移動

削除または置換されたオブジェクトを取得できるようにするため、Cloud Storage にはオブジェクトのバージョニング機能があります。このページでは、この機能と、この機能を使用するときに使用可能なオプションについて説明します。

はじめに

バケットのオブジェクトのバージョニングを有効にします。有効にすると、次のようになります。

ライブバージョンの世代番号を指定しない限り、ライブオブジェクトバージョンを置換または削除するたびに、Cloud Storage には、非現行オブジェクトバージョンが保持されます。
- 非現行バージョンではオブジェクトの名前が保持されますが、世代番号によって一意に識別されます。
- 非現行バージョンは、それを含めるよう明示的に要求するリクエストにのみ表示されます。
オブジェクトのバージョンを完全に削除するには、削除リクエストに世代番号を含めるか、オブジェクトのライフサイクル管理を使用します。
注意: 削除リクエストで世代番号を指定すると、ライブバージョンの場合でも、バージョンが完全に削除されます。
オブジェクトの非現行バージョンは、ライブバージョンとは独立して存在します。

オブジェクトのバージョニングを無効にする場合:

このバケットでは、オブジェクトの新しい非現行バージョンが蓄積されなくなります。
バケットにすでに存在するオブジェクトのバージョンは影響を受けません。

考慮事項

オブジェクトのバージョニングは、保持ポリシーが設定されているバケットでは有効にできません。
オブジェクトバージョンの数にデフォルトの上限はありません。オブジェクトの各非現行バージョンは、ライブ時と同じレートで課金されます。
- 早期削除料金は、オブジェクトバージョンがバケットから削除された場合にのみ適用されます。バージョンが非現行バージョンになったときは適用されません。バケットから削除されたバージョンの保存期間は、そのバケットが非現行バージョンになった時刻ではなく、バケットに追加された時刻に基づきます。
- バージョニングを有効にする場合は、オブジェクトのライフサイクル管理の使用を検討してください。これを使用すると、指定した期間が終了するか、新しいバージョンが非現行になった場合に、オブジェクトの古いバージョンが削除されます。考えられる設定については、オブジェクトの削除のライフサイクル構成例をご覧ください。

非現行オブジェクトのメタデータ

非現行バージョンのオブジェクトに、ライブバージョンのメタデータとは異なる独自のメタデータが存在する場合があります。ここで重要なことは、非現行バージョンはその ACL を保持しており、必ずしもライブバージョンと同じ権限を持っているとは限らないということです。

各バージョンには、それがライブバージョンか非現行バージョンかにかかわらず、メタデータのセットが 1 つ含まれます。また、最新のメタ世代番号のみがメタデータを参照します。古いメタ世代番号を使用して、変更されたメタデータにアクセスすることはできません。

非現行バージョンのオブジェクトのメタデータを更新するには、リクエストでその generation を指定します。read-modify-write セマンティクスの安全性を確保するため、metageneration-match 前提条件を使用できます。この前提条件を使用した場合、メタデータを読み取ってから更新を送信するまでの間に、更新しようとしているメタデータが変更されていると、更新が失敗します。

オブジェクトのバージョニングの例

以下の例では、ファイルを置換、更新、削除したときに、オブジェクトのバージョニングが有効になっているバケット内の cat.jpg ファイルに何が起こるかを示します。

新しい画像をアップロードする

最初に cat.jpg を Cloud Storage にアップロードすると、Cloud Storage は generation 番号と metageneration 番号を受け取ります。この例では、generation 番号は 1360887697105000 です。新しいオブジェクトなので、metageneration 番号は 1 です。

cat.jpg は、オブジェクトのバージョニングが有効になっていない場合でも、generation 番号と metageneration 番号を受け取ります。これらの番号は、オブジェクトのメタデータを表示すると確認できます。

オブジェクトのバージョニングを有効にする

この時点で、バケットのオブジェクトのバージョニングを有効にするかどうかを決定します。有効にしても、cat.jpg の generation 番号または metageneration 番号には影響しません。

画像のメタデータを変更する

カスタムメタデータを追加して（この例では color:black）、cat.jpg のメタデータを更新します。メタデータを更新すると、cat.jpg の metageneration の値が増えます。この例では、1 から 2 になります。ただし、オブジェクト自体は変更されていないため、引き続き cat.jpg の 1 つのバージョンのみが保存され、バージョンの generation 番号は 1360887697105000 のままです。

画像の新しいバージョンをアップロードする

cat.jpg の新しいバージョンを Cloud Storage バケットにアップロードします。新しいバージョンをアップロードすると、オブジェクトのバージョニング機能により、既存の cat.jpg オブジェクトが非現行状態になります。非現行バージョンは、これまでと同じストレージクラスとメタデータを保持します。非現行バージョンは、バージョンを一覧表示した場合にのみ表示されます。通常の一覧表示コマンドでは表示されません。非現行バージョンは cat.jpg#1360887697105000 として参照されます。

一方、新たにアップロードされた cat.jpg は、オブジェクトのライブバージョンになります。この新しい cat.jpg は、固有の generation 番号を取得します。この例では 1360887759327000 です。また、固有のメタデータと metageneration 番号 1 を取得します。つまり、メタデータ color:black は、指定しない限りこれには含まれません。cat.jpg, に対してアクセスまたは変更を行う場合、このバージョンが使用されます。また、cat.jpg のこのバージョンは、その generation 番号でも参照できます。たとえば、Google Cloud CLI を使用する場合は、cat.jpg#1360887759327000 として参照します。

画像のライブバージョンを削除する

次に、cat.jpg を削除します。これにより、世代番号が 1360887759327000 のバージョンが非現行になります。したがって、バケットには cat.jpg の非現行バージョンが 2 つあり、ライブバージョンはありません。非現行バージョンはどちらも generation 番号で参照できますが、generation 番号を指定せずに cat.jpg にアクセスしようとすると失敗します。

同様に、バケットの通常のオブジェクトリストには、バケット内のオブジェクトの 1 つとして cat.jpg は表示されなくなります。非現行バージョンのオブジェクトの一覧表示の詳細については、非現行バージョンのオブジェクトの一覧表示をご覧ください。

オブジェクトのバージョニングを無効にする

オブジェクトのバージョニングを無効にします。これにより、オブジェクトは非現行にならなくなります。オブジェクトの既存の非現行バージョンは Cloud Storage に残ります。オブジェクトのバージョニングを無効にしても、cat.jpg#1360887697105000 と cat.jpg#1360887759327000 は、手動またはオブジェクトのライフサイクル管理で削除しない限り、バケットに引き続き保存されます。

非現行バージョンの 1 つを復元する

オブジェクトのバージョニングを無効にしている場合でも、既存の非現行バージョンのコピーを作成することで、実質的にそのバージョンを復元できます。これにより、バケットには cat.jpg の 3 つのバージョン（2 つの非現行バージョンと復元したライブバージョン）が存在することになります。

オブジェクトのバージョニングのリファレンス

このリファレンス表には、オブジェクトのバージョニングで特定の操作を行うとどのように機能するかを示しています。

オブジェクトのバージョニングのステータス	操作	結果
無効
	`dog.png` を新しいバージョンに置き換えます。	新しいバージョンによってライブバージョンが置き換えられ、新しい世代番号を受け取ります。古いライブバージョンは完全に削除されます。
	ライブバージョンの上に `dog.png` の非現行バージョンをコピーします。¹	非現行バージョンのコピーによってライブバージョンが置き換えられ、新しい世代番号を受け取ります。古いライブバージョンは完全に削除されます。
	`dog.png` を削除します。	`dog.png` が完全に削除されます。
	`dog.png` の非現行バージョンを、その世代番号を指定して削除します。¹	非現行バージョンが完全に削除されます。
有効
	`dog.png` を新しいバージョンに置き換えます。	新しいバージョンによってライブバージョンが置き換えられ、新しい世代番号を受け取ります。古いライブバージョンが非現行バージョンになり、同じ世代番号が維持されます。
	ライブバージョンの上に `dog.png` の非現行バージョンをコピーします。	非現行バージョンのコピーによってライブバージョンが置き換えられ、新しい世代番号を受け取ります。古いライブバージョンが非現行バージョンになり、同じ世代番号が維持されます。
	`dog.png` のライブバージョンを、その世代番号を指定せずに削除します。	ライブバージョンが非現行バージョンになり、同じ世代番号が維持されます。
	`dog.png` のライブバージョンを、その世代番号を指定して削除します。	ライブバージョンが完全に削除されます。
	`dog.png` の非現行バージョンを、その世代番号を指定して削除します。	非現行バージョンが完全に削除されます。

¹ 以前にバケットでオブジェクトのバージョニングが有効になっていた場合、非現行バージョンが存在することがあります。

ファイル復元の動作

非現行オブジェクトバージョンを効率的な手法で現在のライブバージョンに復元できます。復元を行う際の手順ガイドについては、非現行バージョンのオブジェクトを復元するをご覧ください。

オブジェクトのバージョニングを有効にしてこれを行うときに、バケット内にオブジェクトのライブバージョンがすでに存在する場合、Cloud Storage は既存のライブバージョンを置換しますが、新しい非現行バージョンとして保持も行います。この場合、バケットには、置換されたオブジェクト（現在は非現行バージョン）に加えて、以前は非現行バージョンであったオブジェクトの 2 つのコピー（1 つはライブコピーで、もう 1 つはコピー元の非現行バージョン）が存在し、そのすべてにストレージ料金が発生します。不要な費用の発生を防ぐには、現在のライブコピーの作成に使用した非現行バージョンを削除するか、非現行オブジェクトが指定した条件を満たしたときに削除されるように、オブジェクトライフサイクル管理を構成します。

次のステップ

オブジェクトのバージョニングを有効にする方法を確認する。
非現行オブジェクトを操作する。
世代とメタ世代のオブジェクトプロパティについて確認する。
オブジェクトのバージョンを自動的に管理できるオブジェクトのライフサイクル管理について確認する。
オブジェクトのバージョニングに対応するオブジェクトのライフサイクル管理の例を見る。