获取BEC虚机实例监控
更新时间：2023-08-09
接口描述
本接口用于获取BEC虚机实例监控。
请求结构
GET /v1/monitor/vm/{vmId}?vmId={vmId}&start={start}&end={end}&serviceProvider={serviceProvider}&metricsType={metricsType} HTTP/1.1
Host: bec.baidubce.com
Authorization: authorization string请求头域
除公共头域外，无其它特殊头域。
请求参数
| 参数名称 | 类型 | 是否必需 | 参数位置 | 描述 |
|---|---|---|---|---|
| vmId | String | 是 | QueryString参数 | 虚机实例ID |
| metricsType | String | 是 | RequestParam参数 | 监控参数。取值为：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/vm/vm-r1d5ta5t-3-u-guangzhou-huyuv?vmId=vm-r1d5ta5t-3-u-guangzhou-huyuv&start=1619107200&end=1619193600&serviceProvider=&metricsType=BANDWIDTH_TRANSMIT HTTP/1.1
Host: bec.baidubce.com
Authorization: bce-auth-v1/f81d3b34e48048fbb2634dc7882d7e21/2015-08-11T04:17:29Z/3600/host/74c506f68c65e26c633bfa104c863fffac5190fdec1ec24b7c03eb5d67d2e1de响应示例
HTTP/1.1 200 OK
Content-Type: application/json;charset=UTF-8
Date: Wed, 08 Jul 2015 03:28:11 GMT
x-bce-request-id: d8752367-38e8-45e4-b4c7-e53be3137ce5
Server: BWS
{
"avgValue":0.011866,
"maxValue":0.08076923076923076,
"metrics":[
{
"timeInSecond":1592901412,
"value":0.003846153846153846
},
{
"timeInSecond":1592901712,
"value":0
},
{
"timeInSecond":1592902012,
"value":0.003846153846153846
},
{
"timeInSecond":1592902312,
"value":0
}]
}Model对象定义
Metric
| 参数名称 | 类型 | 描述 |
|---|---|---|
| timeInSecond | Integer | Unix时间戳，单位秒 |
| value | BigDecimal | 监控值 |
ServiceProvider
| 枚举名称 | 描述 |
|---|---|
| CHINA_UNICOM | 联通 |
| CHINA_MOBILE | 移动 |
| CHINA_TELECOM | 电信 |
| BGP | 海外节点运营商BGP |
| INTRA | 内网 |