列举空间(list bucket)

文档中心

列举空间(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"