查询用户算力用量
更新时间：2021-08-03
接口描述
本接口用于查询用户的算力用量数据。
请求结构
GET /v1/usage/computing HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| beginDate | String | 是 | Query参数 | 查询开始日期，格式'2020-10-15' |
| endDate | String | 是 | Query参数 | 查询结束日期，格式'2020-10-15'，最长时间跨度31天 |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| accountId | String | 账户ID |
| timeSpan | Map<String,String> | 查询时间，包含beginDate和endDate |
| graphData | Map<String, GraphData> | 算力用量数据 |
| summary | Map<String, Map<String, BigDecimal>> | 按日期汇总的算力用量数据，为每日平均值 |
错误码
请参照错误返回章节的内容。
请求示例
GET /v1/usage/computing HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2021-06-08T03:28:09Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de
{
"beginDate": "2020-11-03",
"endDate": "2020-11-25"
}响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2021 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"accountId": "accountId",
"timeSpan": {
"beginDate": "2020-11-03",
"endDate": "2020-11-25"
},
"graphData": {
"CPU": {
"count": 30,
"unit":"核",
"dataList": [{
"amount": 30.223,
"timestamp": 1602845549040
},
{
"amount": 40.213,
"timestamp": 1602845549040
},
{
"amount": 50.223,
"timestamp": 1602845549040
}
]
},
"EIP": {
"count": 30,
"unit":"个",
"dataList": [{
"amount": 30.223,
"timestamp": 1602845549040
},
{
"amount": 40.213,
"timestamp": 1602845549040
},
{
"amount": 50.223,
"timestamp": 1602845549040
}
]
},
"BOS_Standard": {
"count": 30,
"unit":"GB",
"dataList": [{
"amount": 30.223343133,
"timestamp": 1602845549040
},
{
"amount": 40.223343133,
"timestamp": 1602845549040
},
{
"amount": 50.223343133,
"timestamp": 1602845549040
}
]
},
…………
"Memory": {
"count": 30,
"unit":"GB",
"dataList": [{
"amount": 60.234,
"timestamp": 1602845549040
}]
}
},
"summary": {
"2020-11-03": {
"CPU": 17.223,
"EIP": 34.423,
"BOS_Standard":34.342356432,
…………
"Memory": 334.342
},
"2020-11-04": {
"CPU": 17.223,
"EIP": 34.423,
"BOS_Standard":34.342356432,
…………
"Memory": 334.342
},
…………
"2020-11-25": {
"CPU": 17.223,
"EIP": 34.423,
"BOS_Standard":34.342356432,
…………
"Memory": 334.342
}
}
}Model对象定义
GraphData
| 参数名称 | 类型 | 描述 |
|---|---|---|
| count | Integer | 数据点数量 |
| unit | String | 算力数据单位 |
| dataList | List<DataUnit> | 算力数据 |
DataUnit
| 参数名称 | 类型 | 描述 |
|---|---|---|
| amount | BigDecimal | 算力数值 |
| timestamp | Long | 数据时间点 |