查询共享带宽监控信息
1. 接口描述
调用 DescribeBandwidthPackageMonitorData 接口查看共享带宽监控信息,最多查询90天内的数据,查询时间跨度不超过30天。
2. 请求参数
名称 | 类型 | 是否必选 | 描述 |
---|---|---|---|
Action | String | 是 | 固定取值:DescribeBandwidthPackageMonitorData |
BwpUUID | String | 是 | 共享带宽唯一标识 |
StartTime | String | 是 | 获取数据的起始时间点,格式为:yyyy-MM-dd HH:mm:ss |
EndTime | String | 是 | 获取数据的结束时间点,格式为:yyyy-MM-dd HH:mm:ss |
Period | Integer | 否 | 获取监控数据的精度,单位:秒,默认:300 可选值:300,600,3600 |
3. 返回数据
名称 | 类型 | 描述 |
---|---|---|
RequestId | String | 请求ID |
BandwidthPackageMonitorInfos | Array[ BandwidthPackageMonitorInfo] | 监控数据列表 |
4. 示例
请求示例
https://openapi.kaopuyun.com/?AccessKeyId=sz0000ei53aw
&Action=DescribeBandwidthPackageMonitorData
&Format=JSON
&BwpUUID=bwp-rh00000das8i
&EndTime=2023-05-05 12:00:00
&StartTime=2023-05-01 12:00:00
&SignatureMethod=HMAC-SHA1
&SignatureNonce=76a5d5e7-0992-462d-9a26-916650eca00f
&SignatureVersion=1.0
&Timestamp=2023-03-09T07%3A33%3A56Z
&Version=2014-05-26
&Signature=LH5UYKO7k%2FeQlyLH3p169uyRKyU%3D
正常返回示例
{
"RequestId" : "c9a11d60-ed71-11ed-b030-5665de72f33b",
"BandwidthPackageMonitorInfos" : [
{
"RxPackets" : 0.0,
"TxPackets" : 0.0,
"RxBytes" : 0.0,
"TxBytes" : 0.0,
"TimeStamp" : "2023-05-01 12:05:00"
},
{
"RxPackets" : "0.0",
"TxPackets" : "0.0",
"RxBytes" : "0.0",
"TxBytes" : "0.0",
"TimeStamp" : "2023-05-01 12:10:00"
}
]
}
5. 错误码
错误码 | 错误信息 |
---|---|
MissingParameter | BwpUUID/StartTime/EndTime 参数不能为空 |
AvailableBwpNotFound | 指定的共享带宽包不存在 |
NoOperationAuthority | 无操作权限 |
QueryTimeError | 查询时间错误 |
QueryDataExceedsLimit | 查询数据超出限制 |
QueryTimeRangeExceededLimit | 查询时间范围超出限制 |
DescribeBandwidthPackageMonitorDataFail | 查询共享带宽包监控数据失败:xxxxx |