获取加速域名的带宽信息_数据监控类接口_新版API参考_CDN

说明

不指定StartTime和EndTime时，默认读取过去24小时的数据；同时支持按指定的起止时间查询，StartTime和EndTime两者需要同时指定。
历史数据保留时间（仅供参考）：五分钟粒度的数据保留时间为62天，小时粒度的数据保留时间为120天，天粒度的数据保留时间为366天。
单用户调用频率为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"
			}
		]
	}
}

错误码

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