调用DescribeDcdnDomainIspData获取加速域名天粒度的用户运营商分布数据统计,支持获取最近90天的数据。
- 如果您指定StartTime和EndTime时,默认读取过去24小时的数据;指定StartTime和EndTime时,按指定的起止时间查询。
- 您可以查询单个域名或当前账号下所有域名数据。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 否 | DescribeDcdnDomainIspData |
操作接口名,系统规定参数。取值:DescribeDcdnDomainIspData。 |
DomainName | String | 否 | example.com |
加速域名,仅支持查询单个域名。 默认查询当前用户下所有域名。 |
StartTime | String | 否 | 2019-12-05T12:00:00Z |
获取数据起始时间点,北京时间,格式为YYYY-MM-DDThh:mm:ssZ。 |
EndTime | String | 否 | 2019-12-06T12:00:00Z |
获取数据结束时间,北京时间,格式为YYYY-MM-DDThh:mm:ssZ。 结束时间需大于起始时间。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
DataInterval | String | 86400 |
每条记录的时间间隔,单位:秒。 |
DomainName | String | example.com |
加速域名信息。 |
EndTime | String | 2019-12-06T12:00:00Z |
结束时间。 |
RequestId | String | 2E5AD83F-BD7B-462E-8319-2E30E305519A |
请求ID。 |
StartTime | String | 2019-12-05T12:00:00Z |
开始时间。 |
Value | Array |
各运营商访问占比数据列表。 |
|
IspProportionData | |||
AvgObjectSize | String | 800019.0 |
响应平均大小,单位:byte。 |
AvgResponseRate | String | 154.3345765545624 |
平均响应速度,单位:byte/毫秒。 |
AvgResponseTime | String | 5183.666666666667 |
平均响应时间,单位:毫秒。 |
Bps | String | 380.9614285714286 |
带宽。 |
BytesProportion | String | 0.003544181046236794 |
总流量占比。例如:返回90即为90%。 |
Isp | String | 联通 |
运营商信息。 |
IspEname | String | unicom |
运营商英文名称。 |
Proportion | String | 0.01155980271270037 |
占比使用数据。 |
Qps | String | 5.9523809523809524E-5 |
每秒查询率。 |
TotalBytes | String | 2400057 |
总流量。 |
TotalQuery | String | 3 |
总请求次数。 |
示例
请求示例
http://dcdn.aliyuncs.com/?Action=DescribeDcdnDomainIspData
&DomainName=example.com
&StartTime=2019-12-05T12:00:00Z
&EndTime=2019-12-06T12:00:00Z
&<公共请求参数>
正常返回示例
XML
格式
<DescribeDcdnDomainIspDataResponse>
<Value>
<IspProportionData>
<Bps>380.9614285714286</Bps>
<Proportion>0.01155980271270037</Proportion>
<TotalBytes>2400057</TotalBytes>
<BytesProportion>0.003544181046236794</BytesProportion>
<TotalQuery>3</TotalQuery>
<IspEname>unicom</IspEname>
<Isp>联通</Isp>
<AvgResponseRate>154.3345765545624</AvgResponseRate>
<AvgObjectSize>800019.0</AvgObjectSize>
<Qps>5.9523809523809524E-5</Qps>
<AvgResponseTime>5183.666666666667</AvgResponseTime>
</IspProportionData>
<IspProportionData>
<Bps>25110.431412698414</Bps>
<Proportion>0.31211467324291</Proportion>
<TotalBytes>158195717</TotalBytes>
<BytesProportion>0.23360872886644055</BytesProportion>
<TotalQuery>81</TotalQuery>
<IspEname>telecom</IspEname>
<Isp>电信</Isp>
<AvgResponseRate>1397.1430909315718</AvgResponseRate>
<AvgObjectSize>1953033.5543209878</AvgObjectSize>
<Qps>0.0016071428571428571</Qps>
<AvgResponseTime>1397.8765432098764</AvgResponseTime>
</IspProportionData>
<IspProportionData>
<Bps>40343.86242857143</Bps>
<Proportion>0.33908754623921084</Proportion>
<TotalBytes>254166333</TotalBytes>
<BytesProportion>0.37532921137846464</BytesProportion>
<TotalQuery>88</TotalQuery>
<IspEname>mobile</IspEname>
<Isp>移动</Isp>
<AvgResponseRate>787.8073097249128</AvgResponseRate>
<AvgObjectSize>2888253.7875</AvgObjectSize>
<Qps>0.001746031746031746</Qps>
<AvgResponseTime>3666.193181818182</AvgResponseTime>
</IspProportionData>
</Value>
<DataInterval>86400</DataInterval>
<RequestId>2E5AD83F-BD7B-462E-8319-2E30E305519A</RequestId>
<DomainName>example.com</DomainName>
<EndTime>2019-12-06T12:00:00Z</EndTime>
<StartTime>2019-12-05T12:00:00Z</StartTime>
</DescribeDcdnDomainIspDataResponse>
JSON
格式
{
"Value": {
"IspProportionData": [
{
"Bps": "380.9614285714286",
"Proportion": "0.01155980271270037",
"TotalBytes": "2400057",
"BytesProportion": "0.003544181046236794",
"TotalQuery": "3",
"IspEname": "unicom",
"Isp": "联通",
"AvgResponseRate": "154.3345765545624",
"AvgObjectSize": "800019.0",
"Qps": "5.9523809523809524E-5",
"AvgResponseTime": "5183.666666666667"
},
{
"Bps": "25110.431412698414",
"Proportion": "0.31211467324291",
"TotalBytes": "158195717",
"BytesProportion": "0.23360872886644055",
"TotalQuery": "81",
"IspEname": "telecom",
"Isp": "电信",
"AvgResponseRate": "1397.1430909315718",
"AvgObjectSize": "1953033.5543209878",
"Qps": "0.0016071428571428571",
"AvgResponseTime": "1397.8765432098764"
},
{
"Bps": "40343.86242857143",
"Proportion": "0.33908754623921084",
"TotalBytes": "254166333",
"BytesProportion": "0.37532921137846464",
"TotalQuery": "88",
"IspEname": "mobile",
"Isp": "移动",
"AvgResponseRate": "787.8073097249128",
"AvgObjectSize": "2888253.7875",
"Qps": "0.001746031746031746",
"AvgResponseTime": "3666.193181818182"
}
]
},
"DataInterval": "86400",
"RequestId": "2E5AD83F-BD7B-462E-8319-2E30E305519A",
"DomainName": "example.com",
"EndTime": "2019-12-06T12:00:00Z",
"StartTime": "2019-12-05T12:00:00Z"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | MissingTimeParameter | The StartTime and EndTime must be both specified. | 请同时提供开始时间和结束时间。 |
400 | InvalidEndTime.Malformed | The specified EndTime is invalid. | 请提供正确的结束时间格式。日期格式按照ISO8601表示法,并使用UTC时间。 格式为:yyyy-MM-ddTHH:mm:ssZ。 |
400 | InvalidEndTime.Mismatch | The specified EndTime is earlier than the StartTime. | 结束时间早于开始时间,请检查。 |
400 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. | 不支持该开始时间,请重新填写。 |
404 | InvalidDomain.NotFound | The specified domain does not exist. | 该域名不存在。 |
访问错误中心查看更多错误码。