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

说明 单用户调用频率为20次/秒。

调试

您可以在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天整）支持300、3600、 86400。如果不传该参数，默认值为300。
  • 3~31天（不包含31天整）支持3600和86400。如果不传该参数，默认值为3600。
  • 31天及以上支持86400。如果不传该参数，默认值为86400。
IspNameEn String 否 unicom

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

LocationNameEn String 否 beijing

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

Layer String 否 IPv4

查询维度。

  • 网络层：IPv4、IPv6。
  • 应用层：http、https、quic。
  • all：包含网络层和应用层。

默认值为all。

返回数据

名称 类型 示例值 描述
BpsDataInterval Array of DataModule

每个时间间隔的每秒访问次数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(s)://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"
			}
		]
	}
}

错误码

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