エクスポート (0) 印刷
すべて展開

BLOB リソースのプロパティとメタデータの設定および取得

更新日: 2013年11月

コンテナーと BLOB は、HTTP ヘッダーとして表記されるカスタムのメタデータをサポートしています。メタデータ ヘッダーは、新しいコンテナー リソースまたは BLOB リソースを作成する要求、または既存のリソースのプロパティを明示的に作成する要求に設定できます。

このトピックは、次のサブトピックに分かれています。

メタデータ ヘッダーの形式

メタデータに対する操作

コンテナーおよび BLOB の標準 HTTP プロパティ

メタデータ ヘッダーは、名前と値のペアの形式で指定します。ヘッダーの形式は次のとおりです。

x-ms-meta-name:string-value

バージョン 2009-09-19 以降では、メタデータの名前は C# 識別子の名前付け規則に従う必要があります。

名前の大文字と小文字は区別されません。メタデータ名の作成時に指定された大文字と小文字の違いは維持されますが、設定時または読み取り時には大文字と小文字は区別されません。リソースに対して同じ名前の複数のメタデータ ヘッダーが送信された場合、BLOB サービスはステータス コード 400 (Bad Request) を返します。

メタデータの合計サイズは、名前と値の両方を含めて、8 KB 以内に制限されます。

メタデータの名前と値のペアは有効な HTTP ヘッダーです。つまり、HTTP ヘッダーに関する制約がすべて適用されます。

BLOB リソースまたはコンテナー リソースのメタデータは、リソースのコンテンツを返したり変更したりすることなく、直接取得または設定できます。

メタデータの値の読み取りや書き込みは値全体に対して行うことができます。部分的な更新はサポートされていません。リソースに関するメタデータを設定すると、そのリソースの既存のメタデータ値が上書きされます。

GET 操作と HEAD 操作は両方とも、指定したコンテナーまたは BLOB のメタデータ ヘッダーを取得します。これらの操作はヘッダーのみを返し、応答の本文は返しません。

コンテナーに関するメタデータ ヘッダーを取得する際の URI の構文は、次のとおりです。

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer?restype=container

BLOB に関するメタデータ ヘッダーを取得する際の URI の構文は、次のとおりです。

GET/HEAD https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

PUT 操作は、指定したコンテナーまたは BLOB に関するメタデータ ヘッダーを設定し、該当するリソースに関する既存のメタデータを上書きします。要求にヘッダーを指定せずに PUT を呼び出した場合は、該当するリソースに関する既存のメタデータがすべて消去されます。

コンテナーに関するメタデータ ヘッダーを設定する際の URI の構文は、次のとおりです。

PUT https://myaccount.blob.core.windows.net/mycontainer?comp=metadata?restype=container

BLOB に関するメタデータ ヘッダーを設定する際の URI の構文は、次のとおりです。

PUT https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=metadata

コンテナーおよび BLOB は、特定の標準 HTTP プロパティもサポートしています。プロパティとメタデータは両方とも標準の HTTP ヘッダーとして表記されますが、ヘッダー名の付け方に違いがあります。メタデータのヘッダー名は、プレフィックス x-ms-meta- とカスタム名で構成されます。プロパティのヘッダーは、HTTP/1.1 プロトコル仕様の第 14 セクション「Header Field Definitions」の指定に準拠した、標準の HTTP ヘッダー名を使用します。

コンテナーでサポートされている標準 HTTP ヘッダーは次のとおりです。

  • ETag

  • Last-Modified

BLOB でサポートされている標準 HTTP ヘッダーは次のとおりです。

  • ETag

  • Last-Modified

  • Content-Length

  • Content-Type

  • Content-MD5

  • Content-Encoding

  • Content-Language

  • Cache-Control

関連項目

表示:
© 2014 Microsoft