次の方法で共有

BLOB のプロパティの取得

  • [アーティクル]

Get Blob Properties 操作は、すべてのユーザー定義メタデータ、標準 HTTP プロパティ、および BLOB のシステム プロパティを返します。 BLOB の内容は返されません。

要求

要求は Get Blob Properties 次のように構築できます。 HTTPS を使用することをお勧めします。 myaccount をストレージ アカウントの名前に置き換えます。

HEAD メソッド要求 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.1

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

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

HEAD メソッド要求 URI HTTP バージョン
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob 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 すべての承認された要求に必要です。 匿名要求の場合は省略可能です。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
x-ms-lease-id: <ID> 省略可能。 このヘッダーを指定した場合、 Get Blob Properties 操作は次の両方の条件が満たされた場合にのみ実行されます。

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

これらの条件のいずれかが満たされない場合、要求は失敗し Get Blob Properties 、状態コード 412 (前提条件が失敗) で操作が失敗します。
x-ms-upn 省略可能。 バージョン 2020-06-12 以降。 階層型名前空間が有効なアカウントに対して有効です。 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 状態コードおよび一連の応答ヘッダーが含まれています。

status code

操作に成功すると、状態コード 200 (OK) が返されます。

状態コードの詳細については、「 状態とエラー コード」を参照してください。

応答ヘッダー

この操作の応答には、次の表のヘッダーが含まれています。 応答に追加の標準 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 にタグがない場合、このヘッダーは返されません。
x-ms-blob-type:<BlockBlob\|PageBlob\|AppendBlob> BLOB の種類。
x-ms-copy-completion-time:<datetime> バージョン 2012-02-12 以降。 この BLOB をコピー先 BLOB として最後に試行された Copy Blob 操作の完了時刻。 この値は、完了、中止、または失敗したコピー試行の時刻を示します。 コピーが保留中の場合、この BLOB が操作のCopy Blob宛先になっていない場合、または 、、または Put Block Listを使用Set Blob PropertiesPut 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 以降。 最後に試行された Copy Blob 操作の文字列識別子。この BLOB は宛先 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 以降。 コピーされたバイト数と、最後に試行された Copy Blob 操作のソース内の合計バイト数 (この BLOB がコピー先 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 以降。 最後に試行された Copy Blob 操作で使用されたソース BLOB (この BLOB は宛先 BLOB) を指定する最大 2 KiB の長さの URL。 このヘッダーは、この BLOB が操作のCopy Blob宛先になっていない場合や、または Put Block Listを使用Set Blob PropertiesPut Blobする終了操作の後にこの BLOB が変更されたCopy Blob場合は表示されません。
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-incremental-copy: true バージョン 2016-05-31 以降。 BLOB が増分コピー BLOB の場合に含まれます。
x-ms-copy-destination-snapshot:<datetime> バージョン 2016-05-31 以降。 BLOB が増分コピー BLOB または増分コピー スナップショットの場合は含まれます (成功した場合x-ms-copy-status)。 この BLOB の最後に成功した増分コピー スナップショットのスナップショット時刻。
x-ms-lease-duration: <infinite \| fixed> BLOB がリースされている場合に、リース期間が無限と固定のどちらであるかを指定します。 バージョン 2012-02-12 以降を使用する要求に含まれます。
x-ms-lease-state: <available \| leased \| expired \| breaking \| broken> BLOB のリース状態。 バージョン 2012-02-12 以降を使用する要求に含まれます。
x-ms-lease-status:<locked\| unlocked> BLOB のリース ステータス。
Content-Length BLOB のサイズ (単位: バイト)。 ページ BLOB の場合、このヘッダーは BLOB と共に x-ms-blob-content-length 格納されているヘッダーの値を返します。
Content-Type BLOB に指定されたコンテンツ タイプ。 コンテンツ タイプが指定されていない場合、既定のコンテンツ タイプは です application/octet-stream。
Etag ETag には、条件に基づく操作の実行に使用できる値が含まれます。 詳細については、「 Blob Storage 操作の条件付きヘッダーを指定する」を参照してください。 要求バージョンが 2011-08-18 以降の場合、ETag 値は引用符で囲まれます。
Content-MD5 Content-MD5 ヘッダーが BLOB に対して設定されている場合、クライアントがメッセージの内容の整合性をチェックできるようにこの応答ヘッダーが返されます。

バージョン 2012-02-12 以降では、 Put Blob 要求に MD5 ヘッダーが含まれていない場合 Put Blob でも、ブロック BLOB の MD5 値を設定します。
Content-Encoding Content-Encoding 要求ヘッダーが BLOB に対して設定されていた場合は、その値がこのヘッダーで返されます。
Content-Language Content-Language 要求ヘッダーが BLOB に対して設定されていた場合は、その値がこのヘッダーで返されます。
Content-Disposition バージョン 2013-08-15 以降に対する要求の場合、Content-Disposition 要求ヘッダーが BLOB に対して設定されていた場合は、その値がこのヘッダーで返されます。

Content-Disposition 応答ヘッダー フィールドは、応答ペイロードを処理する方法に関する追加情報を伝達し、追加のメタデータをアタッチするために使用することもできます。 たとえば、ヘッダーが に attachment設定されている場合、ユーザー エージェントは応答を表示せず、代わりに [名前を付けて保存] ダイアログを表示する必要があることを示します。
Cache-Control Cache-Control 要求ヘッダーが BLOB に対して設定されていた場合は、その値がこのヘッダーで返されます。
x-ms-blob-sequence-number ページ BLOB の現在のシーケンス番号。

このヘッダーは、ブロック BLOB または追加 BLOB には返されません。

ブロック BLOB の場合、このヘッダーは返されません。
x-ms-request-id このヘッダーは、行われた要求を一意に識別し、それを使用して要求のトラブルシューティングを行うことができます。 詳細については、「 API 操作のトラブルシューティング」を参照してください。
x-ms-version 要求の実行に使用されている Blob Storage のバージョンを示します。 このヘッダーは、バージョン 2009-09-19 以降に対して行われた要求に対して返されます。

Blob Storage バージョン 2009-09-19 を使用してコンテナーがパブリック アクセス用にマークされている場合、このヘッダーは、指定されたバージョンのない匿名要求にも返されます。
Date 応答が開始された時刻を示すサービスによって生成される UTC 日付/時刻値。
Accept-Ranges: bytes サービスが BLOB コンテンツの一部に対する要求をサポートすることを示します。 バージョン 2013-08-15 以降を使用して行われた要求に含まれます。
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-access-tier バージョン 2017-04-17 以降。 Premium Storage アカウント上のページ BLOB の層、または Blob Storage または汎用 v2 アカウント内のブロック BLOB の層。 許可されている Premium ページ BLOB 層の一覧については、「VM の高パフォーマンスのPremium Storageとマネージド ディスク」を参照してください。 BLOB ストレージまたは汎用 v2 アカウントの場合、有効な値は Hot、 Cool、 Cold、および Archiveです。 メモ：Cold レベルは、バージョン 2021-12-02 以降でサポートされています。 Standard BLOB アカウント ブロック BLOB レベルの階層化の詳細については 、「ホット、クール、アーカイブストレージ層」を参照してください。
x-ms-access-tier-inferred: true バージョン 2017-04-17 以降。 Premium Storage アカウント上のページ BLOB の場合のみ。 アクセス層が BLOB に明示的に設定されていない場合、その層はコンテンツの長さに基づいて推論され、このヘッダーは の値 trueで返されます。 Blob Storage または汎用 v2 アカウントのブロック BLOB の場合、BLOB にアクセス層が設定されていない場合は、ストレージ アカウントのプロパティから層を推論できます。 このヘッダーは、ブロック BLOB 層が推論される場合にのみ設定されます。
x-ms-archive-status バージョン 2017-04-17 以降。 BLOB ストレージまたは汎用 v2 アカウントの場合、有効な値は rehydrate-pending-to-hot、 rehydrate-pending-to-cool、および rehydrate-pending-to-coldです。 BLOB がリハイドレート中で、不完全な場合は、このヘッダーが返されます。このヘッダーはどちらも、リハイドレートが保留中であることを示し、宛先層を表示します。 Standard BLOB アカウント ブロック BLOB レベルの階層化の詳細については、「 ホット、クール、アーカイブのストレージ層」を参照してください。
x-ms-access-tier-change-time バージョン 2017-04-17 以降。 オブジェクトで層が最後に変更された時刻を示します。 このヘッダーは、ブロック BLOB の層が設定された場合にのみ返されます。 日付形式は RFC 1123 に従います。 詳細については、「 ヘッダーの日付/時刻値を表す」を参照してください。 Standard BLOB アカウント ブロック BLOB レベルの階層化の詳細については、「 ホット、クール、アーカイブのストレージ層」を参照してください。
x-ms-client-request-id 要求とそれに対応する応答のトラブルシューティングに使用できます。 このヘッダーの値 x-ms-client-request-id は、要求に存在し、最大で 1,024 文字の ASCII 文字が表示される場合、ヘッダーの値と等しくなります。 ヘッダーが x-ms-client-request-id 要求に存在しない場合、このヘッダーは応答に存在しません。
x-ms-rehydrate-priority バージョン 2019-12-12 以降。 オブジェクトがリハイドレート保留中の状態の場合、このヘッダーはリハイドレートの優先順位で返されます。 有効な値は です High/Standard。 標準的な BLOB アカウント ブロック BLOB レベルの階層化の詳細については、「 ホット、クール、アーカイブストレージ層」を参照してください。
x-ms-or-{policy-id}_{rule-id} バージョン 2019-12-12 以降。ブロック BLOB に対してのみ返されます。 policy-id は、ストレージ アカウントのオブジェクト レプリケーション ポリシーの識別子を表す GUID 値です。 rule-id は、BLOB コンテナー上のポリシー 規則の識別子を表す GUID 値です。 アカウントが -enabled の場合、このヘッダーの値はObjectReplication、指定されたポリシーとルール識別子 (または failed) complete を持つ BLOB のレプリケーション状態を表します。
x-ms-or-policy-id バージョン 2019-12-12 以降。ブロック BLOB に対してのみ返されます。 アカウントが ObjectReplication-enabled の場合、このヘッダーの値はレプリケーションを制御するポリシーを表します。
x-ms-last-access-time バージョン 2020-02-10 以降。 ストレージ アカウントの最終アクセス時間追跡ポリシーに基づいて、BLOB のデータに最後にアクセスされた時刻を示します。 ストレージ アカウントに最終アクセス時間追跡ポリシーがない場合、またはポリシーが無効になっている場合、ヘッダーは返されません。 ストレージ アカウントの最終アクセス時間追跡ポリシーの設定については、「 Blob Storage 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 以降。 階層型名前空間が有効になっているアカウントの場合のみ。 ファイルまたはディレクトリの ユーザー、 グループ、その 他 に設定されているアクセス許可を返します。 個々のアクセス許可は形式です [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) を返します。
x-ms-expiry-time バージョン 2020-02-10 以降。 階層型名前空間が有効になっているアカウントの場合のみ。 BLOB に設定されている有効期限を返します。 有効期限が設定されているファイルに対してのみ返されます。

応答本文

[なし] :

応答のサンプル

Response Status:  
HTTP/1.1 200 OK  
  
Response Headers:  
x-ms-meta-Name: myblob.txt  
x-ms-meta-DateUploaded: <date>  
x-ms-blob-type: AppendBlob  
x-ms-lease-status: unlocked  
x-ms-lease-state: available  
Content-Length: 11  
Content-Type: text/plain; charset=UTF-8  
Date: <date>  
ETag: "0x8CAE97120C1FF22"  
Accept-Ranges: bytes  
x-ms-blob-committed–block-count: 1  
x-ms-version: 2015-02-21  
Last-Modified: <date>  
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 Properties 承認できます。

重要

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 Propertiesすために必要な RBAC アクションと、このアクションを含む最小特権の組み込み Azure RBAC ロールを次に示します。

Azure RBAC を使用したロールの割り当ての詳細については、「 BLOB データにアクセスするための Azure ロールの割り当て」を参照してください。

注釈

操作が完了したかどうかをCopy Blob判断するには、最初に をチェックして、ヘッダー値が x-ms-copy-id に対する元の呼び出しCopy Blobによって提供されるコピー ID と一致することを確認します。 一致すると、別のアプリケーションでコピーが中止され、新しい Copy Blob 操作が開始されなかったことが保証されます。 次に、 ヘッダーのx-ms-copy-status: successチェックします。 ただし、および 操作を除く LeasePut PageBLOB に対するすべての書き込み操作では、Put BlockBLOB からすべてのx-ms-copy-*プロパティが削除されます。 これらのプロパティは、2012-02-12 より前のバージョンを使用する操作によって Copy Blob もコピーされません。

x-ms-copy-status-description には、Copy Blob のエラーに関する詳細情報が含まれます。 値については x-ms-copy-status-description 、次の表で説明します。

コンポーネント 説明
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 Properties を示しています。

操作 ストレージ アカウントの種類 課金カテゴリ
BLOB のプロパティの取得 Premium ブロック BLOB
Standard 汎用 v2		 その他の操作
BLOB のプロパティの取得 Standard 汎用 v1 操作を読み取ります。

指定した課金カテゴリの価格については、「Azure Blob Storage価格」を参照してください。

こちらもご覧ください

Azure Storage への要求を承認する
状態コードとエラー コード
Blob Storage のエラー コード