この記事は機械翻訳されています。英語版の記事を表示するには、[英語] のチェック ボックスをオンにしてください。また、テキストにマウス ポインターを合わせると、ポップアップ ウィンドウに英語のテキストを表示することもできます。
翻訳
英語

Get Block List (REST API)

 

Get Block List 操作をブロック blob の一部としてアップロードされたブロックの一覧を取得します。

BLOB に対して保持されるブロック一覧は 2 つあります。

  • コミット後のブロック一覧: 特定の blob が正常にコミットされたブロックの一覧 ブロック一覧を配置します。です。

  • コミット前のブロック一覧: 使用して blob のアップロードされたブロックの一覧 Put Block, が、まだコミットされていません。 これらのブロックは、BLOB との関連で Azure に格納されますが、まだ BLOB の一部にはなっていません。

呼び出すことができます Get Block List をコミット後のブロック一覧、コミット前のブロック一覧、または両方の一覧を返します。 この操作を呼び出して、スナップショットのコミット後のブロック一覧を取得することもできます。

Get Block List 要求は次のように作成されます。 HTTPS が推奨されます。 置き換える myaccount をストレージ アカウントの名前。

GET メソッド要求の URI

HTTP バージョン

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

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

HTTP/1.1

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

GET メソッド要求の URI

HTTP バージョン

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

HTTP/1.1

詳細については、XmlLite の概要を参照してください。

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

URI パラメーター

description

snapshot

省略可能です。 Snapshot パラメーターする非透過的なは DateTime 存在する場合は、取得する blob の一覧を指定する値。 Blob のスナップショットの操作の詳細については、次を参照してください。 Blob のスナップショットを作成します。です。

blocklisttype

コミット後のブロックの一覧、コミット前のブロック一覧、または両方の一覧のいずれを返すかを指定します。 有効な値は committed, 、uncommitted, 、または allです。 このパラメーターを省略した場合 Get Block List コミット後のブロックの一覧を返します。

timeout

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

次の表は、必須の要求ヘッダーおよび省略可能な要求ヘッダーを示します。

要求ヘッダー

description

Authorization

必須。

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

Date または x-ms-date

必須。

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

x-ms-version

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

x-ms-lease-id:<ID>

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

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

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

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

x-ms-client-request-id

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

ありません。

次の要求 URI の例は、MOV1.avi という名前のコミット後のブロック一覧を返します。

GET http://myaccount.blob.core.windows.net/movies/MOV1.avi?comp=blocklist&blocklisttype=committed HTTP/1.1

次の要求 URI の例は、コミット後のブロック一覧とコミット前のブロック一覧の両方を返します。

GET http://myaccount.blob.core.windows.net/movies/MOV1.avi?comp=blocklist&blocklisttype=all HTTP/1.1

次の要求 URI の例は、スナップショットのコミット後のブロック一覧を返します。 スナップショットはコミット後のブロックのみから構成されるため、コミット前のブロックは関連付けられていません。

GET http://myaccount.blob.core.windows.net/mycontainer/myblob?comp=blocklist&snapshot=2009-09-30T20%3a11%3a15.2735974Z

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

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

状態コードについては、次を参照してください。 ステータス コードとエラー コードです。

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

応答ヘッダー

description

Last-Modified

BLOB が最後に更新された日時。 日付形式は RFC 1123 に従います。 参照してください ヘッダーにおける日付/時刻値の表現 の詳細。 このヘッダーは、BLOB にコミット後のブロックがある場合にのみ返されます。

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

ETag

BLOB の ETag。 このヘッダーは、BLOB にコミット後のブロックがある場合にのみ返されます。

Content-Type

BLOB の MIME コンテンツの種類。 既定値は application/xmlです。

x-ms-blob-content-length

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

x-ms-request-id

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

x-ms-version

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

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

Date

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

この操作では、条件ヘッダーを使用して、指定した条件を満たした場合にのみブロック一覧を取得することもできます。 詳細については、次を参照してください。 Blob サービス操作の条件ヘッダーの指定です。

コミット後のブロックのみ返す要求の応答本文の形式は次のとおりです。

<?xml version="1.0" encoding="utf-8"?> <BlockList> <CommittedBlocks> <Block> <Name>base64-encoded-block-id</Name> <Size>size-in-bytes</Size> </Block> <CommittedBlocks> </BlockList>

コミット後のブロックとコミット前のブロックの両方を返す要求の応答本文の形式は次のとおりです。


<?xml version="1.0" encoding="utf-8"?> <BlockList> <CommittedBlocks> <Block> <Name>base64-encoded-block-id</Name> <Size>size-in-bytes</Size> </Block> </CommittedBlocks> <UncommittedBlocks> <Block> <Name>base64-encoded-block-id</Name> <Size>size-in-bytes</Size> </Block> </UncommittedBlocks> </BlockList>

次の例で、 blocklisttype にパラメーターが設定されている committed, blob のコミット後のブロックが応答で返されるだけです。

HTTP/1.1 200 OK Transfer-Encoding: chunked Content-Type: application/xml Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0 x-ms-request-id: 42da571d-34f4-4d3e-b53e-59a66cb36f23 Date: Sun, 25 Sep 2011 00:33:19 GMT <?xml version="1.0" encoding="utf-8"?> <BlockList> <CommittedBlocks> <Block> <Name>BlockId001</Name> <Size>4194304</Size> </Block> <Block> <Name>BlockId002</Name> <Size>4194304</Size> </Block> </CommittedBlocks> </BlockList>

この例で、 blocklisttype にパラメーターが設定されている all, 、両方、blob のコミット済みおよびコミット前のブロックが応答で返されます。

HTTP/1.1 200 OK Transfer-Encoding: chunked Content-Type: application/xml Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0 x-ms-request-id: 42da571d-34f4-4d3e-b53e-59a66cb36f23 Date: Sun, 25 Sep 2011 00:35:56 GMT <?xml version="1.0" encoding="utf-8"?> <BlockList> <CommittedBlocks> <Block> <Name>BlockId001</Name> <Size>4194304</Size> </Block> <Block> <Name>BlockId002</Name> <Size>4194304</Size> </Block> </CommittedBlocks> <UncommittedBlocks> <Block> <Name>BlockId003</Name> <Size>4194304</Size> </Block> <Block> <Name>BlockId004</Name> <Size>1024000</Size> </Block> </UncommittedBlocks> </BlockList>

この次の例では、 blocklisttype にパラメーターが設定されている all, 、blob がまだコミットされていないがため、 CommittedBlocks 要素が空です。

HTTP/1.1 200 OK Transfer-Encoding: chunked Content-Type: application/xml Server: Windows-Azure-Blob/1.0 Microsoft-HTTPAPI/2.0 x-ms-request-id: 42da571d-34f4-4d3e-b53e-59a66cb36f23 Date: Wed, 14 Sep 2011 00:40:22 GMT <?xml version="1.0" encoding="utf-8"?> <BlockList> <CommittedBlocks /> <UncommittedBlocks> <Block> <Name>BlockId001</Name> <Size>1024</Size> </Block> <Block> <Name>BlockId002</Name> <Size>1024</Size> </Block> <Block> <Name>BlockId003</Name> <Size>1024</Size> </Block> <Block> <Name>BlockId004</Name> <Size>1024</Size> </Block> </UncommittedBlocks> </BlockList>

コンテナーの ACL が匿名アクセスを許可する設定されている場合、任意のクライアントが呼び出すことが Get Block List。 ただし、コミット後のブロックをパブリックにアクセスすることができます。 コミットされていないブロックの一覧へのアクセスは、アカウント所有者と、この BLOB またはそのコンテナーを読み取るためのアクセス許可がある共有アクセス署名を使用するユーザーに制限されます。

call 使用して、 blocklisttype パラメーターを返すブロック一覧を指定します。

コミットされた順序と同じ順序でコミット後のブロックの一覧が返される、 ブロック一覧を配置します。 操作します。 コミット後のブロック一覧にブロックは複数回出現できません。

コミット前のブロック一覧を使用するにはブロックが blob の場合に不足しているかを判断をするために呼び出す Put Block または Put Block List に失敗したします。 コミット前のブロック一覧は、最後にアップロードされたブロックから最初にアップロードされたブロックの順に返されます。 ブロック ID が複数回アップロードされた場合は、最後にアップロードされたブロックのみ一覧に出現します。

Blob がまだコミットされていない、呼び出すときに注意してください Get Block Listblocklisttype=all コミット前のブロックを返すと CommittedBlocks 要素が空です。

Get Block List ブロック blob にのみ適用されます。 呼び出す Get Block List コード 400 (Bad Request) の状態で、ページ blob の結果にします。

表示: