获取空间存储量(bucket stat)
更新时间：2024-03-21 17:27:47
该接口提供在云存储平台查询指定时间段空间的存储量信息，主要包括每天的存储量峰值信息。（该接口获取的数值仅供参考，具体计费值以网宿计费平台提供的数据为准。）
请求说明
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>" // 指定isListDetails才返回的有序数组，代表当天0-23点各个整点的存储量明细
}
]
},
……
]
}
| 字段名 | 必填 | 描述 |
|---|---|---|
| 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"
本篇文档内容对您是否有帮助？
有帮助
我要反馈