Get Blob
この記事は機械翻訳されたものです。 記事の文章にポインターを重ねると、原文のテキストが表示されます。
訳文
原文

Get Blob

 

Get Blob 操作が読み取り、または、メタデータやプロパティなど、システムから、blob をダウンロードします。 呼び出すことも Get Blob スナップショットを読み取る。

Get Blob 要求は次のように作成されます。 HTTPS を推奨します。 置換 myaccount 、ストレージ アカウントの名前に置き換えます。

GET メソッド要求の URI

HTTP バージョン

https://myaccount.blob.core.windows.net/mycontainer/myblob

https://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime>

HTTP/1.0

HTTP/1.1

エミュー レートされたストレージ サービスに対する要求を行う場合は、エミュレーターのホスト名ととしての Blob サービス ポートを指定 127.0.0.1:10000, 、その後にエミュー レートされたストレージ アカウント名。

GET メソッド要求の URI

HTTP バージョン

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob

HTTP/1.0

HTTP/1.1

詳細については、次を参照してください。 開発とテストのための Azure ストレージ エミュレーターを使用してします。

要求 URI では、次の追加パラメーターを指定できます。

パラメーター

description

snapshot

省略可能です。 Snapshot パラメーターは非透過的な DateTime 存在する場合は、取得する blob スナップショットを指定する値。 Blob のスナップショットを扱う方法の詳細については、次を参照してください。 Blob のスナップショットを作成します。します。

timeout

省略可能です。 timeout パラメーターは秒単位で表されます。 詳細については、次を参照してください。 BLOB サービス操作のタイムアウトの設定します。

次の表では、必須およびオプションの要求ヘッダーについて説明します。

要求ヘッダー

description

Authorization

必須。

認証スキーム、アカウント名、および署名を指定します。 詳細については、次を参照してください。 Azure ストレージ サービスの認証します。

Date または x-ms-date

必須。

要求の世界協定時刻 (UTC) を指定します。 詳細については、次を参照してください。 Azure ストレージ サービスの認証します。

x-ms-version

匿名の要求の省略可能なすべての認証された要求に必須です。 この要求に使用する操作のバージョンを指定します。 詳細については、次を参照してください。 Azure ストレージ サービスのバージョン管理します。

Range

省略可能です。 指定した範囲内には、blob のバイトのみを返します。

x-ms-range

省略可能です。 指定した範囲内には、blob のバイトのみを返します。 両方 Rangex-ms-range が指定されているサービスの値を使用して x-ms-rangeします。 どちらも指定しない場合は、blob 全体の内容が返されます。 参照してください Blob サービス操作の範囲ヘッダーの指定 の詳細。

x-ms-lease-id:<ID>

省略可能です。 このヘッダーが指定されている場合、操作が実行される次の条件を両方とも満たしている場合のみ。

  • Blob のリースは現在アクティブなです。

  • Blob の要求で指定されたリース ID と一致します。

このヘッダーを指定し、2 つの条件が満たされない場合、要求は失敗し、 Get Blob 操作はステータス コード 412 (Precondition Failed) で失敗します。

x-ms-range-get-content-md5: true

省略可能です。 このヘッダーを設定すると true と共に指定されていると、 Range ヘッダーをサービスを返します範囲については、MD5 ハッシュ、範囲がサイズが 4 MB 以下です。

なしこのヘッダーで指定した場合、 Range ヘッダー、ステータス コード 400 (Bad Request) が返されます。

このヘッダーに設定されている場合は、 true サイズの範囲が 4 MB を超えると、サービスはステータス コード 400 (Bad Request) を返します。

Origin

省略可能です。 その要求の発行元を指定します。 このヘッダーの存在は、クロス オリジン リソース共有 (CORS) ヘッダーを応答になります。

x-ms-client-request-id

省略可能です。 Storage analytics のログが有効な場合に解析ログに記録される 1 KB の文字制限付き、クライアントで生成された非透過の値を提供します。 クライアント側のアクティビティ、サーバーが受信した要求と関連付けるには、このヘッダーを使用することが推奨されます。 詳細については、次を参照してください Storage Analytics Logging についてAzure ロギング:ログ ストレージ要求の追跡を使用したします。

この操作では、blob を読み取る場合、指定した条件を満たした場合にのみ条件ヘッダーの使用もサポートします。 詳細については、次を参照してください。 Blob サービス操作の条件ヘッダーの指定します。

None です。

応答には、HTTP ステータス コード、一連の応答ヘッダー、および blob の内容を含む応答本文が含まれています。

すべての blob を読み取る操作が正常に終了では、状態コード 200 (OK) を返します。

指定した範囲を読み取る操作が正常に終了では、ステータス コード 206 (Partial Content) を返します。

状態コードについては、次を参照してください。 ステータス コードとエラー コードします。

この操作の応答には、次のヘッダーが含まれています。 応答には、追加の標準 HTTP ヘッダーがあります。 準拠している標準ヘッダーはすべて、 、http/1.1 プロトコル仕様します。

構文

description

Last-Modified

日付/時刻、blob が最後に変更されました。 日付の形式は、RFC 1123 に従います。

Blob のメタデータまたはプロパティの更新など、blob を変更する操作は、blob の最終更新時刻を変更します。

x-ms-meta-name:value

ユーザー定義メタデータとしては、この blob に関連付けられている名前と値のペアのセット。

Content-Length

応答本文に含まれるバイト数。

Content-Type

Blob の指定されたコンテンツの種類。 既定のコンテンツ タイプは application/octet-streamです。

Content-Range

クライアントを設定して、blob のサブセットを要求したことを返されるバイトの範囲を示す、 Range 要求ヘッダー。

ETag

ETag には、操作を実行する条件付きで使用できる値が含まれています。 参照してください Blob サービス操作の条件ヘッダーの指定 の詳細。 要求のバージョンが 2011年-08-18 以降では、または引用符で囲まれた ETag の値になります。

Content-MD5

Blob の MD5 ハッシュされ、この場合 Get Blob 操作は、すべての blob を読み取る場合は、この応答ヘッダーは、クライアントがメッセージ コンテンツの整合性チェックできるようにします。

バージョン 2012年-02-12 以降では Put Blob セット ブロック blob の MD5 ハッシュ値場合でも、 Put Blob 要求に MD5 ヘッダーが含まれていません。

要求の範囲を読み取るように指定した場合、 x-ms-range-get-content-md5 に設定されている true, 、範囲のサイズが 4 MB 以下の MD5 ハッシュ、範囲を返します。

True の場合、これらのセットの条件のどちらもしの値が返されないかどうか、 Content-MD5 ヘッダー。

場合 x-ms-range-get-content-md5 なしで指定した、 Range ヘッダー、ステータス コード 400 (Bad Request) が返されます。

場合 x-ms-range-get-content-md5 に設定されている true サイズの範囲が 4 MB を超えると、サービスはステータス コード 400 (Bad Request) を返します。

Content-Encoding

このヘッダーで指定された値を返します、 Content-Encoding 要求ヘッダー。

Content-Language

このヘッダーで指定された値を返します、 Content-Language 要求ヘッダー。

Cache-Control

Blob の指定されていた場合は、このヘッダーが返されます。

Content-Disposition

バージョン 2013年-08-15 に対する要求で返される以降。 このヘッダーで指定された値を返します、 x-ms-blob-content-disposition ヘッダー。

Content-Disposition 応答ヘッダー フィールドは、応答ペイロードを処理する方法に関する追加情報を伝達しも追加のメタデータをアタッチするには使用できます。 たとえば場合に、設定 attachment, 、ユーザー エージェントが、応答を表示せず、代わりに表示する必要がありますことを示します、 名前を付けて保存 指定された blob 名以外のファイル名を含むダイアログ。

x-ms-blob-sequence-number

ページ blob の現在のシーケンス番号。

このヘッダーはブロック blob に対しては返されませんまたは blob を追加します。

x-ms-blob-type: <BlockBlob| PageBlob|AppendBlob>

Blob の型を返します。

x-ms-copy-completion-time:<datetime>

バージョン 2012年-02-12 以降。 まとめ、最後の時刻が試行された Copy Blob この blob がコピー先 blob である操作です。 時、完了、中止、またはコピーの試行に失敗した、この値を指定できます。 コピーが、保留中の場合、このヘッダーは表示されない場合、この blob には、コピー先がかつて、 Copy Blob 操作、あるいはこの blob が変更された場合、完了後 Copy Blob を使用して操作 Set Blob Properties, 、Put Blob, 、または Put Block Listです。

x-ms-copy-status-description: <error string>

バージョン 2012年-02-12 以降。 のみを表示する x-ms-copy-statusfailed または pendingです。 最後の致命的なまたは致命的ではないコピー操作のエラーの原因について説明します。 この blob には、コピー先がかつて場合、このヘッダーは表示されません、 Copy Blob 操作、あるいはこの blob が変更された場合、あるいは後 Copy Blob を使用して操作 Set Blob Properties, 、Put Blob, 、または Put Block Listです。

x-ms-copy-id: <id>

バージョン 2012年-02-12 以降。 最後の文字列識別子が試行された Copy Blob この blob がコピー先 blob である操作です。 この blob には、コピー先がかつて場合、このヘッダーは表示されません、 Copy Blob 操作、あるいはこの blob が変更された場合、あるいは後 Copy Blob を使用して操作 Set Blob Properties, 、Put Blob, 、または Put Block Listです。

x-ms-copy-progress: <bytes copied/bytes total>

バージョン 2012年-02-12 以降。 コピーされたバイトと、最後のソースの合計バイト数を格納しようとした Copy Blob この blob がコピー先 blob である操作です。 0 を表示することができ、 Content-Length コピーされたバイト。 この blob には、コピー先がかつて場合、このヘッダーは表示されません、 Copy Blob 操作、あるいはこの blob が変更された場合、あるいは後 Copy Blob を使用して操作 Set Blob Properties, 、Put Blob, 、または Put Block Listです。

x-ms-copy-source: url

バージョン 2012年-02-12 以降。 URL の最後で、コピー元 blob またはファイルの使用を指定する長さの 2 kb しようとした Copy Blob この blob がコピー先 blob である操作です。 この blob には、コピー先がかつて場合、このヘッダーは表示されません、 Copy Blob 操作、あるいはこの blob が変更された場合、あるいは後 Copy Blob を使用して操作 Set Blob Properties, 、Put Blob, 、または Put Block Listです。

x-ms-copy-status: <pending | success | aborted | failed>

バージョン 2012年-02-12 以降。 X-ms のコピーの id に、これらの値によって識別されるコピー操作の状態。

  • success:コピーが正常に完了しました。

  • pending:コピーが進行中です。 確認 x-ms-copy-status-description 断続的で、致命的なエラーがコピーの進捗が遅れてが失敗するわけです。

  • aborted:によってコピーが終了しました Abort Copy Blobします。

  • failed:コピーに失敗しました。 X-ms-コピーのステータスの説明エラーの詳細についてを参照してください。

この blob には、コピー先がかつて場合、このヘッダーは表示されません、 Copy Blob 操作、あるいはこの blob が変更された場合、完了した後 Copy Blob を使用して操作 Set Blob Properties, 、Put Blob, 、または Put Block Listです。

x-ms-lease-duration: <infinite | fixed>

バージョン 2012年-02-12 以降。 Blob がリースされている場合は、無限と固定期間のリースがかどうかを指定します。

x-ms-lease-state: <available | leased | expired | breaking | broken>

バージョン 2012年-02-12 以降。 リースの blob の状態。

x-ms-lease-status:<locked, unlocked>

Blob の現在のリース ステータス。

x-ms-request-id

このヘッダーは、要求が行われたされ、要求のトラブルシューティングに使用することができますを一意に識別します。 詳細については、次を参照してください。 API 操作のトラブルシューティングします。

x-ms-version

要求の実行に使用する Blob サービスのバージョンを示します。 バージョン 2009年-09-19 を使用して行われる要求の含まれる以降。

このヘッダーは、コンテナーが Blob サービスの 2009年-09-19 バージョンを使用してパブリック アクセス用にマークされたかどうかは、バージョン指定なしにも匿名要求に対して返されます。

Accept-Ranges: bytes

サービスが blob コンテンツの一部の要求をサポートすることを示します。 バージョン 2011年-08-18 を使用して作成された以降の要求および SDK version 1.6 以降のローカル ストレージ サービスに含まれています。

Date

応答の開始時刻を示すサービスによって生成された UTC 日付/時刻値。

Access-Control-Allow-Origin

要求が含まれるかどうかに返される、 Origin 照合ルールでヘッダーと CORS を有効にします。 このヘッダーは、一致が発生した場合にオリジン要求ヘッダーの値を返します。

Access-Control-Expose-Headers

要求が含まれるかどうかに返される、 Origin 照合ルールでヘッダーと CORS を有効にします。 要求の発行者をクライアントに公開される応答ヘッダーの一覧を返します。

Vary

値と共に返される、 Origin ヘッダーの CORS ルールが指定されています。 参照してください 共有 (CORS) のサポート、Azure のストレージ サービスのクロス オリジン リソース 詳細です。

Access-Control-Allow-Credentials

要求が含まれるかどうかに返される、 Origin すべてのオリジンを許可しない照合ルールでヘッダーと CORS を有効にします。 このヘッダーは設定が true に設定します。

x-ms-blob-committed-block-count

Blob 内に存在するコミット後のブロックの数。 このヘッダーは、追加 blob に対してのみ返されます。

応答本文には、blob のコンテンツが含まれています。

Status Response:
HTTP/1.1 200 OK

Response Headers:
x-ms-blob-type: BlockBlob
x-ms-lease-status: unlocked
x-ms-lease-state: available
x-ms-meta-m1: v1
x-ms-meta-m2: v2
Content-Length: 11
Content-Type: text/plain; charset=UTF-8
Date: <date>
ETag: "0x8CB171DBEAD6A6B"
Vary: Origin
Last-Modified: <date>
x-ms-version: 2015-02-21
Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0
x-ms-copy-id: 36650d67-05c9-4a24-9a7d-a2213e53caf6
x-ms-copy-source: <url>
x-ms-copy-status: success
x-ms-copy-progress: 11/11
x-ms-copy-completion-time: <date>

コンテナーのアクセス制御リスト (ACL) が、blob への匿名アクセスを許可するように設定されている場合、任意のクライアントは、この操作を呼び出すことがあります。 コンテナーがプライベートである場合、アカウント所有者と共有アクセス署名を持つ blob を読み取るアクセス許可を持つ任意のユーザーにこの操作を実行できます。

ページ blob の場合、 Get Blob まだがないコンテンツまたはそれらのバイトについてゼロが返されますが消去されたページの範囲内で操作します。

呼び出した場合 Get Blob 範囲が指定されていないページ blob の場合に、サービスには、指定された値までのページ範囲が返されます、 x-ms-blob-content-length ヘッダー。 コンテンツのないページ、それらのバイトについてゼロが返されます。

追加 blob の場合、 Get Blob 操作を返します。 x-ms-blob-committed-block-count ヘッダー。 このヘッダーでは、blob のコミット後のブロックの数を示します。 x-ms-blob-committed-block-count ヘッダーはブロック blob とページ blob に対しては返されません。

A Get Blob 操作が完了する 1 MB あたり 2 分を許可します。 場合は、操作は平均で 1 MB あたり 2 分以上にわたってがかかり、操作はタイムアウトします。

x-ms-version プライベート コンテナーに属する blob を取得するヘッダーが必要です。 場合またはその一部のパブリック アクセスで利用可能なコンテナーに blob が属している、任意のクライアントは、「、; バージョン指定なしサービスのバージョンは、パブリック コンテナーに属する blob を取得する必要はありません。 参照してください コンテナーと Blob へのアクセスの制限 の詳細。

コピー操作

確認する、 Copy Blob 操作が完了したら、最初にいることを確認、 x-ms-copy-id コピー先 blob のヘッダーの値が元の呼び出しによって提供されたコピー ID と一致する Copy Blobです。 一致することを保証する別のアプリケーションのコピーを中止していないを新たに起動 Copy Blob 操作します。 確認し、 x-ms-copy-status: success ヘッダー。 ただし、すべての書き込みを除く blob に対する操作に注意して Lease, 、Put PagePut Block 操作がすべて削除 x-ms-copy-* プロパティが blob からです。 はこれらのプロパティはコピーされませんも Copy Blob 2012年-02-12 より前に、のバージョンを使用する操作。

ときに x-ms-copy-status: failed 、応答に表示されます x-ms-copy-status-description に関する詳細を格納、 Copy Blob 失敗します。

次の表の 3 つのフィールドすべて x-ms-copy-status-description 値。

component

description

HTTP 状態コード

エラーを示す標準の 3 桁の整数。

エラー コード

< ErrorCode > 要素で、Azure によって提供されるエラーを説明するキーワードです。 < ErrorCode > 要素が表示されない場合は、HTTP 仕様で 3 桁の数字の HTTP ステータス コードに関連付けられている標準エラー テキストを含むキーワードが使用されます。 参照してください REST API の一般的なエラー コードします。

Information

引用符で囲まれたエラーの詳細な説明。

次の表の x-ms-copy-statusx-ms-copy-status-description 一般的なエラー シナリオの値。

System_CAPS_important重要

表示される説明テキストはここで、バージョン変更しなくても、警告なしに変更できますにこのテキストと厳密に一致するので依存しないでください。

シナリオ

x ms コピー状態値

x-ms-コピーのステータスの説明の値

コピー操作は正常に完了しました。

成功した場合

Empty

ユーザーは、コピー操作が完了する前に中止しました。

中止されました

Empty

コピー操作中に、コピー元 blob から読み取るときにエラーが発生しましたが、操作は再試行されます。

保留中

502 BadGateway"ソースを読み取るときに、再試行できないエラーが発生しました。 再試行します。 エラーの発生時: < 時刻 >"

コピー操作のコピー先 blob に書き込むときにエラーが発生しましたが、操作は再試行されます。

保留中

500 InternalServerError"再試行可能なエラーが発生しました。 再試行します。 エラーの発生時: < 時刻 >"

コピー操作のコピー元 blob から読み取るときに、修復不可能なエラーが発生しました。

失敗しました

404 ResourceNotFound「コピー元の読み取りに失敗しました」

System_CAPS_noteメモ

Azure が返すエラーを基になるこれをレポートするときに ResourceNotFound < ErrorCode > 要素にします。 応答に < ErrorCode > 要素が表示されていない場合、標準の文字列表現、HTTP ステータスなど NotFound が表示されます。

すべてのコピーを制限するタイムアウト期間の操作が経過しました。 (現在、タイムアウト期間は 2 週間) です。

失敗しました

500 OperationCancelled「コピーを超えている最大許容時間。」

コピー操作の多くの場合、ソースから読み取るときに失敗しましたし、しなかった成功試行の最小比率を満たします。 (このタイムアウトが原因で失敗するまで 2 週間良くないコピー元の再試行)。

失敗しました

500 OperationCancelled「コピー元の読み取りに失敗しました」

表示:
© 2016 Microsoft