接口描述

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

请求（Request）

• 请求语法

  Plain Text 复制

  1```
  2GET /?objectsets HTTP/1.1
  3Host: <BcuketName>.bj.bcebos.com
  4x-bce-date: date
  5Authorization: AuthorizationString
  6```

• 请求头域

  无特殊参数

• 请求参数

  名称	类型	描述	是否必须
  prefix​	String	列举指定前缀的 ObjectSet。​	否
  max-keys​​	String	设置返回 ObjectSet 的最大数量。​默认值为 1000，最大值为 1000；当取值小于等于 0 或大于 1000 时，将按 1000 处理。	否
  marker​	String	设置 marker，使得本次返回的 ObjectSet 从上一次请求返回的 ObjectSet 后继续进行列举，而不是从头开始列举。​	否

响应（Response）

• 响应头域

  无特殊头域

• 响应元素

  名称	类型	描述
  isTruncated​	Bool	返回的结果是否被截断，取值，​false：已返回全部结果；​true：还有结果未返回。​
  nextMarker	String	当 isTruncated 为 true 时，返回 nextMarker 。下一次列举请求可以使用 nextMarker 填充marker 继续列举。​
  objectSets	Array	列举的 ObjectSet 信息。​
  +objectSetName	String	查询 ObjectSet 的 Prefix 前缀。​

示例

• 请求示例1

  列举a/b前缀下的ObjectSet列表，单次至多返回100个

  Plain Text 复制

  1```
  2 GET /?objectsets&prefix=a/b/&max-keys=100 HTTP/1.1
  3 Host: <BcuketName>.bj.bcebos.com
  4 x-bce-date: Wed, 31 May 2026 09:34:40 GMT
  5 Authorization: AuthorizationString
  6```
  7 

• 响应示例1

  Plain Text 复制

  1 HTTP/1.1 200 OK
  2 x-bce-request-id: 2eb2b34d-654d-fd8a-xxxx-3049ca786409
  3 Date: Wed, 31 May 2026 09:34:40 GMT
  4 Content-Type: application/json; charset=utf-8
  5 Content-Length: 31
  6 Connection: keep-alive
  7 Server: BceBos
  8
  9 {
  10   "objectSets": [​
  11     {​
  12       "objectSetName": "a/b/c/"
  13     }​,
  14     {​
  15       "objectSetName": "a/b/d/"
  16     }​
  17   ],​
  18   "isTruncated": false,​
  19   "nextMarker": ""
  20 }

• 请求示例2

  列举a/b前缀下的ObjectSet列表，从a/b/c之后开始。

  Plain Text 复制

  1```
  2 GET /?objectsets&prefix=a/b/&marker=a/b/c HTTP/1.1
  3 Host: <BcuketName>.bj.bcebos.com
  4 x-bce-date: Wed, 31 May 2026 09:34:40 GMT
  5 Authorization: AuthorizationString
  6```
  7 

• 响应示例2

  Plain Text 复制

  1 HTTP/1.1 200 OK
  2 x-bce-request-id: 2eb2b34d-654d-fd8a-xxxx-3049ca786409
  3 Date: Wed, 31 May 2026 09:34:40 GMT
  4 Content-Type: application/json; charset=utf-8
  5 Content-Length: 31
  6 Connection: keep-alive
  7 Server: BceBos
  8
  9 {
  10   "objectSets": [​
  11     {​
  12       "objectSetName": "a/b/d/"
  13     }​
  14   ],​
  15   "isTruncated": false,​
  16   "nextMarker": ""
  17 }