NetBackup™ 重複排除ガイド

ListObjects

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

要求の構文

GET /bucket?delimiter=Delimiter&marker=Marker&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>
    <Marker>string</Marker>
    <NextMarker>string</NextMarker>
    <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>
    ...
</ListBucketResult>

応答の本文

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

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

考えられるエラー応答