Acme Cloud

对象列表

GET/v2/storage/buckets/{bucket}/objects

列出桶内对象，支持前缀与游标分页。

对象列表数据量可能极大，必须使用 cursor 游标翻页，不支持页码偏移。

Bearer Token storage:read api.demo.acme-cloud.dev

请求参数

共 5 项
bucket 必填 路径

string

桶名称

响应

3 种状态

200 OK

响应示例
{
  "objects": [
    {
      "key": "uploads/2026/logo.svg",
      "size": 12844,
      "etag": "\"a3f9c1\"",
      "last_modified": "2026-09-11T04:22:00Z",
      "storage_class": "standard"
    },
    {
      "key": "uploads/2026/report.pdf",
      "size": 2401288,
      "etag": "\"7b21de\"",
      "last_modified": "2026-09-30T11:04:00Z",
      "storage_class": "standard"
    }
  ],
  "prefixes": [],
  "next_cursor": "eyJrZXkiOiJ1cGxvYWRzLzIwMjYvcmVwb3J0LnBkZiJ9"
}

代码示例

cURL
curl -i -X GET 'https://api.demo.acme-cloud.dev/v2/storage/buckets/acme-assets/objects?prefix=uploads%2F2026%2F&delimiter=%2F&limit=100' \
  -H 'Accept: application/json'