文档中心

对象存储

基础操作

ListObjectSet

ListObjectSet

功能描述

此接口用于列举 Bucket 下的 ObjectSet，支持按前缀、标签和 marker 分页过滤。

注意事项

通过子账号使用时，需要授予当前桶的 ListObjectSet 权限。

请求消息样式

请求参数和消息头

该请求使用的公共请求消息头，请参见公共参数。

请求元素

名称	位置	参数类型	是否必选	示例值	说明
prefix	Query	String	否	"a/b/"	列举指定前缀的 ObjectSet。
tags	Query	String	否	"key1=value1&key2=value2"	列举指定 tag 的 ObjectSet，支持多个 tag，以key=value 标记一组 tag，多组 tag 之间用&连接。
max-keys	Query	Interger	否	100	设置返回 ObjectSet 的最大数量。默认值为 1000，最大值为 1000；当取值小于等于 0 或大于 1000 时，将按 1000 处理。
marker	Query	String	否	"marker"	设置 marker，使得本次返回的 ObjectSet 从上一次请求返回的 ObjectSet 后继续进行列举，而不是从头开始列举。

响应消息头

该请求返回的公共响应消息头，请参见公共参数。

响应元素

名称	参数类型	示例值	说明
IsTruncated	Bool	true	返回的结果是否被截断，取值如下： false：已返回全部结果。 true：还有结果未返回。
NextMarker	String	"NextMarker"	当 IsTruncated 为 true 时，返回 NextMarker ，表明还可以列举出更多数据。下一次列举请求可以使用 NextMarker 继续列举。
ObjectSets	Array	-	列举的 ObjectSet 信息。
ObjectSetName	String	"a/b/c/"	查询 ObjectSet 的 Prefix 前缀。父节点：ObjectSets。
TagSet	Container	-	标签信息集合。父节点为ObjectSets。
Tags	Container	-	标签信息。
Key	String	aa	标签的键。
Value	String	bb	标签的值。

请求示例

响应示例

最近更新时间：2026.05.21 16:23:30

这个页面对您有帮助吗？

有用

有用

无用

无用