メニュー
Amazon Simple Storage Service
開発者ガイド (API Version 2006-03-01)

バージョニングが有効なバケットへのオブジェクトの追加

バケットでバージョニングを有効にすると、PUTPOST、または COPY を使用してバケットに保存されているすべてのオブジェクトに、一意のバージョン ID が自動的に追加されます。

次の図は、バージョニングが有効なバケットにオブジェクトが追加されたときに、Amazon S3 がそのオブジェクトに一意のバージョン ID を追加する方法を示しています。

コンソールを使用する

手順については、「オブジェクトを S3 バケットにアップロードする方法」(Amazon Simple Storage Service コンソールユーザーガイド) を参照してください。

AWS SDK の使用

AWS SDK for Java、.NET、PHP を使用してオブジェクトをアップロードする例については、「オブジェクトのアップロード」を参照してください。バージョニングが設定されていないバケットでも、バージョニングが有効なバケットでもオブジェクトをアップロードする例は同じです。ただし、バージョニングが有効なバケットでは、Amazon S3 によってバージョン番号が割り当てられます。それ以外の場合、バージョン番号は null になります。

他の AWS SDK の使用については、サンプルコードとライブラリのページを参照してください。

REST API の使用

バージョニングが有効なバケットへのオブジェクトの追加

1 PUT Bucket versioning リクエストを使用して、バケットでバージョニングを有効にします。詳細については、「PUT Bucket versioning」を参照してください。
2 PUTPOST、または COPY リクエストを送信して、バケットにオブジェクトを格納します。

バージョニングが有効なバケットにオブジェクトを追加すると、オブジェクトのバージョン ID が x-amz-versionid レスポンスヘッダーに入れて返されます。次に例を示します。

Copy
x-amz-version-id: 3/L4kqtJlcpXroDTDmJ+rmSpXd3dIbrHY

注記

通常の Amazon S3 料金は、保存または移行されたオブジェクトのバージョンごとに適用されます。オブジェクトの各バージョンはオブジェクト全体であり、以前のバージョンの単なる差分ではありません。したがって、オブジェクトの 3 つのバージョンを格納している場合、3 つのオブジェクトに対して課金されます。

注記

Amazon S3 が割り当てるバージョン ID の値は URL セーフです(URI の一部として含めることができます)。