接口描述
GetCdnMonitorData 用于查询 CDN 各省份运营商监控延迟、可用性数据。
接口请求域名:cdn.api.qcloud.com
Note:
查询最新的延迟、可用性数据,数据一分钟更新一次,延迟约五分钟,请勿频繁调用
数据来源于第三方监测工具,对监测文件进行定频访问,得到的服务状态数据
接口返回三大运营商联通、移动、电信各省份的延迟/可用性数据,及电信、移动、联通、长城宽带、铁通、电信通六个运营商在各省份的平均可用性/延迟数据
调用频次限制为100次/分钟
无需授权,开通 CDN 服务后可直接使用
入参说明
出参说明
参数名称 | 类型 | 描述 |
code | Int | |
message | String | 模块错误信息描述,与接口相关。 |
codeDesc | String | 英文错误信息,或业务侧错误码。 |
data | Array | 返回结果数据,详情见下文 |
详细说明
data
参数名称 | 类型 | 描述 |
succ_rate | Array | 可用性数据,单位为% |
delay_time | Array | 时延数据,单位为 ms |
succ_rate/delay_time
参数名称 | 类型 | 描述 |
pro_id | Int | 省份 ID |
name | String | 省份名称 |
value | Array | "1":表示电信<br/>"2":表示联通<br/>"4":表示移动<br/>"16777215":电信、移动、联通、长城宽带、铁通、电信通平均值 |
调用案例
GET 请求
GET 请求需要将所有参数都加在 URL 后(逗号进行转码):
https://cdn.api.qcloud.com/v2/index.php?Action=GetCdnMonitorData&SecretId=XXXXXXXXXXXXXXXXXXXXXXXXXXXXX&Timestamp=1462436277&Nonce=123456789&Signature=XXXXXXXXXXXXXXXXXXXXX
POST请求
POST 请求时,参数填充在 HTTP Requestbody 中,请求地址:
https://cdn.api.qcloud.com/v2/index.php
参数支持 formdata、xwwwformurlencoded 等格式,参数数组如下:
array ('Action' => 'GetCdnMonitorData','SecretId' => 'XXXXXXXXXXXXXXXXXXXXXXXXXXXX','Timestamp' => 1462782282,'Nonce' => 123456789,'Signature' => 'XXXXXXXXXXXXXXXXXXXXXXXX')
返回示例
注意:示例中IP仅供参考。
{"code":0,"message":"","codeDesc":"Success","data":{"succ_rate":[{"pro_id":1,"name":"黑龙江","value":{"1":98.289166666667,"2":99.073333333333,"4":100,"16777215":98.789166666667}}....]"delay_time":[{"pro_id":1,"name":"黑龙江","value":{"1":491.16666666667,"2":260.58333333333,"4":280.91666666667,"16777215":357.91666666667}}.....]}}