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

オブジェクトキーとメタデータ

Amazon S3 の各オブジェクトには、データ、キー、およびメタデータが含まれます。オブジェクトキー(またはキー名)によって、バケット内のオブジェクトは一意に識別されます。オブジェクトメタデータは名前と値のペアのセットです。オブジェクトメタデータは、オブジェクトをアップロードするときに設定できます。オブジェクトのアップロード後にはオブジェクトメタデータは変更できません。オブジェクトメタデータを変更する唯一の方法は、オブジェクトのコピーを作成し、メタデータを設定することです。

オブジェクトキー

オブジェクトを作成するときに、キー名を指定します。これにより、バケット内のオブジェクトは一意に識別されます。たとえば、Amazon S3 コンソール(「AWS マネジメントコンソール」を参照)では、バケットをハイライトすると、そのバケットに含まれるオブジェクトのリストが表示されます。表示される名前がオブジェクトキーです。キー名は一続きの Unicode 文字で、UTF-8 にエンコードすると最大で 1,024 バイト長になります。

注記

Amazon S3 に対するワークロードが 1 秒あたり 100 個のリクエストを超えることが予想される場合、パフォーマンスを最適化するために Amazon S3 キーの命名のガイドラインに従ってください。詳細については、リクエスト率およびリクエストパフォーマンスに関する留意事項 を参照してください。

オブジェクトキーの命名のガイドライン

オブジェクトキー名には任意の UTF-8 文字を使用できますが、キーの命名に関する以下のベストプラクティスに従うことによって、他のアプリケーションとの互換性を最大化することができます。アプリケーションごとに特殊文字の解析方法が異なります。以下のガイドラインは、DNS、ウェブセーフ文字、XML パーサー、その他の API とのコンプライアンスを最大化するのに役立ちます。

セーフ文字

以下の文字セットは、一般的にキー名で使用しても安全です。

  • 英数字 [0 ~ 9a ~ zA ~ Z]

  • 特殊文字 !、-、_、.、*、'、(、および )

有効なオブジェクトキー名の例を次に示します。

  • 4my-organization

  • my.great_photos-2014/jan/myvacation.jpg

  • videos/2014/birthday/video1.wmv

Amazon S3 のデータモデルはフラットな構造です。バケットを作成し、そのバケットにオブジェクトが格納されます。サブバケットやサブフォルダの階層はありません。ただし、Amazon S3 コンソールで使用されているようなキー名のプレフィックスや区切り記号を使用して論理的な階層を暗示できます。Amazon S3 コンソールでは、フォルダの概念をサポートしています。バケット (admin-created) に、次のようなオブジェクトキーを持つ 4 つのオブジェクトがあるとします。

Development/Projects1.xls

Finance/statement1.pdf

Private/taxdocument.pdf

s3-dg.pdf

コンソールでは、キー名のプレフィックス (Development/Finance/Private/) および区切り記号 ("/") を使用して、次のようにフォルダ構造を表します。

s3-dg.pdf キーにはプレフィックスがないため、そのオブジェクトはバケットのルートレベルに直接表示されます。Development/ フォルダを開くと、Projects.xls オブジェクトが表示されます。

注記

Amazon S3 ではバケットとオブジェクトをサポートしていますが、Amazon S3 には階層がありません。ただし、オブジェクトキー名のプレフィックスと区切り記号によって、Amazon S3 コンソールや AWS SDK で階層を暗示し、フォルダの概念を導入できます。

特殊な処理を必要とする可能性がある文字

キー名で以下の文字を使用すると、追加のコード処理が必要になる場合があり、16 進数として URL エンコードまたは参照することが必要になる可能性があります。これらの文字の一部は表示不可能な文字であり、ブラウザで処理されない場合があります。この場合も、特殊な処理が必要です。

アンパサンド("&")

ドル記号("$")

16進数の 00~1F(10 進数の 0~31)の範囲および 7F(10 進数の 127)の ASCII 文字

アットマーク("@")

等号("=")

セミコロン(";")

コロン(":")

プラス記号("+")

スペース – 一部の使用で意味のある一連のスペースが失われる場合があります(特に複数のスペース)

カンマ(",")

疑問符("?")

 

使用しない方がよい文字

すべてのアプリケーションで一貫性を維持するには相当な量の特殊な処理が必要になるため、キー名には以下の文字を使用しないでください。

バックスラッシュ ("\")

左中括弧("{")

表示不可能な ASCII 文字(10 進数の 128 ~ 255 の文字)

カレット("^")

右中括弧("}")

パーセント記号("%")

アクサングラーブ/バックティック("`")

右角括弧("]")

引用符

大なり記号(">")

左角括弧("[")

チルダ("~")

小なり記号("<")

シャープ記号("#")

縦棒/パイプ("|")

オブジェクトメタデータ

メタデータにはシステムメタデータとユーザー定義メタデータの 2 種類があります。

システム定義のメタデータ

Amazon S3 では、バケットに格納されるオブジェクトごとに、一連のシステムメタデータが維持されます。Amazon S3 はこのシステムメタデータを必要に応じて処理します。例えば、Amazon S3 はオブジェクトの作成日とサイズに関するメタデータを維持し、オブジェクト管理の目的でこの情報を使用します。

システムメタデータには 2 つのカテゴリがあります。

  • オブジェクト作成日などのメタデータはシステムによって制御され、Amazon S3 だけがその値を変更できます。

  • オブジェクトについて設定するストレージクラスなどの他のシステムメタデータや、オブジェクトでサーバー側の暗号化が有効になっているかどうかなどは、開発者が値を制御するシステムメタデータの例です。バケットをウェブサイトとして設定している場合、ページリクエストを別のページや外部 URL にリダイレクトしたいことがあります。この場合、ウェブページはバケット内のオブジェクトです。Amazon S3 は、ページリダイレクト値をシステムメタデータとして保存し、ユーザーがその値を制御します。

    オブジェクトを作成するときに、このようなシステムメタデータ項目を設定でき、必要に応じて値を更新できます。ストレージクラスの詳細については「ストレージクラス」を参照してください。 サーバーサイドの暗号化の詳細については、「暗号化を使用したデータの保護」を参照してください。

次の表は、システム定義のメタデータのリストとユーザーがそれを更新できるかどうかをまとめたものです。

名前 説明 ユーザーが値を変更できるか
日付 現在の日付と時刻。 いいえ
Content-Length オブジェクトのサイズ(バイト単位)。 いいえ
Last-Modified

オブジェクト作成日または最終更新日のいずれか遅い方。

いいえ
Content-MD5 オブジェクトの base64 エンコードされた 128 ビット MD5 ダイジェスト。 いいえ
x-amz-server-side-encryption オブジェクトでサーバー側の暗号化が有効であるかどうかと、暗号化が AWS Key Management Service(SSE-KMS)によるものか、AWS で管理された暗号化(SSE-S3)によるものかを示します。詳細については、「サーバー側の暗号化を使用したデータの保護」を参照してください。 はい
x-amz-version-id オブジェクトのバージョン。バケットのバージョニングを有効にすると、Amazon S3 はバケットに追加されたオブジェクトにバージョン番号を割り当てます。詳細については、「バージョニングの使用」を参照してください。 いいえ
x-amz-delete-marker バージョニングが有効にされているバケットで、このブール値マーカーはオブジェクトが削除マーカーであるかどうかを示します。 いいえ
x-amz-storage-class オブジェクトの保存に使われるストレージクラス。詳細については、「ストレージクラス」を参照してください。 はい
x-amz-website-redirect-location 関連付けられたオブジェクトのリクエストを同じバケット内の別のオブジェクトまたは外部 URL にリダイレクトします。詳細については、「(オプション) ウェブページリダイレクトの設定」を参照してください。 はい
x-amz-server-side-encryption-aws-kms-key-id x-amz-server-side-encryption が存在し、値が aws:kms である場合は、オブジェクトに対して使用された Key Management Service (KMS) マスター暗号化キーの ID であることを示します。 はい
x-amz-server-side-encryption-customer-algorithm お客様が用意した暗号化キーを使用したサーバー側の暗号化 (SSE-C) が有効であるかどうかを示します。詳細については、「お客様が用意した暗号化キーによるサーバー側の暗号化(SSE-C)を使用したデータの保護」を参照してください。 はい

ユーザー定義メタデータ

オブジェクトをアップロードするときに、そのオブジェクトにメタデータを割り当てることもできます。このオプション情報は、オブジェクトを作成するための PUT リクエストまたは POST リクエストを送信するときに、名前と値 (キーと値) のペアとして指定します。REST API を使用してオブジェクトをアップロードするときは、他の HTTP ヘッダーと区別するため、オプションのユーザー定義メタデータの名前を「x-amz-meta-」で開始する必要があります。REST API を使用してオブジェクトを取得するときは、このプレフィックスが返されます。SOAP API を使用してオブジェクトをアップロードするとき、このプレフィックスは必要ありません。SOAP API を使用してオブジェクトを取得するときは、オブジェクトのアップロードに使用した API にかかわらず、プレフィックスは削除されます。

注記

SOAP のサポートは HTTP 経由では廃止されましたが、HTTPS 経由では引き続き利用可能です。SOAP 用に Amazon S3 の新機能をサポートする予定はありません。REST API か AWS SDK を使用することをお勧めします。

REST API を介してメタデータを取得するとき、同じ名前を持つヘッダー(大文字と小文字は区別されません)は Amazon S3 によってコンマ区切りリストとして結合されます。出力不可能な文字が含まれているメタデータは返されません。その代わりに、x-amz-missing-meta ヘッダーが、出力不可能なメタデータエントリの数を示す値と共に返されます。

ユーザー定義メタデータはキーと値のペアのセットです。Amazon S3 はユーザー定義メタデータキーを小文字で保存します。キーと値の各ペアは、REST 使用時には US-ASCII に、SOAP の使用時または POST を介したブラウザベースでのアップロード時には UTF-8 に、それぞれ準拠している必要があります。

注記

PUT リクエストヘッダーのサイズは 8 KB に制限されています。PUT リクエストヘッダー内のユーザー定義メタデータのサイズは 2 KB に制限されています。ユーザー定義メタデータのサイズは、キーと値の各ペアを UTF-8 にエンコードしたバイト数の合計に基づいて測定されます。