查询高速通道监控信息
1.接口描述
调用 DescribePeerConnectMonitorData 接口查看高速通道的监控信息,最多查询30天内数据
2.请求参数
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Action | String | 是 | 固定取值:DescribePeerConnectMonitorData |
ResourceUUID | String | 是 | 高速通道资源UUID |
StartTime | String | 是 | 获取数据的起始时间点,格式为:yyyy-MM-dd HH:mm:ss |
EndTime | String | 是 | 获取数据的结束时间点,格式为:yyyy-MM-dd HH:mm:ss |
RegionCode | String | 是 | 高速通道查看监控端的地域,您可以调用 DescribeRegionConfig 接口获取地域编码 |
3.返回数据
名称 | 类型 | 说明 |
---|---|---|
RequestId | String | 请求ID |
peerConnectMonitorInfos | Array[PeerConnectMonitorInfo] | 高速通道监控数据集合 |
Unit | String | 监控数据单位(Kbps、Mbps) |
InMaxBandwidth | Double | 入网带宽峰值 |
InMaxBandwithTime | Date | 入网带宽峰值时间 |
OutMaxBandwidth | Double | 出网带宽峰值 |
OutMaxBandwithTime | Date | 出带宽峰值时间 |
4.示例
请求示例
http://openapi.kaopuyun.com/?&Action=DescribePeerConnectMonitorData
&AccessKeyId=ix00000kmig1
&EndTime=2024-05-24%2023%3A57%3A00
&Format=JSON
&RegionCode=cn-dev-1
&ResourceUUID=p2c-5d000007z42b
&SignatureMethod=HMAC-SHA1
&SignatureNonce=e0557cb0-a695-4bdc-93bd-1836489848c6
&SignatureVersion=1.0
&StartTime=2024-05-24%2016%3A00%3A00
&Timestamp=2024-05-25T02%3A56%3A34Z
&Version=2014-05-26
&Signature=s01cpn6cMqLfXYqkDQ4xl%2Bh5VDU%3D
正常返回示例
{
"OutMaxBandwithTime": "2024-05-24T16:10:00.000+08:00",
"RequestId": "08f5bdb0-1e34-11ef-be21-aa1e82384555",
"OutMaxBandwidth": 59.26,
"InMaxBandwidth": 1374.1,
"InMaxBandwithTime": "2024-05-24T16:10:00.000+08:00",
"Unit": "Mbps",
"peerConnectMonitorInfos": [
{
"InBandwidth": 0.0,
"OutBandwidth": 0.0,
"Time": "2024-05-24T16:00:00.000+08:00"
},
{
"InBandwidth": 0.0,
"OutBandwidth": 0.0,
"Time": "2024-05-24T16:05:00.000+08:00"
},
{
"InBandwidth": 1374.1,
"OutBandwidth": 59.26,
"Time": "2024-05-24T16:10:00.000+08:00"
}
]
}
5.错误码
错误码
错误码 | 错误信息 |
---|---|
MissingParameter | ResourceUUID参数不能为空 |
MissingParameter | StartTime参数不能为空 |
MissingParameter | EndTime参数不能为空 |
MissingParameter | RegionCode参数不能为空 |
AvailablePeerConnectNotFound | 可用的高速通道未找到 |
QueryTimeError | 查询时间错误 |
NoOperationAuthority | 无操作权限 |
AvailableRegionNotFound | 可用的地域未找到 |
DescribePeerConnectMonitorDataFail | 查询高速通道监控数据失败:xxx |