该接口用于获取用户在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"