获取空间存储量(bucket stat)

文档中心

获取空间存储量(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天
isListDetails	否	值为true或false，标识是否返回存储量明细，默认为false-不返回
storageType	否	可选值为：Standard、InfrequentAccess、Archive分别代表标准、低频和归档的存储量，不填时会返回总存储量。

响应说明

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

{
    "code":  "200",
    "message": "OK",
    "buckets":[
    {
        "name":"<bucket_name>"，
        "detail":[
        {
            "data_time":"<Datatime string>",  // yyyy-MM-dd
            "storage":"<storage>",
            "details":"<details>"             // detail为有序数组格式，代表当天0-23点各个整点的存储量明细
        }
        ]

    },
     ……
    ]
}

字段名	描述
buckets	查询的空间信息
name	空间名
detail	空间详情
data_time	统计的时间，格式为yyyy-MM-dd
storage	存储使用量峰值，单位：MB，保留3位小数
details	代表当天0-23点各个整点的存储量明细的有序数组，此字段仅在指定isListDetails为true时才会返回。

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