调用DescribeRangeDataByLocateAndIspService获取加速域名在某个时刻不同运营商和地域的带宽数据。
说明 查询的数据时间粒度为5分钟。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
名称 | 类型 | 是否必选 | 示例值 | 描述 |
---|---|---|---|---|
Action | String | 是 | DescribeRangeDataByLocateAndIspService |
操作接口名,系统规定参数。取值:DescribeRangeDataByLocateAndIspService。 |
DomainNames | String | 是 | example.com |
加速域名。 |
EndTime | String | 是 | 2019-11-30T05:40:00Z |
获取数据结束时间点。日期格式按照ISO8601表示法,并使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。 说明 结束时间大于开始时间,并且结束时间和开始时间相差不超过1小时。
|
StartTime | String | 是 | 2019-11-30T05:33:00Z |
获取数据开始时间点。日期格式按照ISO8601表示法,并使用UTC时间,格式为yyyy-MM-ddTHH:mm:ssZ。 |
IspNames | String | 否 | unicom,telecom |
运营商名,多个运营商名使用英文逗号(,)分隔。 运营商名通过DescribeCdnRegionAndIsp接口查询。 |
LocationNames | String | 否 | liaoning,guangxi |
地域名,多个地域名使用英文逗号(,)分隔。 地域名通过DescribeCdnRegionAndIsp接口查询。 |
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
JsonResult | String | {"1472659200":{"天津市":{"电信":{"http_codes":{"000":0,"200":6,"400":0},"rt":4183,"bandwidth":46639,"avg_speed":7773,"pv":6,"hit_rate":0.93,"request_hit_rate":0.66}}}} |
JSON格式的返回结果。 从左到右依次为:unix时间,地区,运营商,HTTP状态码分布,响应时长,带宽(单位:bps),响应平均速率,页面浏览量,缓存命中率,请求命中率。 |
RequestId | String | 16A96B9A-F203-4EC5-8E43-CB92E68F4CD8 |
请求ID。 |
示例
请求示例
http://cdn.aliyuncs.com/?Action=DescribeRangeDataByLocateAndIspService
&DomainNames=example.com
&LocationNames=liaoning,guangxi
&IspNames=unicom,telecom
&startTime=2019-11-30T05:33:00Z
&EndTime=2019-11-30T05:40:00Z
&<公共请求参数>
正常返回示例
XML
格式
<DescribeRangeDataByLocateAndIspServiceResponse>
<JsonResult>
<1472659200>
<天津市>
<电信>
<bandwidth>9889849.592</bandwidth>
<pv>5739</pv>
<hit_rate>0</hit_rate>
<http_codes>
<200>5675</200>
<206>5</206>
<302>5</302>
<304>45</304>
<400>1</400>
<403>8</403>
<404>0</404>
<405>0</405>
<408>0</408>
<412>0</412>
<416>0</416>
<500>0</500>
<501>0</501>
<502>0</502>
<503>0</503>
<504>0</504>
<000>0</000>
</http_codes>
<rt>0</rt>
</电信>
<联通/>
<移动/>
</天津市>
<北京市>
<电信>
<bandwidth>9889849.592</bandwidth>
<pv>5739</pv>
<hit_rate>0</hit_rate>
<http_codes>
<200>5675</200>
<206>5</206>
<302>5</302>
<304>45</304>
<400>1</400>
<403>8</403>
<404>0</404>
<405>0</405>
<408>0</408>
<412>0</412>
<416>0</416>
<500>0</500>
<501>0</501>
<502>0</502>
<503>0</503>
<504>0</504>
<000>0</000>
</http_codes>
<rt>0</rt>
</电信>
<联通/>
<移动/>
</北京市>
</1472659200>
<1472659500>
<天津市>
<电信>
<bandwidth>7024681.44</bandwidth>
<pv>5819</pv>
<hit_rate>0</hit_rate>
<http_codes>
<200>5716</200>
<206>11</206>
<302>3</302>
<304>72</304>
<400>1</400>
<403>16</403>
<404>0</404>
<405>0</405>
<408>0</408>
<412>0</412>
<416>0</416>
<500>0</500>
<501>0</501>
<502>0</502>
<503>0</503>
<504>0</504>
<000>0</000>
</http_codes>
<rt>0</rt>
</电信>
<联通/>
<移动/>
</天津市>
</1472659500>
</JsonResult>
<RequestId>16A96B9A-F203-4EC5-8E43-CB92E68F4CD8</RequestId>
</DescribeRangeDataByLocateAndIspServiceResponse>
JSON
格式
{
"JsonResult":[{
"1472659200": {
"天津市": {
"电信": {
"bandwidth": 9889849.592,
"pv": 5739,
"hit_rate": 0,
"http_codes": {
"200": 5675,
"206": 5,
"302": 5,
"304": 45,
"400": 1,
"403": 8,
"404": 0,
"405": 0,
"408": 0,
"412": 0,
"416": 0,
"500": 0,
"501": 0,
"502": 0,
"503": 0,
"504": 0,
"000": 0
},
"rt": 0
},
"联通": {},
"移动": {}
},
"北京市": {
"电信": {
"bandwidth": 9889849.592,
"pv": 5739,
"hit_rate": 0,
"http_codes": {
"200": 5675,
"206": 5,
"302": 5,
"304": 45,
"400": 1,
"403": 8,
"404": 0,
"405": 0,
"408": 0,
"412": 0,
"416": 0,
"500": 0,
"501": 0,
"502": 0,
"503": 0,
"504": 0,
"000": 0
},
"rt": 0
},
"联通": {},
"移动": {}
}
},
"1472659500": {
"天津市": {
"电信": {
"bandwidth": 7024681.44,
"pv": 5819,
"hit_rate": 0,
"http_codes": {
"200": 5716,
"206": 11,
"302": 3,
"304": 72,
"400": 1,
"403": 16,
"404": 0,
"405": 0,
"408": 0,
"412": 0,
"416": 0,
"500": 0,
"501": 0,
"502": 0,
"503": 0,
"504": 0,
"000": 0
},
"rt": 0
},
"联通": {},
"移动": {}
}
}
}],
"RequestId": "16A96B9A-F203-4EC5-8E43-CB92E68F4CD8"
}
错误码
HttpCode | 错误码 | 错误信息 | 描述 |
---|---|---|---|
400 | InvalidStartTime.Malformed | Specified StartTime is malformed. | 起始时间格式错误。日期格式请参考所调用API的帮助文档说明。 |
400 | InvalidEndTime.Malformed | Specified EndTime is malformed. | 结束时间格式错误。日期格式请参考所调用API的帮助文档说明。 |
400 | InvalidStartTime.ValueNotSupported | The specified value of parameter StartTime is not supported. | 开始时间设置错误,请检查更新后重试。 |
访问错误中心查看更多错误码。