Acme Cloud

桶列表

GET/v2/storage/buckets

列出当前组织下的对象存储桶及其用量。

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

请求参数

共 4 项
page 可选 查询

integer · 默认 1

页码，从 1 开始

page_size 可选 查询

integer · 默认 20

每页条数，1–100

sort 可选 查询

string

排序字段，前缀 - 表示降序

region 可选 查询

string

按地域筛选

响应

2 种状态

200 OK

响应示例
{
  "total": 3,
  "items": [
    {
      "name": "acme-assets",
      "region": "ap-east-1",
      "object_count": 18422,
      "size_gb": 128.4,
      "acl": "private",
      "created_at": "2025-12-01T06:00:00Z"
    },
    {
      "name": "acme-public-cdn",
      "region": "ap-east-1",
      "object_count": 903,
      "size_gb": 12.9,
      "acl": "public-read",
      "created_at": "2026-02-18T09:30:00Z"
    }
  ]
}

代码示例

cURL
curl -i -X GET 'https://api.demo.acme-cloud.dev/v2/storage/buckets?page=1&page_size=20&sort=-created_at' \
  -H 'Accept: application/json'