腾讯云CDN:1分钟粒度流量带宽查询接口

需积分: 0 0 下载量 166 浏览量 更新于2024-08-05 收藏 269KB PDF 举报
"微软提供了一个名为`GetCdnProvIspOneMinuteStat`的API接口,用于查询CDN(内容分发网络)服务的1分钟粒度流量和带宽统计数据。这个接口允许用户获取特定省份、运营商的详细信息,也可以查询全国范围内的汇总数据。接口的请求域名为cdn.api.qcloud.com,适用于对CDN性能有精细监控需求的场景。" 在使用该接口时,有几个关键参数需要注意: 1. **startTime**:这是查询的起始时间,必须提供,类型为字符串。 2. **endTime**:这是查询的结束时间,同样必须提供,类型也为字符串。 3. **hosts.n**:非必需参数,用于指定需要查询的域名,可以填写多个。 4. **projects.n**:非必需参数,用于指定项目,可能与不同的服务或应用关联。 5. **statType**:必需参数,定义统计类型,可选值为"bandwidth"(带宽)或"flux"(流量)。 6. **provs.n**:非必需参数,通过省份编码指定省份,如果未指定,则默认查询全国数据。 7. **isps.n**:非必需参数,通过运营商编码指定运营商,未指定则查询指定省份的所有运营商。 接口的返回数据包含以下字段: - **code**:整型,表示错误代码,0表示成功,其他值表示失败。 - **message**:字符串,提供错误信息描述。 - **codeDesc**:英文错误信息或业务错误码。 - **data**:数组,包含查询结果的详细数据,包括流量和带宽信息。 数据列表中的每个元素包含: - **start_time**:查询起始时间。 - **end_time**:查询结束时间。 - **total_data**:数组,存储具体的数据点。 需要注意的是,查询的时间跨度不能超过3天,且调用频率限制为每分钟100次。此外,流量以byte为单位,带宽以bps为单位。查询示例展示了如何构造GET请求,包含startTime、endTime、hosts.0和statType等参数。 通过这个接口,IT管理员或开发者可以实时监控CDN服务的性能,及时发现并解决问题,确保内容分发的稳定性和效率。这对于优化用户体验,特别是对于高流量、实时性要求高的在线服务至关重要。同时,根据省份和运营商的统计数据,还可以进行网络性能分析,以便进一步优化CDN节点分布和资源分配。