获取虚机资源节点级概览监控信息
更新时间:2023-08-09
接口描述
本接口用于获取用户节点级别虚机资源对于指定监控指标的使用量趋势。
请求结构
GET /v1/monitor/overview/vm/node/{metricsType}?start={start}&end={end}®ion={region}&city={city}&serviceProvider={serviceProvider}&network={network} HTTP/1.1
Host: bec.baidubce.com
Content-Type: application/json; charset=utf-8
Authorization: authorization string
请求头域
除公共头域外,无其它特殊头域。
请求参数
参数名称 | 类型 | 是否必须 | 参数位置 | 描述 |
---|---|---|---|---|
metricsType | String | 是 | URL参数 | 监控类型,取值为BANDWIDTH_RECEIVE、BANDWIDTH_TRANSMIT分别表示入网带宽、出网带宽 |
start | Long | 是 | RequestParam参数 | 起始时间,Unix时间戳,单位秒 |
end | Long | 是 | RequestParam参数 | 终止时间,Unix时间戳,单位秒 |
region | Region | 是 | RequestParam参数 | 指定节点-区域 。详见获取节点列表 |
city | String | 是 | RequestParam参数 | 指定节点-城市。详见获取节点列表 |
serviceProvider | String | 是 | RequestParam参数 | 指定节点-运营商。 移动CHINA_MOBILE,联通CHINA_UNICOM, 电信CHINA_TELECOM,三线TRIPLE_LINE,海外BGP。详见获取节点列表 |
network | String | 否 | RequestParam参数 | 三线指定网络,不传此参数表示全部外网带宽监控的聚合 |
stepInMin | Integer | 否 | RequestParam参数 | 数据点间隔(单位:分钟)。默认5分钟 |
响应头域
除公共头域外,无其它特殊头域。
响应参数
参数名称 | 类型 | 描述 |
---|---|---|
metrics | List<Metric> | 监控类型 |
maxValue | BigDecimal | 最大值 |
avgValue | BigDecimal | 平均值 |
错误码
请参照错误返回章节的内容。
请求示例
GET /v1/monitor/overview/vm/node/BANDWIDTH_TRANSMIT?region=EAST_CHINA&city=WUXI&serviceProvider=CHINA_UNICOM&start=1658246400&end=1658332800&network=intra&metricsType=BANDWIDTH_TRANSMIT 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_MOBILE | 中国移动 |
CHINA_UNICOM | 中国联通 |
CHINA_TELECOM | 中国电信 |
TRIPLE_LINE | 三线 |
BGP | 海外节点 |
Network
编码 | 描述 |
---|---|
cm | 移动 |
un | 联通 |
ct | 电信 |
bgp | 海外 |
intra | 内网 |