次の方法で共有

BLOB のプロパティを取得する

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

Request

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

HEAD メソッド要求 URI HTTP version
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 version
http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob HTTP/1.1

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

URI parameters

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

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

Request headers

次の表では、必須の要求ヘッダーと省略可能な要求ヘッダーについて説明します。

Request header Description
Authorization Required. 承認スキーム、アカウント名、署名を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。
Date または x-ms-date Required. 要求の世界協定時刻 (UTC) を指定します。 詳細については、「Azure Storageへの要求を承認する」を参照してください。
x-ms-version すべての承認された要求に必要です。 匿名リクエストの場合は省略可能です。 この要求に使用する操作のバージョンを指定します。 詳細については、「Azure Storage サービスのバージョン管理」を参照してください。
x-ms-lease-id: <ID> Optional. このヘッダーを指定すると、次の条件の両方が満たされる場合にのみ Get Blob Properties 操作が実行されます。

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

これらの条件のいずれかが満たされない場合、要求は失敗し、 Get Blob Properties 操作は状態コード 412 (前提条件の失敗) で失敗します。
x-ms-upn Optional. バージョン 2020-06-12 以降。 階層型名前空間が有効になっているアカウントに有効です。 true の場合、x-ms-owner、x-ms-group、x-ms-acl 応答ヘッダーで返されるユーザー ID 値は、Microsoft Entra オブジェクト ID からユーザー プリンシパル名に変換されます。 値が false の場合、Microsoft Entra オブジェクト ID として返されます。 既定値は false です。 グループ オブジェクト ID とアプリケーション オブジェクト ID は、一意のフレンドリ名がないため、翻訳されないことに注意してください。
x-ms-client-request-id Optional. 1 キビバイト (KiB) の文字制限を持つクライアント生成の不透明な値を提供し、ストレージ分析ログが有効になっている場合に分析ログに記録されます。 サーバーが受信した要求とクライアント側のアクティビティを関連付ける場合は、このヘッダーを使用することを強くお勧めします。 詳細については、「 Azure Storage Analytics ログについて」を参照してください。

この操作では、条件付きヘッダーを使用して、指定された条件が満たされた場合にのみ BLOB プロパティとメタデータを返すこともできます。 詳細については、「Blob Storage 操作の条件付きヘッダーを指定する」を参照してください。

要求ヘッダー (顧客提供の暗号化キー)

バージョン 2019-02-02 の時点では、顧客提供のキーで暗号化された BLOB を読み取るための要求に次のヘッダーを指定できます。 お客様が指定したキー (および対応するヘッダーのセット) による暗号化はオプションです。 BLOB が以前に顧客提供のキーで暗号化されている場合は、読み取り操作を正常に完了できるように、要求にこれらのヘッダーを含める必要があります。

Request header Description
x-ms-encryption-key Required. Base64 でエンコードされた AES-256 暗号化キー。
x-ms-encryption-key-sha256 Optional. 暗号化キーの Base64 でエンコードされた SHA256 ハッシュ。
x-ms-encryption-algorithm: AES256 Required. 暗号化に使用するアルゴリズムを指定します。 このヘッダーの値は AES256 である必要があります。

Request body

None.

Response

応答には、HTTP 状態コードと一連の応答ヘッダーが含まれます。

Status code

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

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

Response headers

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

Response header Description
Last-Modified BLOB が最後に変更された日付/時刻。 日付形式は RFC 1123 に従います。 詳細については、「ヘッダーの日付/時刻値を表す」を参照してください。

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

4 TiB を超えるマネージド ディスクとマネージド ディスク スナップショットでは、 Last-Modified は返されないことに注意してください。
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操作の宛先になったことがない場合、または Set Blob Properties、Put Blob、または Put Block List を使用する終了したCopy Blob操作後にこの BLOB が変更された場合には表示されません。
x-ms-copy-status-description: <error string> バージョン 2012-02-12 以降。 x-ms-copy-statusがfailedまたはpendingの場合にのみ表示されます。 致命的または致命的でないコピー操作の失敗の原因について説明します。 このヘッダーは、この BLOB がCopy Blob操作の宛先になったことがない場合、または Set Blob Properties、Put Blob、または Put Block List を使用する終了したCopy Blob操作後にこの BLOB が変更された場合には表示されません。
x-ms-copy-id: <id> バージョン 2012-02-12 以降。 最後に試行された Copy Blob 操作の文字列識別子で、この BLOB が宛先 BLOB でした。 このヘッダーは、この BLOB がCopy Blob操作の宛先になったことがない場合、または Set Blob Properties、Put Blob、または Put Block List を使用する終了したCopy Blob操作後にこの BLOB が変更された場合には表示されません。
x-ms-copy-progress: <bytes copied/bytes total> バージョン 2012-02-12 以降。 コピーされたバイト数と、最後に試行された Copy Blob 操作でソースの合計バイト数 (この BLOB が宛先 BLOB) が含まれます。 コピーされたバイトを 0 から Content-Length まで表示できます。 このヘッダーは、この BLOB がCopy Blob操作の宛先になったことがない場合、または Set Blob Properties、Put Blob、または Put Block List を使用する終了したCopy Blob操作後にこの BLOB が変更された場合には表示されません。
x-ms-copy-source: url バージョン 2012-02-12 以降。 最後に試行された Copy Blob 操作で使用されたソース BLOB を指定する、最大 2 KiB の長さの URL(この BLOB が宛先 BLOB でした)。 このヘッダーは、この BLOB がCopy Blob操作の宛先になったことがない場合、または Set Blob Properties、Put Blob、または Put Block List を使用する終了したCopy Blob操作後にこの 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操作の宛先になったことがない場合、または Set Blob Properties、Put Blob、または Put Block List を使用する完了した 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 BLOB に Content-MD5 ヘッダーが設定されている場合は、クライアントがメッセージ コンテンツの整合性を確認できるように、この応答ヘッダーが返されます。

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

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 以降。 このヘッダーの値は、BLOB データとアプリケーション メタデータが指定されたアルゴリズムを使用して完全に暗号化されている場合に true に設定されます。 それ以外の場合、値は 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 以降でサポートされています。 標準の 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 がリハイドレート中で不完全な場合は、このヘッダーが返され、リハイドレートが保留中であることを示し、宛先層が表示されます。 標準の BLOB アカウント ブロックの BLOB レベルの階層化の詳細については、「 ホット、クール、アーカイブのストレージ層」を参照してください。
x-ms-access-tier-change-time バージョン 2017-04-17 以降。 オブジェクトで層が最後に変更された時刻を示します。 このヘッダーは、ブロック BLOB の層が設定された場合にのみ返されます。 日付形式は RFC 1123 に従います。 詳細については、「ヘッダーの日付/時刻値を表す」を参照してください。 標準の 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 値です。 アカウントが ObjectReplication有効になっている場合、このヘッダーの値は、指定されたポリシーとルール識別子 ( complete または failed) を持つ BLOB のレプリケーション状態を表します。
x-ms-or-policy-id バージョン 2019-12-12 以降では、ブロック BLOB に対してのみ返されます。 アカウントが ObjectReplication対応の場合、このヘッダーの値はレプリケーションを管理するポリシーを表します。
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 以降。 階層型名前空間が有効になっているアカウントのみ。 パスのリソースの種類 ( file または directory) を返します。
x-ms-expiry-time バージョン 2020-02-10 以降。 階層型名前空間が有効になっているアカウントのみ。 BLOB に設定されている有効期限を返します。 有効期限が設定されているファイルに対してのみ返されます。

Response body

None.

Sample response

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>

Authorization

Azure Storage でデータ アクセス操作を呼び出す場合は、承認が必要です。 次の説明に従って、Get Blob Properties 操作を承認できます。

Important

Microsoft では、マネージド ID で Microsoft Entra ID を使用して、Azure Storage への要求を承認することをお勧めします。 Microsoft Entra ID は、共有キーの承認と比較して優れたセキュリティと使いやすさを提供します。

Azure Storage では、Microsoft Entra ID を使用して BLOB データへの要求を認可できます。 Microsoft Entra ID を使用すると、Azure ロールベースのアクセス制御 (Azure RBAC) を使用して、セキュリティ プリンシパルにアクセス許可を付与できます。 セキュリティ プリンシパルには、ユーザー、グループ、アプリケーション サービス プリンシパル、または Azure マネージド ID を指定できます。 セキュリティ プリンシパルは、Microsoft Entra ID によって認証されて OAuth 2.0 トークンを返します。 その後、そのトークンを、Blob service に対する要求を認可するために使用できます。

Microsoft Entra ID を使用した承認の詳細については、「Microsoft Entra IDを使用して BLOB へのアクセスを承認する」を参照してください。

Permissions

Microsoft Entra ユーザー、グループ、マネージド ID、またはサービス プリンシパルが Get Blob Properties 操作を呼び出すために必要な RBAC アクションと、このアクションを含む最小特権の組み込み Azure RBAC ロールを次に示します。

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

Remarks

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

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

Component Description
HTTP 状態コード 障害を指定する標準の 3 桁の整数。
Error code Azure によって <ErrorCode> 要素で提供されるエラーを記述するキーワード。 <ErrorCode> 要素が表示されない場合は、HTTP 仕様の 3 桁の HTTP ステータスコードに関連付けられた標準エラーテキストを含むキーワードが使用されます。 詳細については、一般的な REST API エラー コードを参照してください。
Information 障害の詳細な説明を引用符で囲みます。

一般的な障害シナリオの x-ms-copy-status 値と x-ms-copy-status-description 値を次の表に示します。

Important

次のエラーの説明は、バージョンを変更しなくても警告なしに変更される可能性があるため、テキストが正確に一致しない可能性があります。

Scenario x-ms-copy-status value x-ms-copy-status-description value
コピー操作が正常に完了しました。 success empty
コピー操作が完了する前に、ユーザーが中止しました。 aborted empty
コピー操作中にソース BLOB からの読み取り中にエラーが発生しましたが、操作は再試行されます。 pending 502 BadGateway "ソースの読み取り時に再試行可能なエラーが発生しました。 Will retry. 失敗時刻: <時間>"
コピー操作の宛先 BLOB への書き込み中にエラーが発生しましたが、操作は再試行されます。 pending 500 InternalServerError "再試行可能なエラーが発生しました。 Will retry. 失敗時刻: <時間>"
コピー操作のソース BLOB からの読み取り時に回復不能なエラーが発生しました。 failed 404 ResourceNotFound "ソースの読み取り中にコピーに失敗しました。"注: サービスは、この基礎となるエラーを報告すると、<ErrorCode> 要素に ResourceNotFound を返します。 応答に <ErrorCode> 要素が表示されない場合は、 NotFound などの HTTP ステータスの標準文字列表現が表示されます。
すべてのコピー操作を制限するタイムアウト期間が経過しました。 (現在、タイムアウト期間は2週間です。 failed 500 OperationCancelled "コピーが最大許容時間を超えました。"
コピー操作は、ソースからの読み取り時に頻繁に失敗し、試行と成功の最小比率を満たしていませんでした。 (このタイムアウトにより、失敗する前に 2 週間にわたって非常に貧弱なソースを再試行できなくなります)。 failed 500 OperationCancelled "ソースの読み取り時にコピーに失敗しました。"

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

Billing

価格要求は、Blob Storage API を使用するクライアントから、Blob Storage REST API を介して直接、または Azure Storage クライアント ライブラリから送信できます。 これらの要求には、トランザクションあたりの料金が発生します。 トランザクションの種類は、アカウントの課金方法に影響します。 たとえば、読み取りトランザクションは、書き込みトランザクションとは異なる課金カテゴリに発生します。 次の表に、ストレージ アカウントの種類に基づく Get Blob Properties 要求の課金カテゴリを示します。

Operation ストレージ アカウントの種類 Billing category
BLOB のプロパティを取得する Premium ブロック BLOB
Standard 汎用 v2		 Other operations
BLOB のプロパティを取得する Standard 汎用 v1 Read operations

指定された課金カテゴリの価格については、Azure Blob Storage の価格に関するページを参照してください。

See also

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