列举空间

更新时间:2025-08-18 15:32:01

该接口用于获取用户在CDNetworks平台的所有存储空间(Bucket)列表,适用于空间资源管理和访问控制等场景。

请求描述

请求格式

GET /bucket/list
Host:<MgrDomain>
Authorization: <AccessToken>

Header 描述

参数 是否必需 描述
Host 管理域名,可在控制台空间概览界面获取
Authorization 管理凭证

响应描述

  • 如果请求成功,将返回包含以下内容的JSON字符串:
  {
       "code":"200",
        "message":"OK",
        "buckets":[
        {
            "name":"<bucket_name>"
        },
        ……
        ]
    }
字段名称 是否必需 描述
buckets 所有存储空间信息。
name 存储空间名称。
  • 如果请求失败,将返回包含以下内容的JSON字符串:
{
    "code":     "<code string>",
    "message":  "<message string>"
}
字段名称 是否必需 描述
code HTTP请求响应代码。请参考 HTTP响应状态代码
message 列出存储空间失败时的提示信息。

示例

curl -v -o bucketlist.json -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:NTVjZWZmOThhYjUzMjhkMWQ3YzE3OGM0NTRhYzFmODc5MDQ0MWExNQ==" --url "http://mgrDomain/bucket/list"
本篇文档内容对您是否有帮助?
有帮助
我要反馈
提交成功!非常感谢您的反馈,我们会继续努力做到更好!