全部产品
阿里云办公

查询流量的监控数据

更新时间:2018-09-25 21:02:59

描述

获取加速域名的网络流量监控数据,单位:byte。

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

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

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

请求参数

参数 类型 是否必须 描述
Action String 操作接口名,系统规定参数。
取值:DescribeDcdnDomainTrafficData
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 加速域名信息
DataInterval String 每条记录的时间间隔,以秒为单位
StartTime DateTime 开始时间
EndTime DateTime 结束时间
TrafficDataPerInterval DataModule[] 每个时间间隔的流量数据

DataModule

名称 类型 描述
TimeStamp String 时间片起始时刻
Traffic Float 总流量
DynamicHttpTraffic Float 动态http流量
DynamicHttpsTraffic Float 动态https流量
StaticHttpTraffic Float 静态http流量
StaticHttpsTraffic Float 静态https流量

示例

请求示例

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

返回示例

JSON 格式

  1. {
  2. "DomainName": "test.com",
  3. "DataInterval": "300",
  4. "TrafficDataPerInterval": {
  5. "DataModule": [
  6. {
  7. "TimeStamp": "2017-12-10T20:00:00Z",
  8. "Traffic": 423304182,
  9. "DynamicHttpTraffic": 0,
  10. "DynamicHttpsTraffic": 423304182,
  11. "StaticHttpTraffic": 0,
  12. "StaticHttpsTraffic": 0
  13. }
  14. ]
  15. },
  16. "RequestId": "B955107D-E658-4E77-B913-E0AC3D31693E",
  17. "StartTime": "2017-12-10T20:00:00Z",
  18. "EndTime": "2017-12-10T21:00:00Z"
  19. }

特殊错误码

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