全部产品
弹性计算 会员服务 网络 安全 移动云 数加·大数据分析及展现 数加·大数据应用 管理与监控 云通信 阿里云办公 培训与认证 更多
存储与CDN 数据库 域名与网站(万网) 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 开发者工具 解决方案 物联网 智能硬件
CDN

查询域名的带宽监测数据

更新时间:2018-03-30 15:57:19

描述

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

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

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

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

请求参数

参数 类型 是否必选 示例值 描述
Action String DescribeDomainBpsData

系统规定参数。取值:DescribeDomainBpsData

DomainName String test.test.com

  • 若参数为空,默认返回所有加速域名合并后数据。
  • 可输入需要查询的加速域名。
  • 支持批量域名查询,多个域名用逗号(半角)分隔。

DomainType String dynamic

查询类型。

  • 传dynamic时,查询全站加速动态资源的实时带宽和静态资源的实时带宽。
  • 不传时查询静态资源的实时带宽。

EndTime String 2015-12-10T20:00Z

  • 结束时间需大于起始时间。
  • 获日期格式按照ISO8601表示法,并使用UTC时间。
  • 格式为:YYYY-MM-DDThh:mmZ。

FixTimeGap String false

是否补零。

Interval String 300

查询数据的时间粒度。

  • 支持300, 3600, 14400, 28800和86400秒。
  • 不传和传的值不支持时,使用默认值300秒。

IspNameEn String telecom

运营商英文名,通过DescribeCdnRegionAndIsp接口获得,不传为所有运营商。

LocationNameEn String beijing

区域英文名,通过DescribeCdnRegionAndIsp接口获得,不传为所有区域。

StartTime String 2015-12-10T20:00Z

获取数据起始时间点。

  • 日期格式按照ISO8601表示法,并使用UTC时间。
  • 格式为:YYYY-MM-DDThh:mmZ。
  • 最小数据粒度为5分钟。
  • 不写默认读取过去24小时数据。

TimeMerge String on

取值范围:

  • on:默认值,每条记录的时间间隔会根据时间跨度做合并。
  • off:返回5分钟粒度数据,最大时间跨度为31天。

返回参数

参数 类型 示例值 描述
RequestId String 3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F

请求ID

DomainName String test.test.com

加速域名。

DataInterval String 300

需要补充时间间隔规则,每条记录的时间间隔,以秒为单位。

StartTime String 2015-12-10T20:00Z

开始时间。

EndTime String 2015-12-10T20:00Z

结束时间。

LocationNameEn String beijing

区域英文名,通过DescribeCdnRegionAndIsp接口获得,不传为所有区域。

IspNameEn String unicom

运营商英文名,通过DescribeCdnRegionAndIsp接口获得,不传为所有运营商。

LocationName String 北京市

区域名。

IspName String 联通

运营商名称。

BpsDataPerInterval

每个时间间隔的网络带宽数据。

  └TimeStamp String 2015-12-10T20:00:00Z

时间片起始时刻。

  └Value String 11288111

bps数据值。
单位:bit/second

  └DomesticValue String 11286111

国内带宽bps,当按区域运营商查询时,此值为空。

  └OverseasValue String 2000

海外带宽bps,当按区域运营商查询时,此值为空。

  └DynamicValue String 0

全站加速,动态bps数据值。
单位:bit/second

  └DynamicDomesticValue String 0

全站加速,国内带宽动态bps,当按区域运营商查询时,此值为空。

  └DynamicOverseasValue String 0

全站加速,海外带宽动态bps,当按区域运营商查询时,此值为空。

  └StaticValue String 0

全站加速,静态bps数据值。
单位:bit/second

  └StaticDomesticValue String 0

全站加速,国内带宽静态bps,当按区域运营商查询时,此值为空。

  └StaticOverseasValue String 0

全站加速,海外带宽静态bps,当按区域运营商查询时,此值为空。

  └L2Value String 0

L2 bps数据值。
单位:bit/second

  └DomesticL2Value String 0

L2国内带宽bps,当按区域运营商查询时,此值为空。

  └OverseasL2Value String 0

L2海外带宽bps,当按区域运营商查询时,此值为空。

SupplyBpsDatas

补充最近30分钟内参考实时带宽数据,可能不存在。

  └TimeStamp String 2015-12-10T20:00:00Z

时间片起始时刻。

  └Value String 11288111

bps数据值。
单位:bit/second

示例

请求示例

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

正常返回示例

JSON 格式

  1. {
  2. "BpsDataPerInterval":{
  3. "DataModule":[
  4. {
  5. "DomesticL2Value":"0",
  6. "DomesticValue":"11286111",
  7. "DynamicDomesticValue":"0",
  8. "DynamicOverseasValue":"0",
  9. "DynamicValue":"0",
  10. "L2Value":"0",
  11. "OverseasL2Value":"0",
  12. "OverseasValue":"2000",
  13. "StaticDomesticValue":"0",
  14. "StaticOverseasValue":"0",
  15. "StaticValue":"0",
  16. "TimeStamp":"2015-12-10T20:00:00Z",
  17. "Value":"11288111"
  18. },
  19. {
  20. "DomesticL2Value":"0",
  21. "DomesticValue":"12112821",
  22. "DynamicDomesticValue":"0",
  23. "DynamicOverseasValue":"0",
  24. "DynamicValue":"0",
  25. "L2Value":"0",
  26. "OverseasL2Value":"0",
  27. "OverseasValue":"12000",
  28. "StaticDomesticValue":"0",
  29. "StaticOverseasValue":"0",
  30. "StaticValue":"0",
  31. "TimeStamp":"2015-12-10T20:05:00Z",
  32. "Value":"12124821"
  33. }
  34. ]
  35. },
  36. "DataInterval":"300",
  37. "DomainName":"test.com",
  38. "EndTime":"2015-12-10T21:00Z",
  39. "RequestId":"3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
  40. "StartTime":"2015-12-10T20:00Z",
  41. "SupplyBpsDatas":{
  42. "DataModule":[
  43. {
  44. "TimeStamp":"2015-12-10T20:05:00Z",
  45. "Value":"12124821"
  46. },
  47. {
  48. "TimeStamp":"2015-12-10T20:06:00Z",
  49. "Value":"12144838"
  50. }
  51. ]
  52. }
  53. }

异常返回示例

JSON 格式

  1. {
  2. "Code":"InternalError",
  3. "HostId":"cdn.aliyuncs.com",
  4. "Message":"The request processing has failed due to some unknown error.",
  5. "RequestId":"16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
  6. }

错误码

查看本产品错误码

本文导读目录