获取空间存储量
更新时间：2025-08-18 15:32:03
此接口允许您查询指定时间范围内对象存储上的存储空间使用信息，主要包括每日峰值存储使用信息。（通过此接口获得的值仅供参考，具体计费值将以CDNetworks SAP提供的数据为准。）
请求描述
请求格式
GET /bucket/stat?name=<Urlsafe_Base64_Encoded_Names>&startdate=< startdate >&enddate=< enddate>
Host:< MgrDomain>
Authorization:< AccessToken>
Header 描述
| 参数 | 是否必需 | 描述 |
|---|---|---|
| Host | 是 | 管理域名，可在控制台的空间概览界面获取 |
| Authorization | 是 | 管理凭证 |
参数描述
| 参数 | 是否必需 | 描述 |
|---|---|---|
| name | 是 | 指定查询的存储空间列表，格式如下：Urlsafe_Base64_Encode(<bucket_name1>|<bucket_name2>|……)</bucket_name2></bucket_name1> |
| startdate | 是 | 统计的开始时间，格式为yyyy-mm-dd。 |
| enddate | 是 | 统计的结束时间，格式为yyyy-mm-dd。 注意：查询的最大时间跨度为六个月。 |
| 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>"
}
]
},
……
]
}
| 字段名称 | 是否必需 | 描述 |
|---|---|---|
| buckets | 是 | 查询的存储空间信息。 |
| name | 是 | 存储空间名称。 |
| detail | 是 | 存储空间详情。 |
| data_time | 是 | 统计时间，格式为yyyy-MM-dd。 |
| storage | 是 | 存储使用的峰值，单位：MB，保留三位小数。 |
- 如果请求失败，将返回包含以下内容的JSON字符串：
{
"code": "< code string>",
"message": "< message string>"
}
| 字段名称 | 是否必需 | 描述 |
|---|---|---|
| code | 是 | 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"
本篇文档内容对您是否有帮助？
有帮助
我要反馈