获取加速域名的网络带宽监控数据,单位: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

示例

请求示例


http://cdn.aliyuncs.com?Action=DescribeDomainBpsData&DomainName=test.com
&StartTime=2015-12-10T20:00Z
&EndTime=2015-12-10T21:00Z
&公共请求参数
正常返回示例
  • JSON格式

    {
        "BpsDataPerInterval":{
            "DataModule":[
                {
                    "DomesticL2Value":"0",
                    "DomesticValue":"11286111",
                    "DynamicDomesticValue":"0",
                    "DynamicOverseasValue":"0",
                    "DynamicValue":"0",
                    "L2Value":"0",
                    "OverseasL2Value":"0",
                    "OverseasValue":"2000",
                    "StaticDomesticValue":"0",
                    "StaticOverseasValue":"0",
                    "StaticValue":"0",
                    "TimeStamp":"2015-12-10T20:00:00Z",
                    "Value":"11288111"
                },
                {
                    "DomesticL2Value":"0",
                    "DomesticValue":"12112821",
                    "DynamicDomesticValue":"0",
                    "DynamicOverseasValue":"0",
                    "DynamicValue":"0",
                    "L2Value":"0",
                    "OverseasL2Value":"0",
                    "OverseasValue":"12000",
                    "StaticDomesticValue":"0",
                    "StaticOverseasValue":"0",
                    "StaticValue":"0",
                    "TimeStamp":"2015-12-10T20:05:00Z",
                    "Value":"12124821"
                }
            ]
        },
        "DataInterval":"300",
        "DomainName":"test.com",
        "EndTime":"2015-12-10T21:00Z",
        "RequestId":"3C6CCEC4-6B88-4D4A-93E4-D47B3D92CF8F",
        "StartTime":"2015-12-10T20:00Z",
        "SupplyBpsDatas":{
            "DataModule":[
                {
                    "TimeStamp":"2015-12-10T20:05:00Z",
                    "Value":"12124821"
                },
                {
                    "TimeStamp":"2015-12-10T20:06:00Z",
                    "Value":"12144838"
                }
            ]
        }
    }
异常返回示例
  • JSON格式

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