获取虚机资源概览监控信息
更新时间：2023-08-09
接口描述
本接口用于获取用户虚机资源对于指定监控指标的使用量趋势。
请求结构
GET /v1/monitor/overview/vm/{metricsType}?start={start}&end={end}&serviceProvider={serviceProvider} HTTP/1.1
Host: bec.baidubce.com
Content-Type: application/json; charset=utf-8
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
|---|---|---|---|---|
| metricsType | String | 是 | URL参数 | 监控类型，取值为CPU、MEMORY、BANDWIDTH_RECEIVE、BANDWIDTH_TRANSMIT分别表示CPU、内存、入网带宽、出网带宽 |
| start | Long | 是 | RequestParam参数 | 起始时间，Unix时间戳，单位秒 |
| end | Long | 是 | RequestParam参数 | 终止时间，Unix时间戳，单位秒 |
| serviceProvider | String | 否 | RequestParam参数 | 指定运营商ServiceProvider，默认不填为全部（外网） |
| stepInMin | Integer | 否 | RequestParam参数 | 数据点间隔（单位：分钟） |
响应头域
除公共头域外，无其它特殊头域。
响应参数
| 参数名称 | 类型 | 描述 |
|---|---|---|
| metrics | List<Metric> | 监控类型 |
| maxValue | BigDecimal | 最大值 |
| avgValue | BigDecimal | 平均值 |
错误码
请参照错误返回章节的内容。
请求示例
GET /v1/monitor/overview/vm/BANDWIDTH_RECEIVE?start=1619107200&end=1619193600&serviceProvider= HTTP/1.1
Host: bec.baidubce.com
Content-Type: application/json; charset=utf-8
Authorization: bce-auth-v1/318857a8f08b11e9845ca7e54775a0c2/2019-10-17T03:07:21Z/1800/host/212eef8cfe1ac94be56c4afedb9360bba621ef646c3c8288971d36801d70501a响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2019 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
X-Bce-Gateway-Region: BJ
{
"metrics": [
{
"timeInSecond": 1574747549,
"value": 0.11196252446670865
},
{
"timeInSecond": 1574747849,
"value": 0.1289803609999666
},
{
"timeInSecond": 1574748149,
"value": 0.12496248716668248
},
{
"timeInSecond": 1574748449,
"value": 0.124981639666602
}
],
"maxValue": 0.1289803609999666,
"avgValue": 0.122722
}Model对象定义
Metric
| 参数名称 | 类型 | 描述 |
|---|---|---|
| timeInSecond | Integer | Unix时间戳，单位秒 |
| value | BigDecimal | 监控值 |
ServiceProvider
| 枚举名称 | 描述 |
|---|---|
| CHINA_UNICOM | 联通 |
| CHINA_MOBILE | 移动 |
| CHINA_TELECOM | 电信 |
| BGP | 海外节点运营商BGP |
| INTRA | 内网 |