调用DescribeDomainBpsDataByLayer根据协议获取加速域名的带宽信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String DescribeDomainBpsDataByLayer

操作接口名,系统规定参数。取值: DescribeDomainBpsDataByLayer

DomainName String example.com

需要查询的加速域名,多个域名用逗号(,)分隔。

默认查询所有加速域名信息。

StartTime String 2020-05-06T07:10:00Z

获取数据起始时间点。日期格式按照ISO8601表示法,并使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。

EndTime String 2020-05-06T07:20:00Z

获取数据结束时间点。日期格式按照ISO8601表示法,并使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。

Interval String 300

查询数据的时间粒度,单位:秒。根据您指定StartTime和EndTime两者的时间跨度,该参数取值如下:

  • 3天以内(不包含3天整)支持300360086400。如果不传该参数,默认值为300
  • 3-31天(不包含31天整)支持360086400。如果不传该参数,默认值为3600
  • 31天及以上支持86400。如果不传该参数,默认值为86400
IspNameEn String unicom

运营商英文名,通过DescribeCdnRegionAndIsp接口获得。默认查询所有运营商。

LocationNameEn String beijing

地域英文名,通过DescribeCdnRegionAndIsp接口获得。默认查询所有地域。

Layer String IPv4

查询维度。

  • 网络层:IPv4IPv6
  • 应用层:HTTPHTTPSQUIC
  • all(默认值):包含网络层和应用层。

返回数据

名称 类型 示例值 描述
BpsDataInterval Array

每个时间间隔的每秒访问次数Bps。

DataModule
TimeStamp String 2020-05-06T07:10:00Z

时间片起始时刻。

TrafficValue String 2838

总流量,单位:Byte。

Value String 75.68

峰值带宽,单位:bps。

DataInterval String 300

每条记录的时间间隔,以秒为单位。

RequestId String C565B910-BC3B-467B-9046-2A48566EA967

请求ID。

示例

请求示例

http://cdn.aliyuncs.com?Action=DescribeDomainBpsDataByLayer
&DomainName=example.com
&StartTime=2020-05-06T07:10:00Z
&EndTime=2020-05-06T07:20:00Z
&<公共请求参数>

正常返回示例

XML 格式

<DescribeDomainBpsDataByLayerResponse>
  <RequestId>C565B910-BC3B-467B-9046-2A48566EA967</RequestId>
  <DataInterval>300</DataInterval>
  <BpsDataInterval>
        <DataModule>
              <Value>75.68</Value>
              <TrafficValue>2838</TrafficValue>
              <TimeStamp>2020-05-06T07:10:00Z</TimeStamp>
        </DataModule>
        <DataModule>
              <Value>99138.85333333333</Value>
              <TrafficValue>3717707</TrafficValue>
              <TimeStamp>2020-05-06T07:15:00Z</TimeStamp>
        </DataModule>
  </BpsDataInterval>
</DescribeDomainBpsDataByLayerResponse>

JSON 格式

{
	"RequestId": "C565B910-BC3B-467B-9046-2A48566EA967",
	"DataInterval": 300,
	"BpsDataInterval": {
		"DataModule": [
			{
				"Value": 75.68,
				"TrafficValue": 2838,
				"TimeStamp": "2020-05-06T07:10:00Z"
			},
			{
				"Value": "99138.85333333333",
				"TrafficValue": 3717707,
				"TimeStamp": "2020-05-06T07:15:00Z"
			}
		]
	}
}

错误码

访问错误中心查看更多错误码。