调用DescribeDomainDetailDataByLayer按协议类型获取加速域名的数据明细(域名维度)。

使用说明

  • 单用户调用频率:20次/秒。
  • 如果您不指定StartTime和EndTime,该接口返回过去24小时的数据;指定StartTime和EndTime,该接口返回指定时间段的数据。
支持查询的时间粒度

根据单次查询的最大时间跨度不同,查询的数据时间粒度、可查询历史数据时间范围和数据延迟如下:

时间粒度

单次查询的最大时间跨度

可查询历史数据时间范围

数据延迟

5分钟

3天

93天

15分钟

1小时

31天

186天

4小时

1天

366天

366天

次日凌晨4点

调试

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

请求参数

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

系统规定参数。取值:DescribeDomainDetailDataByLayer

Field String bps,ipv6_traf,traf,http_code,qps

需要查询的指标。支持多指标查询,多个指标用英文逗号(,)分隔,包含bpsqpstrafaccipv6_trafipv6_bpsipv6_accipv6_qpshttp_code

DomainName String example.com

需要查询的域名。支持批量域名查询,多个域名用半角逗号(,)分隔,一次最多支持30个域名查询。

StartTime String 2020-07-05T22:00:00Z

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

EndTime String 2020-07-05T22:05:00Z

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

说明 结束时间需大于起始时间。
IspNameEn String telecom

运营商英文名,通过DescribeCdnRegionAndIsp接口获得。

不传值代表所有运营商。

LocationNameEn String hangzhou

区域英文名,通过DescribeCdnRegionAndIsp接口获得。

不传值代表所有区域。

Layer String all

查询维度,应用层(httphttpsquic)或 all

默认为all

返回数据

名称 类型 示例值 描述
RequestId String BEA5625F-8FCF-48F4-851B-CA63946DA664

请求ID。

Data Array of DataModule

查询的加速域名返回数据。

DataModule
Traf Long 789756701818

流量,单位:Byte。

Qps Float 5998.47

Qps。

Ipv6Qps Float 0

Ipv6的Qps。

Ipv6Bps Float 0

Ipv6带宽,单位:Bps。

Acc Long 2

请求数。

Ipv6Traf Long 141718944482

Ipv6流量,单位:Byte。

Ipv6Acc Long 1

Ipv6请求数。

TimeStamp String 2020-07-05T22:00:00Z

时间片起始时刻。

HttpCode String 200:44349|206:1753719|304:45|403:1095|416:1|499:332

http状态码分布。

Bps Float 21060178715.146667

带宽,单位:Bps。

DomainName String example.com

域名。

示例

请求示例

http://cdn.aliyuncs.com?Action=DescribeDomainDetailDataByLayer
&DomainName=example.com
&Filed=bps,qps,traf,acc,ipv6_traf,ipv6_bps,ipv6_acc,ipv6_qps,http_code
&StartTime=2020-07-05T22:00:00Z
&EndTime=2020-07-05T22:05:00Z
&<公共请求参数>

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribeDomainDetailDataByLayerResponse>
<Data>
    <Acc>2</Acc>
    <Ipv6Bps>0</Ipv6Bps>
    <HttpCode>200:2</HttpCode>
    <Ipv6Qps>0</Ipv6Qps>
    <Bps>268.8986666666667</Bps>
    <Traf>10083</Traf>
    <Ipv6Acc>0</Ipv6Acc>
    <DomainName>example.com</DomainName>
    <Qps>0.006666666666666667</Qps>
    <Ipv6Traf>0</Ipv6Traf>
    <TimeStamp>2020-09-07T03:35:00Z</TimeStamp>
</Data>
<RequestId>BEA5625F-8FCF-48F4-851B-CA63946DA664</RequestId>
</DescribeDomainDetailDataByLayerResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "Data" : [ {
    "Acc" : 2,
    "Ipv6Bps" : 0,
    "HttpCode" : "200:2",
    "Ipv6Qps" : 0,
    "Bps" : 268.8986666666667,
    "Traf" : 10083,
    "Ipv6Acc" : 0,
    "DomainName" : "example.com",
    "Qps" : 0.006666666666666667,
    "Ipv6Traf" : 0,
    "TimeStamp" : "2020-09-07T03:35:00Z"
  } ],
  "RequestId" : "BEA5625F-8FCF-48F4-851B-CA63946DA664"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidStartTime.Malformed Specified start time is malformed. 开始时间格式错误。日期格式请参考所调用API的帮助文档说明。
400 InvalidEndTime.Malformed Specified end time is malformed. 结束时间格式错误。

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