全部产品
云市场

查询域名的带宽监控数据

更新时间:2018-11-29 15:45:09

DescribeScdnDomainBpsData

描述

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

  • 不指定StartTime和EndTime时,默认读取过去24小时的数据,同时支持按指定的起止时间查询,两者需要同时指定。
  • 支持批量域名查询,多个域名用逗号(半角)分隔。
  • 最多可获取最近90天的数据。

请求参数

参数 类型 必要 描述
Action String 操作接口名,系统规定参数
取值:DescribeScdnDomainBpsData
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 时间片起始时刻
BpsValue String bps数据值,单位:bit/second
HttpBpsValue String http bps数据值,单位:bit/second
HttpsBpsValue String https bps数据值,单位:bit/second

特殊错误码

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

示例

请求示例:

  1. http://scdn.aliyuncs.com?Action=DescribeScdnDomainBpsData&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. "BpsValue": "11288111",
  7. "HttpBpsValue": "11286111",
  8. "HttpsBpsValue": "2000"
  9. },
  10. {
  11. "TimeStamp": "2017-12-10T20:05:00Z",
  12. "BpsValue": "1288111",
  13. "HttpBpsValue": "1286111",
  14. "HttpsBpsValue": "2000"
  15. }
  16. ]
  17. },
  18. "DomainName": "example.com",
  19. "DataInterval": "300",
  20. "RequestId": "3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
  21. "StartTime": "2017-12-10T20:00:00Z",
  22. "EndTime": "2017-12-10T21:00:00Z"
  23. }