获取空间存储量(bucket stat)

描述

该接口提供在云存储平台查询指定时间段空间的存储量信息,主要包括每天的存储量峰值信息。(该接口获取的数值仅供参考,具体计费值以网宿计费平台提供的数据为准)

请求说明

  GET /bucket/stat?name=<Urlsafe_Base64_Encoded_Names>&startdate=<startdate>&enddate=<enddate>
  Host:<MgrDomain>
  Authorization:<AccessToken>

头部说明

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

参数说明

参数 必填 描述
name 指定查询的空间列表,格式为:Urlsafe_Base64_Encode(<bucket_name1>|<bucket_name2>|……)
startdate 统计开始时间,格式为yyyy-mm-dd
enddate 统计结束时间,格式为yyyy-mm-dd
注:查询的时间跨度最长为30天

响应说明

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

{
    "code":  "200",
    "message": "OK",
    "buckets":[
    {
        "name":"<bucket_name>",
        "detail":[
        {
            "data_time":"<Datatime string>",// yyyy-MM-dd
            "storage":"<storage>"
        }
        ]

    },
     ……
    ]
}
字段名 必填 描述
buckets 查询的空间信息
name 空间名
detail 空间详情
data_time 统计的时间,格式为yyyy-MM-dd
storage 存储使用量峰值,单位:MB,保留3位小数

如果请求失败,则返回如下内容的Json字符串:

{
    "code":     "<code string>",
    "message":  "<message string>"
}
字段名 必填 描述
code HTTP请求响应码,参见HTTP响应状态码<返回码>
message 查询空间失败的提示信息

范例

 curl -v -o bucketlist.json -H "Authorization:86622e227a50d49d858c2494a935bc2e4ac543a7:NTVjZWZmOThhYjUzMjhkMWQ3YzE3OGM0NTRhYzFmODc5MDQ0MWExNQ==" --url "http://mgrDomain/bucket/stat?name=YnVja2V0MXxidWNrZXQyfGJ1Y2tldDM=&startdate=2017-01-01&enddate=2017-02-01"