Get Blob
Get Blob 操作は、メタデータやプロパティなどの BLOB をシステムから読み取りまたはダウンロードします。
Get Blob を呼び出してスナップショットを読み取ることもできます。
要求
要求は Get Blob 次のように構築できます。 HTTPS を使用することをお勧めします。
myaccount をストレージ アカウントの名前に置き換えます。
| GET メソッド要求 URI | HTTP バージョン |
|---|---|
https://myaccount.blob.core.windows.net/mycontainer/myblobhttps://myaccount.blob.core.windows.net/mycontainer/myblob?snapshot=<DateTime> https://myaccount.blob.core.windows.net/mycontainer/myblob?versionid=<DateTime> |
HTTP/1.0 HTTP/1.1 |
エミュレートされたストレージ サービス URI
エミュレートされたストレージ サービスに対して要求を行うときは、エミュレーターのホスト名とAzure Blob Storageポートを として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 パラメーター
要求 URI には、次の追加パラメーターを指定できます。
| パラメーター | 説明 |
|---|---|
snapshot |
省略可能。 スナップショット パラメーターは不透明DateTimeな値であり、存在する場合は、取得する BLOB スナップショットを指定します。 BLOB スナップショットの操作の詳細については、「BLOB のスナップショットをCreateする」を参照してください。 |
versionid |
オプション、バージョン 2019-12-12 以降。 パラメーターは versionid 不透明 DateTime な値であり、存在する場合は、取得する BLOB のバージョンを指定します。 |
timeout |
省略可能。
timeout パラメーターは、秒単位で表されます。 詳細については、「 Blob Storage 操作のタイムアウトを設定する」を参照してください。 |
要求ヘッダー
必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。
| 要求ヘッダー | 説明 |
|---|---|
Authorization |
必須。 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。 |
Date または x-ms-date |
必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。 |
x-ms-version |
すべての承認された要求に必要です。 匿名要求の場合は省略可能です。 この要求に使用する操作のバージョンを指定します。 匿名要求に対してこのヘッダーを省略すると、サービスはバージョン 2009-09-19 で要求を実行します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。 |
Range |
省略可能。 指定した範囲内の BLOB のバイトのみを返します。 |
x-ms-range |
省略可能。 指定した範囲内の BLOB のバイトのみを返します。
Range と x-ms-range の両方が指定されている場合、サービスは x-ms-range の値を使用します。 どちらの範囲も指定しない場合は、BLOB の内容全体が返されます。 詳細については、「 Blob Storage 操作の範囲ヘッダーを指定する」を参照してください。 |
x-ms-lease-id: <ID> |
省略可能。 このヘッダーを指定した場合、操作は次の両方の条件が満たされた場合にのみ実行されます。 - BLOB のリースは現在アクティブです。 - 要求で指定されたリース ID は、BLOB のリース ID と一致します。 このヘッダーが指定されていても、これらの条件のいずれかが満たされていない場合、要求は失敗し Get Blob 、状態コード 412 (前提条件が失敗) で操作が失敗します。 |
x-ms-range-get-content-md5: true |
省略可能。 このヘッダーが に設定され、ヘッダーとRange共にtrue指定されると、範囲が 4 メビバイト (MiB) 以下である限り、サービスは範囲の MD5 ハッシュを返します。ヘッダーなしで Range ヘッダーが指定されている場合、サービスは状態コード 400 (Bad Request) を返します。範囲が 4 MiB を超えたときに ヘッダーが に true 設定されている場合、サービスは状態コード 400 (Bad Request) を返します。 |
x-ms-range-get-content-crc64: true |
省略可能。 このヘッダーが に設定され、ヘッダーとRange共にtrue指定されると、範囲のサイズが 4 MiB 以下である限り、サービスは範囲の CRC64 ハッシュを返します。ヘッダーなしで Range ヘッダーが指定されている場合、サービスは状態コード 400 (Bad Request) を返します。範囲が 4 MiB を超えたときに ヘッダーが に true 設定されている場合、サービスは状態コード 400 (Bad Request) を返します。ヘッダーと x-ms-range-get-content-crc64 ヘッダーのx-ms-range-get-content-md5両方が存在する場合、要求は 400 (無効な要求) で失敗します。このヘッダーは、バージョン 2019-02-02 以降でサポートされています。 |
Origin |
省略可能。 要求の送信元を指定します。 このヘッダーが存在する場合、応答のクロス オリジン リソース共有 (CORS) ヘッダーになります。 |
x-ms-upn |
省略可能。 バージョン 2023-11-03 以降。 階層型名前空間が有効なアカウントに対して有効です。
true の場合、 でx-ms-ownerx-ms-group返されるユーザー ID 値とx-ms-acl応答ヘッダーは、Microsoft Entraオブジェクト ID からユーザー プリンシパル名に変換されます。 値が false の場合は、オブジェクト ID Microsoft Entraとして返されます。 既定値は false です。 グループおよびアプリケーション オブジェクト ID は一意のフレンドリ名を持たないため、変換されないことに注意してください。 |
x-ms-client-request-id |
省略可能。 ストレージ分析ログが有効になっているときに分析ログに記録される、1 kibibyte (KiB) 文字制限を持つクライアント生成の不透明な値を提供します。 クライアント側のアクティビティをサーバーが受信した要求と関連付ける場合は、このヘッダーを使用することを強くお勧めします。 詳細については、「Azure Storage Analytics ログについて」を参照してください。 |
この操作では、条件ヘッダーを使用して、指定した条件を満たした場合にのみ BLOB を読み取ることもできます。 詳細については、「 Blob Storage 操作の条件付きヘッダーを指定する」を参照してください。
要求ヘッダー (顧客が指定した暗号化キー)
バージョン 2019-02-02 の時点で、要求で次のヘッダーを指定して、顧客が指定したキーで暗号化された BLOB を読み取ることができます。 顧客が指定したキー (および対応するヘッダーのセット) を使用した暗号化は省略可能です。 BLOB が以前に顧客指定のキーで暗号化されている場合は、読み取り操作を正常に完了するために、要求にこれらのヘッダーを含める必要があります。
| 要求ヘッダー | 説明 |
|---|---|
x-ms-encryption-key |
必須。 Base64 でエンコードされた AES-256 暗号化キー。 |
x-ms-encryption-key-sha256 |
省略可能。 暗号化キーの Base64 でエンコードされた SHA256 ハッシュ。 |
x-ms-encryption-algorithm: AES256 |
必須。 暗号化に使用するアルゴリズムを指定します。 このヘッダーの値は AES256 である必要があります。 |
要求本文
[なし] :
Response
応答には HTTP ステータス コード、一連の応答ヘッダー、および BLOB のコンテンツを含む応答本文が含まれます。
status code
BLOB 全体を読み取る操作が正常に終了すると、ステータス コード 200 (OK) が返されます。
指定した範囲を読み取る操作が正常に終了すると、ステータス コード 206 (Partial Content) が返されます。
状態コードの詳細については、「 状態とエラー コード」を参照してください。
応答ヘッダー
この操作の応答には、次のヘッダーが含まれています。 応答に追加の標準 HTTP ヘッダーが含まれる場合もあります。 すべての標準ヘッダーは 、HTTP/1.1 プロトコル仕様に準拠しています。
| 構文 | 説明 |
|---|---|
Last-Modified |
BLOB が最後に変更された日時。 日付形式は RFC 1123 に従います。 BLOB を変更する操作 (BLOB のメタデータまたはプロパティの更新など) を行うと、BLOB の最終更新時刻が変更されます。 |
x-ms-creation-time |
バージョン 2017-11-09 以降。 BLOB が作成された日時。 日付形式は RFC 1123 に従います。 |
x-ms-meta-name:value |
ユーザー定義メタデータとしてこの BLOB に関連付けられている名前と値のペアのセット。 |
x-ms-tag-count |
バージョン 2019-12-12 以降。 BLOB にタグがある場合、このヘッダーは BLOB に格納されているタグの数を返します。 BLOB にタグがない場合、ヘッダーは返されません。 |
Content-Length |
応答本文に含まれるバイト数。 |
Content-Type |
BLOB に指定されたコンテンツ タイプ。 既定のコンテンツの種類は application/octet-stream です。 |
Content-Range |
クライアントが要求ヘッダーを設定して BLOB のサブセットを要求した場合に返されるバイト範囲を Range 示します。 |
ETag |
条件付きで操作を実行するために使用できる値が含まれます。 詳細については、「 Blob Storage 操作の条件付きヘッダーを指定する」を参照してください。 要求バージョンが 2011-08-18 以降の場合、ETag 値は引用符で囲まれます。 |
Content-MD5 |
BLOB に MD5 ハッシュがあり、この Get Blob 操作で BLOB 全体を読み取る場合は、クライアントがメッセージ コンテンツの整合性をチェックできるようにこの応答ヘッダーが返されます。バージョン 2012-02-12 以降では、 Put Blob 要求に MD5 ヘッダーが含まれていない場合 Put Blob でも、ブロック BLOB の MD5 ハッシュ値を設定します。要求が指定された範囲 x-ms-range-get-content-md5 を読み取る場合、 が に true設定されている場合、範囲サイズが 4 MiB 以下である限り、要求は範囲の MD5 ハッシュを返します。これらの条件セットのどちらも でない場合、 trueヘッダーの値は返されません Content-MD5 。x-ms-range-get-content-md5 が Range ヘッダーなしで指定されている場合、サービスはステータス コード 400 (Bad Request) を返します。が に true設定されている場合x-ms-range-get-content-md5、範囲が 4 MiB を超えると、サービスは状態コード 400 (Bad Request) を返します。 |
x-ms-content-crc64 |
要求が指定された範囲を読み取る場合、 x-ms-range-get-content-crc64 が に true設定されている場合、範囲サイズが 4 MiB 以下である限り、要求は範囲の CRC64 ハッシュを返します。 x-ms-range-get-content-crc64 が Range ヘッダーなしで指定されている場合、サービスはステータス コード 400 (Bad Request) を返します。が に true設定されている場合x-ms-range-get-content-crc64、範囲が 4 MiB を超えると、サービスは状態コード 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 以降。 この BLOB が宛先 BLOB であった最後に試行された Copy Blob 操作の終了時刻。 この値は、完了、中止、または失敗したコピー試行の時刻を示します。 コピーが保留中の場合、この BLOB が操作の宛先になっていない場合、または、または Put Block Listを使用Set Blob PropertiesPut Blobした終了操作の後にCopy Blobこの BLOB が変更されたCopy Blob場合、このヘッダーは表示されません。 |
x-ms-copy-status-description: <error string> |
バージョン 2012-02-12 以降。 が failed または pendingの場合x-ms-copy-statusにのみ表示されます。 最後に発生した致命的な、または致命的ではないコピー操作のエラーの原因について説明します。 このヘッダーは、この BLOB が操作のCopy Blob宛先になっていない場合、または 、、または Put Block Listを使用Set Blob PropertiesPut Blobした終了操作の後にこの BLOB が変更されたCopy Blob場合は表示されません。 |
x-ms-copy-id: <id> |
バージョン 2012-02-12 以降。 この BLOB が宛先 BLOB であった最後に試行された Copy Blob 操作の文字列識別子。 このヘッダーは、この BLOB が操作のCopy Blob宛先になっていない場合、または 、、または Put Block Listを使用Set Blob PropertiesPut Blobした終了操作の後にこの BLOB が変更されたCopy Blob場合は表示されません。 |
x-ms-copy-progress: <bytes copied/bytes total> |
バージョン 2012-02-12 以降。 コピーされたバイト数と、この BLOB がコピー先 BLOB であった最後に試行された Copy Blob 操作のソース内の合計バイト数が含まれます。 0 からコピーされたバイトまで Content-Length 表示できます。 このヘッダーは、この BLOB が操作のCopy Blob宛先になっていない場合、または 、、または Put Block Listを使用Set Blob PropertiesPut Blobした終了操作の後にこの BLOB が変更されたCopy Blob場合は表示されません。 |
x-ms-copy-source: url |
バージョン 2012-02-12 以降。 この BLOB が宛先 BLOB であった最後に試行された操作で使用された Copy Blob ソース BLOB またはファイルを指定する、最大 2 KiB の長さの URL。 このヘッダーは、この BLOB が操作のCopy Blob宛先になっていない場合、または 、、または Put Block Listを使用Set Blob PropertiesPut Blobした終了操作の後にこの BLOB が変更されたCopy Blob場合は表示されません。 このヘッダーで返される URL には、ソース BLOB のコピー操作で使用された要求パラメーター (ソース BLOB へのアクセスに使用された共有アクセス署名 (SAS) トークンなど) が含まれます。 |
x-ms-copy-status: <pending | success | aborted | failed> |
バージョン 2012-02-12 以降。 次の値を使用して x-ms-copy-id によって識別されるコピー操作の状態。 - success: コピーが正常に完了しました。- pending: コピーが進行中です。 断続的で致命的でないエラーがコピーの進行状況を遅らせるが、エラーが発生しないかどうかを確認 x-ms-copy-status-description します。- aborted: コピーは によって Abort Copy Blob終了しました。- failed: コピーに失敗しました。 エラーの詳細については、x-ms-copy-status-description を参照してください。このヘッダーは、この BLOB が操作の Copy Blob宛先になっていない場合、または 、、または Put Block Listを使用Set Blob PropertiesPut Blobした操作が完了したCopy Blob後にこの BLOB が変更された場合は表示されません。 |
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 Storage のバージョンを示します。 バージョン 2009-09-19 以降を使用して行われた要求に含まれます。 Blob Storage バージョン 2009-09-19 を使用してコンテナーがパブリック アクセス用にマークされている場合、このヘッダーは、指定されたバージョンのない匿名要求にも返されます。 |
Accept-Ranges: bytes |
サービスが BLOB コンテンツの一部に対する要求をサポートすることを示します。 バージョン 2011-08-18 以降を使用して行われた要求と、SDK バージョン 1.6 以降のローカル ストレージ サービスに含まれます。 |
Date |
サービスによって生成される UTC 日付/時刻値。応答が開始された時刻を示します。 |
Access-Control-Allow-Origin |
要求に Origin ヘッダーが含まれ、照合ルールで CORS が有効な場合に返されます。 このヘッダーは、一致の場合にオリジン要求ヘッダーの値を返します。 |
Access-Control-Expose-Headers |
要求に Origin ヘッダーが含まれ、照合ルールで CORS が有効な場合に返されます。 要求のクライアントや発行元に公開される応答ヘッダーの一覧を返します。 |
Vary |
CORS ルールが指定されている場合に、Origin ヘッダーの値と共に返されます。 詳細については、「 Azure Storage サービスの CORS サポート 」を参照してください。 |
Access-Control-Allow-Credentials |
要求にヘッダーが含まれており Origin 、すべての配信元を許可しない照合ルールで CORS が有効になっている場合に返されます。 このヘッダーは に true設定されます。 |
x-ms-blob-committed-block-count |
BLOB に存在するコミット済みブロックの数。 このヘッダーは、追加 BLOB に対してのみ返されます。 |
x-ms-server-encrypted: true/false |
バージョン 2015-12-11 以降。 指定したアルゴリズムを true 使用して BLOB データとアプリケーション メタデータが完全に暗号化されている場合、このヘッダーの値は に設定されます。 それ以外の場合、値は に false 設定されます (BLOB が暗号化されていない場合、または BLOB またはアプリケーション メタデータの一部のみが暗号化されている場合)。 |
x-ms-encryption-key-sha256 |
バージョン 2019-02-02 以降。 このヘッダーは、BLOB が顧客指定のキーで暗号化されている場合に返されます。 |
x-ms-encryption-context |
バージョン 2021-08-06 以降。 暗号化コンテキスト のプロパティ値が設定されている場合は、設定値が返されます。 アカウントに対して階層型名前空間が有効になっている場合にのみ有効です。 |
x-ms-encryption-scope |
バージョン 2019-02-02 以降。 このヘッダーは、BLOB が暗号化スコープで暗号化されている場合に返されます。 |
x-ms-blob-content-md5 |
バージョン 2016-05-31 以降。 BLOB に MD5 ハッシュがあり、要求に範囲ヘッダー (Range または x-ms-range) が含まれている場合、この応答ヘッダーは BLOB 全体の MD5 値の値で返されます。 この値は、Content-MD5 ヘッダーで返される値と等しい場合と等しくない場合があり、後者は要求された範囲から計算されます。 |
x-ms-client-request-id |
要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、その値に 1,024 文字以下の ASCII 文字が含まれている場合、ヘッダーの値 x-ms-client-request-id と等しくなります。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、このヘッダーは応答に存在しません。 |
x-ms-last-access-time |
バージョン 2020-02-10 以降。 ストレージ アカウントの最終アクセス時間追跡ポリシーに基づいて、BLOB のデータに最後にアクセスされた時刻を示します。 ストレージ アカウントに最終アクセス時間追跡ポリシーがない場合、またはポリシーが無効になっている場合、ヘッダーは返されません。 ストレージ アカウントの最終アクセス時間追跡ポリシーの設定については、「 Blob Service API」を参照してください。 |
x-ms-blob-sealed |
バージョン 2019-12-12 以降。 追加 BLOB の場合にのみ返されます。 追加 BLOB がシールされている場合、値は になります true。 詳細については、「BLOB シールの追加」を参照してください。 |
x-ms-immutability-policy-until-date |
バージョン 2020-06-12 以降。 BLOB に設定される 保持期間を 指定します。 これは、BLOB が変更または削除されないように保護できる日付です。 不変ポリシーが BLOB に設定されている場合にのみ返されます。 このヘッダーの値は、RFC1123形式です。 |
x-ms-immutability-policy-mode: unlocked/locked |
バージョン 2020-06-12 以降。 不変ポリシーが BLOB に設定されている場合に返されます。 値は と lockedですunlocked。
unlocked は、ユーザーが 保持期間 を日付まで増減することでポリシーを変更できる可能性があることを示します。
locked は、これらのアクションが禁止されていることを示します。 |
x-ms-legal-hold: true/false |
バージョン 2020-06-12 以降。 BLOB に訴訟ホールドがない場合、このヘッダーは返されません。 BLOB に true 訴訟ホールドが含まれており、その値が である場合、このヘッダーの値は に設定されます true。 それ以外の場合、BLOB に訴訟ホールドが含まれており、その値が である場合、値は に false 設定されます false。 |
x-ms-owner |
バージョン 2020-06-12 以降。階層型名前空間が有効になっているアカウントに対してのみ。 ファイルまたはディレクトリの所有者ユーザーを返します。 |
x-ms-group |
バージョン 2020-06-12 以降。階層型名前空間が有効になっているアカウントに対してのみ。 ファイルまたはディレクトリの所有グループを返します。 |
x-ms-permissions |
バージョン 2020-06-12 以降。階層型名前空間が有効になっているアカウントに対してのみ。 ファイルまたはディレクトリのユーザー、グループ、およびその他のアクセス許可セットを返します。 個々のアクセス許可は形式です [r,w,x,-]{3} 。 |
x-ms-acl |
バージョン 2023-11-03 以降。 階層型名前空間が有効になっているアカウントの場合のみ。 ファイルまたはディレクトリの ユーザー、 グループ 、 その他 に設定されているアクセスと既定のアクセス制御リストの組み合わせリストを返します。 各アクセス制御エントリ (ACE) は、スコープ、型、ユーザーまたはグループ識別子、および 形式 [scope]:[type]:[id]:[permissions]のアクセス許可で構成されます。 スコープは default 、ACE がディレクトリの既定の ACL に属していることを示します。それ以外の場合、スコープは暗黙的であり、ACE はアクセス ACL に属します。 個々のアクセス許可は形式です [r,w,x,-]{3} 。 |
x-ms-resource-type |
バージョン 2020-10-02 以降。階層型名前空間が有効になっているアカウントに対してのみ。 パスのリソースの種類 (または directoryのいずれかfile) を返します。 |
応答本文
応答本文には 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>
承認
Azure Storage でデータ アクセス操作を呼び出す場合は、承認が必要です。 以下で説明するように、操作を Get Blob 承認できます。
重要
Microsoft では、マネージド ID でMicrosoft Entra IDを使用して、Azure Storage への要求を承認することをお勧めします。 Microsoft Entra IDは、共有キーの承認と比較して優れたセキュリティと使いやすさを提供します。
Azure Storage では、Microsoft Entra IDを使用して BLOB データへの要求を承認することがサポートされています。 Microsoft Entra IDでは、Azure ロールベースのアクセス制御 (Azure RBAC) を使用して、セキュリティ プリンシパルにアクセス許可を付与できます。 セキュリティ プリンシパルには、ユーザー、グループ、アプリケーション サービス プリンシパル、または Azure マネージド ID を指定できます。 セキュリティ プリンシパルは、OAuth 2.0 トークンを返すためにMicrosoft Entra IDによって認証されます。 その後、そのトークンを、Blob service に対する要求を認可するために使用できます。
Microsoft Entra IDを使用した承認の詳細については、「Microsoft Entra IDを使用して BLOB へのアクセスを承認する」を参照してください。
アクセス許可
Microsoft Entraユーザー、グループ、マネージド ID、またはサービス プリンシパルが操作を呼び出Get Blobすために必要な RBAC アクションと、このアクションを含む最小特権の組み込み Azure RBAC ロールを次に示します。
- Azure RBAC アクション:Microsoft.Storage/storageAccounts/blobServices/containers/blobs/read
- 最小特権の組み込みロール:ストレージ BLOB データ閲覧者
Azure RBAC を使用したロールの割り当ての詳細については、「 BLOB データにアクセスするための Azure ロールの割り当て」を参照してください。
注釈
ページ BLOB の場合、コンテンツがまだないページまたは消去されたページの範囲に対する Get Blob 操作では、それらのバイトについてゼロが返されます。
範囲が指定されていないページ BLOB で を呼び出 Get Blob すと、サービスはヘッダーの指定された値までのページの範囲を x-ms-blob-content-length 返します。 コンテンツがないページの場合、サービスはそれらのバイトに対してゼロを返します。
追加 BLOB の場合、操作は Get Blob ヘッダーを x-ms-blob-committed-block-count 返します。 このヘッダーは、BLOB 内のコミットされたブロックの数を示します。 ブロック BLOB またはページ BLOB のヘッダーは x-ms-blob-committed-block-count 返されません。
操作は Get Blob 、MiB ごとに 2 分で完了できます。 操作に MiB あたり平均で 2 分を超える時間がかかる場合、操作はタイムアウトします。
プライベート コンテナーに属する BLOB を取得するには、x-ms-version ヘッダーが必要です。 BLOB が完全または部分的なパブリック アクセスに使用できるコンテナーに属している場合、どのクライアントでもバージョンを指定せずに読み取ることができます。サービス バージョンは、パブリック コンテナーに属する BLOB を取得するために必要ありません。 詳細については、「コンテナーと BLOB へのアクセスの制限」をご覧ください。
Get Blobアーカイブされたブロック BLOB に対する操作は失敗します。
コピー操作
操作が完了したかどうかをCopy Blob判断するには、最初に をチェックして、宛先 BLOB のヘッダー値が、 のCopy Blob元の呼び出しによって提供されたコピー ID と一致していることを確認x-ms-copy-idします。 一致すると、別のアプリケーションでコピーが中止され、新しい Copy Blob 操作が開始されなかったことが保証されます。 次に、 ヘッダーのx-ms-copy-status: successチェックします。 ただし、および 操作を除く LeasePut PageBLOB に対するすべての書き込み操作では、Put BlockBLOB からすべてのx-ms-copy-*プロパティが削除されます。 これらのプロパティは、2012-02-12 より前のバージョンの Blob Storage を使用する操作によって Copy Blob もコピーされません。
警告
ヘッダーで返される URL には、ソース BLOB の x-ms-copy-source コピー操作で使用された要求パラメーターが含まれています。 SAS トークンを使用してソース BLOB にアクセスする場合、その SAS トークンは、ターゲット BLOB で x-ms-copy-source が呼び出されたときに Get Blob ヘッダーに表示されます。
x-ms-copy-status: failed が応答に表示されている場合、x-ms-copy-status-description には、Copy Blob エラーに関する詳細が含まれます。
次の表では、すべての x-ms-copy-status-description 値の 3 つのフィールドについて説明します。
| コンポーネント | 説明 |
|---|---|
| HTTP 状態コード | エラーを指定する標準の 3 桁の整数。 |
| エラー コード | ErrorCode> 要素で Azure によって提供されるエラーを説明する<キーワード (keyword)。 ErrorCode> 要素が表示されない<場合は、HTTP 仕様の 3 桁の HTTP 状態コードに関連付けられている標準エラー テキストを含むキーワード (keyword)が使用されます。 「一般的な REST API エラー コード」を参照してください。 |
| Information | エラーの詳細な説明を引用符で囲みます。 |
x-ms-copy-status一般的なエラー シナリオの 値と x-ms-copy-status-description 値を次の表に示します。
重要
この表のエラーの説明は、バージョンの変更がなくても警告なしで変更される可能性があるため、テキストと正確に一致しない可能性があります。
| シナリオ | x-ms-copy-status 値 | x-ms-copy-status-description 値 |
|---|---|---|
| コピー操作が正常に完了した。 | success | empty |
| コピー操作が完了する前にユーザーが操作を中止した。 | aborted | empty |
| コピー操作の実行中、コピー元 BLOB からの読み取り時にエラーが発生したが、操作が再試行される。 | pending | 502 BadGateway "コピー元の読み取り時に再試行可能なエラーが発生しました。 再試行します。 失敗時刻: <時間>" |
| コピー操作でコピー先 BLOB への書き込み時にエラーが発生したが、操作が再試行される。 | pending | 500 InternalServerError "再試行可能なエラーが発生しました。 再試行します。 失敗時刻: <時間>" |
| コピー操作でコピー元 BLOB からの読み取り時に回復不能なエラーが発生した。 | 失敗 | 404 ResourceNotFound "コピー元の読み取り時にコピーに失敗しました。" メモ：サービスは、この基になるエラーを報告すると、 要素で を ErrorCode返しますResourceNotFound。 応答に要素が表示されない ErrorCode 場合は、 などの NotFoundHTTP 状態の標準文字列表現が表示されます。 |
| すべてのコピー操作を制限するタイムアウト期間が経過した (現在、タイムアウト期間は 2 週間です)。 | 失敗 | 500 OperationCancelled "コピーの最大許容時間を超えました。" |
| ソースからの読み取り時にコピー操作が頻繁に失敗し、成功に対する試行の最小比率を満たしませんでした。 (このタイムアウトにより、失敗する前に 2 週間にわたって非常に貧弱なソースを再試行できなくなります)。 | 失敗 | 500 OperationCancelled "コピー元の読み取り時にコピーに失敗しました。" |
x-ms-last-access-time は、ストレージ アカウントの最終アクセス時間追跡ポリシーに基づいて、BLOB のデータがアクセスされた時刻を追跡します。 BLOB のメタデータにアクセスしても、最後のアクセス時刻は変更されません。
請求
価格要求は、Blob Storage REST API を介して直接、または Azure Storage クライアント ライブラリを介して Blob Storage API を使用するクライアントから送信できます。 これらの要求では、トランザクションあたりの料金が発生します。 トランザクションの種類は、アカウントの課金方法に影響します。 たとえば、読み取りトランザクションは、書き込みトランザクションとは異なる課金カテゴリに計上されます。 次の表は、ストレージ アカウントの種類に基づく要求の課金カテゴリ Get Blob を示しています。
| 操作 | ストレージ アカウントの種類 | 課金カテゴリ |
|---|---|---|
| Get Blob | Premium ブロック BLOB Standard 汎用 v2 Standard 汎用 v1 |
操作を読み取ります。 |
指定した課金カテゴリの価格については、「Azure Blob Storage価格」を参照してください。
こちらもご覧ください
Azure Storage への要求を承認する
状態コードとエラー コード
Blob Storage のエラー コード
Blob Storage 操作のタイムアウトを設定する