セールス: 1-800-867-1380

Get Page Ranges

更新日: 2014年1月

Get Page Ranges 操作は、ページ BLOB またはページ BLOB のスナップショットの有効なページ範囲の一覧を返します。

Get Page Ranges 要求の構成は次のとおりです。HTTPS が推奨されます。myaccount はストレージ アカウントの名前に置き換えます。

 

  GET メソッド要求の URI HTTP バージョン

https://myaccount.blob.core.windows.net/mycontainer/myblob?comp=pagelist

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

HTTP/1.1

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

 

  GET メソッド要求の URI HTTP バージョン

http://127.0.0.1:10000/devstoreaccount1/mycontainer/myblob?comp=pagelist

HTTP/1.1

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

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

 

Parameter 説明

snapshot

省略可能。snapshot パラメーターは、BLOB のスナップショットが存在する場合に、情報を取得するスナップショットを指定する非透過的な DateTime 値です。BLOB のスナップショットの操作の詳細については、「BLOB のスナップショットの作成」を参照してください。

timeout

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

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

 

要求ヘッダー 説明

Authorization

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

Date またはx-ms-date

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

x-ms-version

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

Range

省略可能。範囲を一覧表示するバイトの範囲を指定します。省略した場合は、BLOB のすべての範囲が返されます。

x-ms-range

省略可能。範囲を一覧表示するバイトの範囲を指定します。

Rangex-ms-range の両方が指定されている場合、サービスは x-ms-range の値を使用します。詳細については、「BLOB サービス操作の範囲ヘッダーの指定」を参照してください。

x-ms-lease-id:<ID>

省略可能。このヘッダーを指定すると、次の 2 つの条件を満たした場合にのみ操作が実行されます。

  • BLOB のリースが現在アクティブになっている。

  • 要求に指定されたリース ID が BLOB のリース ID と一致している。

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

x-ms-client-request-id

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

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

なし。

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

操作が正常に終了すると、ステータス コード 200 (OK) が返されます。

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

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

 

構文 説明

Last-Modified

BLOB が最後に更新された日時。日付形式は RFC 1123 に従います。

BLOB を変更する操作 (BLOB のメタデータまたはプロパティの更新など) を行うと、BLOB の最終更新時刻が変更されます。

ETag

ETag に含まれる値は、クライアントが条件に基づく操作を実行するときに使用できます。要求バージョンが 2011-08-18 またはそれ以降である場合、ETag 値は引用符で囲まれます。

x-ms-blob-content-length

BLOB のサイズ (バイト単位)。

x-ms-request-id

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

x-ms-version

要求の実行に使用する BLOB サービスのバージョンを示します。このヘッダーはバージョン 2009-09-19 以降で行った要求に対して返されます。

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

Date

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

応答本文には、アドレス ページ範囲の昇順に並べ替えられた、重複しない有効なページ範囲の一覧が含まれます。応答本文の形式は次のとおりです。

<?xml version="1.0" encoding="utf-8"?>
<PageList>
   <PageRange>
      <Start>Start Byte</Start>
      <End>End Byte</End>
   </PageRange>
   <PageRange>
      <Start>Start Byte</Start>
      <End>End Byte</End>
   </PageRange>
</PageList>

BLOB のページ セット全体が消去された場合は、応答本文にページ範囲が含まれません。

この操作は、アカウント所有者、または、BLOB に対する読み取りアクセス許可がある共有アクセス署名を使用する任意のユーザーが実行できます。コンテナーの ACL が匿名アクセスを許可するように設定されている場合は、すべてのクライアントがこの操作を呼び出すことができます。

各ページ範囲の開始と終了のバイト オフセットには、その開始値と終了値が含まれます。

多数の書き込みによって断片化が進んでいるページ BLOB では、内部サーバーのタイムアウトによって Get Page Ranges 要求が失敗する場合があります。多数の書き込み操作が実行されたページ BLOB の範囲を取得するアプリケーションでは、ページ範囲のサブセットを一度に取得する必要があります。詳細については、「サイズの大きいページ BLOB のページ範囲のセグメントでの取得 (英語)」を参照してください。

この情報は役に立ちましたか。
(残り 1500 文字)
フィードバックをいただき、ありがとうございました
表示:
© 2014 Microsoft