Get Blob

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

Request

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>

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

HTTP/1.0

HTTP/1.1

エミュレートされたストレージ サービス URI

エミューレートされたストレージ サービスに対する要求では、エミュレーターのホスト名と BLOB Service ポートを 127.0.0.1:10000 と指定し、その後にエミューレートされたストレージ アカウント名を指定します。

GET メソッド要求の URI HTTP バージョン
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.0

HTTP/1.1

詳細については、「 開発とテストのための Azure Storage Emulator の使用」を参照してください。

URI パラメーター

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

パラメーター 説明
snapshot 省略可能。 snapshot パラメーターは、BLOB のスナップショットが存在する場合に、取得するスナップショットを指定する非透過的な DateTime 値です。 BLOB スナップショットの操作の詳細については、「BLOB の スナップショットの作成」を参照してください。
versionid オプション、バージョン 2019-12-12 以降。 versionid パラメーターは不透明 DateTime な値であり、存在する場合は、取得する BLOB のバージョンを指定します。
timeout 省略可能。 timeout パラメーターは、秒単位で表されます。 詳細については、「 Blob Service 操作のタイムアウトの設定」を参照してください

要求ヘッダー

必須要求ヘッダーと省略可能な要求ヘッダーを次の表に示します。

要求ヘッダー 説明
Authorization 必須。 承認スキーム、アカウント名、および署名を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。
Date または x-ms-date 必須。 要求に対して協定世界時 (UTC) を指定します。 詳細については、「Azure Storage への要求を承認する」をご覧ください。
x-ms-version すべての承認された要求に必要です。匿名要求の場合は省略可能です。 この要求に使用する操作のバージョンを指定します。 匿名要求に対してこのヘッダーを省略すると、サービスはバージョン 2009-09-19 で要求を実行します。 詳細については、「 Azure Storage Services のバージョン管理」を参照してください。
Range 省略可能。 指定した範囲内の BLOB のバイトのみ返します。
x-ms-range 省略可能。 指定した範囲内の BLOB のバイトのみ返します。 Rangex-ms-range の両方が指定されている場合、サービスは x-ms-range の値を使用します。 どちらも指定しない場合は、BLOB 全体の内容が返されます。 詳細については、「 Blob Service 操作の範囲ヘッダーの指定 」を参照してください。
x-ms-lease-id: <ID> 省略可能。 このヘッダーを指定すると、次の 2 つの条件を満たした場合にのみ操作が実行されます。

- BLOB のリースは現在アクティブです。
- 要求で指定されたリース ID は、BLOB のリース ID と一致します。

このヘッダーを指定すると、2 つの条件を満たしていない場合は要求が失敗し、Get Blob 操作はステータス コード 412 (Precondition Failed) で失敗します。
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-md5x-ms-range-get-content-crc64 ヘッダーが存在する場合、要求は 400 (無効な要求) で失敗します。

このヘッダーは、バージョン 2019-02-02 以降でサポートされています。
Origin 省略可能。 要求の送信元を指定します。 このヘッダーが存在する場合、応答のクロス オリジン リソース共有 (CORS) ヘッダーになります。
x-ms-client-request-id 省略可能。 ストレージ分析ログが有効になっているときに分析ログに記録される 1 KiB 文字制限を持つ、クライアントによって生成された不透明な値を提供します。 クライアント側のアクティビティをサーバーが受信した要求と関連付けるには、このヘッダーを使用することが強く推奨されます。 詳細については、「Storage Analytics ログAzure ログ: ログを使用してストレージ要求を追跡する」を参照してください。

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

要求ヘッダー (顧客が指定した暗号化キー)

バージョン 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 である必要があります。

要求本文

[なし] :

応答

応答には HTTP ステータス コード、一連の応答ヘッダー、および BLOB のコンテンツを含む応答本文が含まれます。

状態コード

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 Range 要求ヘッダーを設定することで、クライアントが BLOB のサブセットを要求した場合に返されるバイトの範囲を示します。
ETag ETag には、条件に基づく操作の実行に使用できる値が含まれます。 詳細については、「 BLOB サービス操作の条件付きヘッダーの指定 」を参照してください。 要求バージョンが 2011-08-18 またはそれ以降である場合、ETag 値は引用符で囲まれます。
Content-MD5 BLOB に MD5 ハッシュがあり、この Get Blob 操作で BLOB 全体を読み取る場合は、クライアントがメッセージ コンテンツの整合性をチェックできるようにこの応答ヘッダーが返されます。

バージョン 2012-02-12 以降では、Put Blob は、Put Blob 要求に MD5 ヘッダーが含まれない場合でも、ブロック BLOB の MD5 ハッシュ値を設定します。

要求が指定された範囲を読み取る場合、 x-ms-range-get-content-md5 その範囲のサイズが true4 MiB 以下である限り、要求は範囲の MD5 ハッシュを返します。

これらの条件セットのいずれも真でない場合は、Content-MD5 ヘッダーの値は返されません。

x-ms-range-get-content-md5Range ヘッダーなしで指定されている場合、サービスはステータス コード 400 (Bad Request) を返します。

範囲のサイズが 4 MiB をtrue超える場合x-ms-range-get-content-md5、サービスは状態コード 400 (無効な要求) を返します。
x-ms-content-crc64 要求が指定された範囲を読み取る場合、 x-ms-range-get-content-crc64 その範囲のサイズが true4 MiB 以下である限り、要求は範囲の CRC64 ハッシュを返します。

x-ms-range-get-content-crc64Range ヘッダーなしで指定されている場合、サービスはステータス コード 400 (Bad Request) を返します。

範囲のサイズが 4 MiB をtrue超える場合x-ms-range-get-content-crc64、サービスは状態コード 400 (無効な要求) を返します。
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 操作の完了時刻。 この値は、完了、中止、または失敗したコピー試行の時刻を示します。 コピーが保留中の場合、Copy Blob 操作でこの BLOB がコピー先になったことがない場合、あるいは Copy BlobSet Blob Properties、または Put Blob を使用した Put Block List 操作の完了後にこの BLOB が変更された場合には、このヘッダーは表示されません。
x-ms-copy-status-description: <error string> バージョン 2012-02-12 以降。 x-ms-copy-statusfailed または pending である場合にのみ表示されます。 最後に発生した致命的な、または致命的ではないコピー操作のエラーの原因について説明します。 Copy Blob 操作でこの BLOB がコピー先になったことがない場合、あるいは Copy BlobSet Blob Properties、または Put Blob を使用した Put Block List 操作の完了後にこの BLOB が変更された場合には、このヘッダーは表示されません。
x-ms-copy-id: <id> バージョン 2012-02-12 以降。 この BLOB をコピー先 BLOB として最後に試行された Copy Blob 操作の文字列識別子。 Copy Blob 操作でこの BLOB がコピー先になったことがない場合、あるいは Copy BlobSet Blob Properties、または Put Blob を使用した Put Block List 操作の完了後にこの BLOB が変更された場合には、このヘッダーは表示されません。
x-ms-copy-progress: <bytes copied/bytes total> バージョン 2012-02-12 以降。 この BLOB をコピー先 BLOB として最後に試行された Copy Blob 操作における、コピー元のコピーされたバイト数と合計バイト数が含まれます。 示される値の範囲は、0 からコピーされた Content-Length のバイト数です。 Copy Blob 操作でこの BLOB がコピー先になったことがない場合、あるいは Copy BlobSet Blob Properties、または Put Blob を使用した Put Block List 操作の完了後にこの BLOB が変更された場合には、このヘッダーは表示されません。
x-ms-copy-source: url バージョン 2012-02-12 以降。 この BLOB が宛先 BLOB であった最後に試行された操作で使用された Copy Blob ソース BLOB またはファイルを指定する最大 2 KiB の長さの URL。 Copy Blob 操作でこの BLOB がコピー先になったことがない場合、あるいは Copy BlobSet Blob Properties、または Put Blob を使用した Put Block List 操作の完了後にこの 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 を参照してください。

Copy Blob 操作でこの BLOB がコピー先になったことがない場合、あるいは Copy BlobSet Blob Properties、または Put Blob を使用した Put Block List 操作の完了後にこの 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 サービスのバージョンを示します。 バージョン 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 CORS ルールが指定されている場合に、Origin ヘッダーの値と共に返されます。 詳細については、 ストレージ サービスの 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 データとアプリケーション メタデータが完全に暗号化される場合に設定されます。 それ以外の場合、値は (BLOB が暗号化されていない場合、または BLOB/アプリケーション メタデータの一部のみが暗号化されている場合) に false 設定されます。
x-ms-encryption-key-sha256 バージョン 2019-02-02 以降。 このヘッダーは、BLOB が顧客指定のキーで暗号化されている場合に返されます。
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 このヘッダーは、要求と対応する応答のトラブルシューティングに使用できます。 このヘッダーの値は、要求に存在し、値が最大 1024 の 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 に設定されている場合に返されます。 値は unlocked/locked. 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 以降は、階層型名前空間が有効になっているアカウントに対してのみ有効です。 ファイルまたはディレクトリの 'user'、'group'、および 'other' に設定されたアクセス許可を返します。 個々のアクセス許可は [r,w,x,-]{3} 形式です。
x-ms-resource-type 階層型名前空間が有効になっているアカウントに対してのみ、バージョン 2020-10-02 以降。 パスのリソースの種類を返します。どちらでも file/directoryかまいません。

応答本文

応答本文には 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: Access Control List) が BLOB の匿名アクセスを許可するように設定されている場合、クライアントはこの操作を呼び出すことができます。 コンテナーがプライベートの場合、この操作は、アカウント所有者と、この BLOB に対する読み取りアクセス許可がある共有アクセス署名を持つ任意のユーザーのみが実行できます。

注釈

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

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

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

Get Blob操作は、MiB ごとに 2 分で完了できます。 操作に平均して MiB あたり 2 分を超える時間がかかる場合、操作はタイムアウトになります。

プライベート コンテナーに属する BLOB を取得するには、x-ms-version ヘッダーが必要です。 BLOB が、完全または部分的なパブリック アクセスに使用可能なコンテナーに属する場合、クライアントはその BLOB をバージョン指定なしで読み取ることができます。パブリック コンテナーに属する BLOB の取得では、サービス バージョンは不要です。 詳細については、 コンテナーと BLOB へのアクセスの制限 を参照してください。

Get Blobアーカイブされたブロック BLOB の A は失敗します。

コピー操作

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

警告

ヘッダーに x-ms-copy-source 返される URL には、ソース BLOB のコピー操作で使用されるすべての要求パラメーターが含まれています。 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 によって提供されるエラーを記述する<キーワード。 ErrorCode> 要素が表示されない<場合は、HTTP 仕様の 3 桁の HTTP 状態コードに関連付けられている標準エラー テキストを含むキーワードが使用されます。 一般的な REST API エラー コードを参照してください。
情報 引用符で囲まれたエラーの詳しい説明。

一般的なエラー シナリオの x-ms-copy-statusx-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 "コピー元の読み取り時にコピーに失敗しました。"

メモ:この基になるエラーを報告すると、Azure は要素をErrorCode返しますResourceNotFound。 応答に要素が表示されない ErrorCode 場合は、HTTP 状態の標準文字列表現が NotFound 表示されます。
すべてのコピー操作を制限するタイムアウト期間が経過した (現在、タイムアウト期間は 2 週間です)。 失敗 500 OperationCancelled "コピーの最大許容時間を超えました。"
コピー元からの読み取り時にコピー操作が何度も失敗しており、試行の最小成功率に達していなかった (このタイムアウトにより、失敗まで 2 週間にわたって状態の良くないコピー元に対して再試行が繰り返されるのを防ぎます)。 失敗 500 OperationCancelled "コピー元の読み取り時にコピーに失敗しました。"

x-ms-last-access-time は、ストレージ アカウントの最後のアクセス時間追跡ポリシーに基づいて、BLOB のデータがアクセスされた時刻を追跡します。 BLOB のメタデータにアクセスしても、最後のアクセス時間は変更されません。

こちらもご覧ください

Azure Storage への要求を承認する
ステータス コードとエラー コード
BLOB サービスのエラー コード
BLOB サービス操作のタイムアウトの設定