NetBackup™ 重複排除ガイド

ListObjectsV2

バケット内のすべてのオブジェクトのリストを返します。要求パラメータを選択条件として使用して、バケット内のオブジェクトのサブセットを返すことができます。バケットでバージョン管理が有効になっている場合、API は最新バージョンのオブジェクトを返します。200 OK の応答に有効または無効な XML を含められます。応答の内容を解析し、適切に処理するようにアプリケーションが設計されていることを確認します。

要求の構文

GGET /bucket?list-type=2&continuation-token=Continuation
Token&delimiter=Delimiter&max-keys=MaxKeys&prefix=Prefix HTTP/1.1 
Host: msdps3.server:8443

要求パラメータ

応答の構文

HTTP/1.1 200 
<?xml version="1.0" encoding="UTF-8"?>
<ListBucketResult>
    <IsTruncated>boolean</IsTruncated>
    <Contents>
        <ETag>string</ETag>
        <Key>string</Key>
        <LastModified>timestamp</LastModified>
        <Size>integer</Size>
        <StorageClass>string</StorageClass>
    </Contents>
    ...
    <Name>string</Name>
    <Prefix>string</Prefix>
    <Delimiter>string</Delimiter>
    <MaxKeys>integer</MaxKeys>
    <CommonPrefixes>
        <Prefix>string</Prefix>
    </CommonPrefixes>
    ...
    <KeyCount>integer</KeyCount>
    <ContinuationToken>string</ContinuationToken>
    <NextContinuationToken>string</NextContinuationToken>
</ListBucketResult>

応答の本文

バージョン管理対象バケットの場合、List Object Versions API を使用して、すべてのオブジェクトに関する情報を取得することをお勧めします。バージョン管理対象バケットで「list objects」を使用する場合、結果が切り捨てられると、結果のキー数が最大キー数未満になる可能性があり、改ページ要求で残りのキーを確認できます。

スラッシュ (/) 区切り文字で区切って指定した接頭辞以下の CommonPrefixes 要素は 1,000 個未満にすることをお勧めします。指定した接頭辞以下に 10,000 個を超える CommonPrefixes 要素が存在する場合、要求で接頭辞と区切り文字パラメータを使用した list objects により 10,000 個の要素のみが返されます。指定した接頭辞以下のすべての要素を一覧表示する場合は、区切り文字なしで list objects を使用します。

バージョン管理対象バケットで list objects API を使用する場合、指定した接頭辞以下のすべてのオブジェクトが削除マーカーであると、指定した接頭辞が CommonPrefixes 要素として表示されます。

考えられるエラー応答