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 元素少于 1000 个。如果指定前缀下存在的 CommonPrefixes 元素多于 10000 个，则请求中带有前缀和分隔符参数的列出对象仅返回 10000 个元素。如果要列出指定前缀下的所有元素，则可以使用不带分隔符的列出对象。

在实施版本控制的存储桶上使用 list objects API 时，如果指定前缀下的所有对象都是删除标记，则指定的前缀将显示为 CommonPrefixes 元素。

可能的错误响应