全部产品
阿里云办公

查询带宽的监控数据

更新时间:2018-11-13 20:21:22

描述

获取加速域名的网络带宽监控数据,单位:bit/second。

不指定StartTime和EndTime时,默认读取过去24小时的数据,同时支持按指定的起止时间查询,两者需要同时指定。

  • 支持批量域名查询,多个域名用逗号(半角)分隔。

  • 最多可获取最近90天的数据。

请求参数

参数 类型 必要 描述
Action String 操作接口名,系统规定参数。
取值:DescribeDcdnDomainBpsData
DomainName String 若参数为空,默认返回所有加速域名合并后数据。
可输入需要查询的加速域名。
支持批量域名查询,多个域名用逗号(半角)分隔。
StartTime String 获取数据起始时间点,日期格式按照ISO8601表示法,并使用UTC时间。
格式为:YYYY-MM-DDThh:mm:ssZ。
最小数据粒度为5分钟。
不写默认读取过去24小时数据。
EndTime String 结束时间需大于起始时间。
获日期格式按照ISO8601表示法,并使用UTC时间。
格式为:YYYY-MM-DDThh:mm:ssZ
Interval String 查询数据的时间粒度,支持300、 3600和86400秒。
- 3天以内(不包含3天整)支持300、 3600、 86400。
- 3-31天(不包含31天整)支持3600和86400。
- 31天以上支持86400。
- 不传和传的值不支持时,使用默认值。
LocationNameEn String 区域英文名。
通过DescribeCdnRegionAndIsp接口获得,不传为所有区域。
IspNameEn String 运营商英文名。
通过DescribeCdnRegionAndIsp接口获得,不传为所有运营商。

返回参数

名称 类型 描述
DomainName String 加速域名信息
StartTime DateTime 开始时间
EndTime DateTime 结束时间
BpsDataPerInterval DataModule[] 每个时间间隔的网络带宽数据

DataModule

名称 类型 描述
TimeStamp String 时间片起始时刻
Bps Float bps数据值,单位:bit/second
DynamicHttpBps Float 动态http bps数据值,单位:bit/second
DynamicHttpsBps Float 动态https bps数据值,单位:bit/second
StaticHttpBps Float 静态http bps数据值,单位:bit/second
StaticHttpsBps Float 静态https bps数据值,单位:bit/second

示例

请求示例

  1. http://dcdn.aliyuncs.com?Action=DescribeDcdnDomainBpsData&DomainName=example.com
  2. &StartTime=2017-12-10T20:00:00Z
  3. &EndTime=2017-12-10T21:00:00Z
  4. &<公共请求参数>

返回示例

JSON 格式

  1. {
  2. "BpsDataPerInterval": {
  3. "DataModule": [
  4. {
  5. "TimeStamp": "2017-12-10T20:00:00Z",
  6. "Bps": 11288111,
  7. "DynamicHttpBps": 11286111,
  8. "DynamicHttpsBps": 2000,
  9. "StaticHttpBps": 0,
  10. "StaticHttpsBps": 0
  11. },
  12. {
  13. "TimeStamp": "2017-12-10T20:05:00Z",
  14. "Bps": 11288111,
  15. "DynamicHttpBps": 11286111,
  16. "DynamicHttpsBps": 2000,
  17. "StaticHttpBps": 0,
  18. "StaticHttpsBps": 0
  19. }
  20. ]
  21. },
  22. "DomainName": "test.com",
  23. "DataInterval": "300",
  24. "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
  25. "StartTime": "2017-12-10T20:00:00Z",
  26. "EndTime": "2017-12-10T21:00:00Z"
  27. }

特殊错误码

错误代码 描述 Http 状态码 语义
Throttling Request was denied due to request throttling. 503 请求被流量控制限制
InvalidDomain.NotFound The domain provided does not belong to you. 404 域名不存在或不属于当前用户