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

说明
  • 不指定StartTimeEndTime时,默认读取过去24小时的数据;同时支持按指定的起止时间查询,StartTimeEndTime两者需要同时指定。
  • 历史数据保留时间(仅供参考):五分钟粒度的数据保留时间为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

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

  • 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:包含网络层和应用层。

默认值为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"
			}
		]
	}
}

错误码

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