列举空间(list bucket)

描述

该接口提供获取云存储平台空间列表的功能。

请求说明

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

头部说明

参数 必填 描述
Host 管理域名,可在用户管理界面获取
Authorization 管理凭证

响应说明

如果请求成功,则返回如下内容的Json串:

{
    "code":"200",
    "message":"OK",
    "buckets":[
    {
        "name":"<bucketName>",
        "location":"<locationName>",
        "createTime":"<createTime>",
    },
    ……
    ]
}
字段名 描述
buckets 所有空间信息
name 空间名
location 数据中心编码
createTime 空间创建时间,yyyy-mm-dd h:i:s格式

如果请求失败,则返回如下内容的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"