全部产品

DescribeDcdnDomainWebsocketTrafficData

更新时间:2019-03-19 15:32:57

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

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

  • 支持批量域名查询,多个域名用逗号(半角)分隔。
  • 最多可获取最近90天的数据。

请求参数

参数 类型 必要 描述
Action String 操作接口名,系统规定参数
取值:DescribeDcdnDomainWebsocketTrafficData
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 时间片起始时刻
WebsocketTraffic Float 总流量

示例

请求示例

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

返回示例

JSON格式

  1. {
  2. "DomainName": "example.com",
  3. "DataInterval": "300",
  4. "TrafficDataPerInterval": {
  5. "DataModule": [
  6. {
  7. "TimeStamp": "2017-12-10T20:00:00Z",
  8. "WebsocketTraffic": 423304182
  9. }
  10. ]
  11. },
  12. "RequestId": "B955107D-E658-4E77-B913-E0AC3D31693E",
  13. "StartTime": "2017-12-10T20:00:00Z",
  14. "EndTime": "2017-12-10T21:00:00Z"
  15. }

特殊错误码

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