Queries the frequently referenced URLs within a specific day.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | DescribeDcdnDomainTopUrlVisit |
The operation that you want to perform. Set the value to DescribeDcdnDomainTopUrlVisit. |
DomainName | String | Yes | example.com |
The accelerated domain name. You can specify only one domain name in each call. |
StartTime | String | No | 2018-10-03T16:00:00Z |
The start of the time range to query. Specify the time in the ISO 8601 standard in the YYYY-MM-DDThh:mm:ssZ format. The time must be in UTC. To query the data on a specified day, use the format: yyyy-MM-ddT16:00:00Z. Note If you do not set this parameter, the data within the last 24 hours is queried.
|
SortBy | String | No | pv |
The method that is used to sort the web pages. Valid values:
Default value: pv. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
AllUrlList | Array of UrlList |
A list of frequently requested URLs. |
|
UrlList | |||
Flow | String | 460486880 |
The network traffic that was consumed by visits to the URLs. Unit: bytes. |
FlowProportion | Float | 0.35 |
The proportion of network traffic consumed for accessing the URL. |
UrlDetail | String | http://example.com/nn_live/nn_x64/a0.m3u8 |
The complete string of the URL that was queried. |
VisitData | String | 161673 |
The number of visits to the URL. |
VisitProportion | Float | 0.35 |
The proportion of visits. |
DomainName | String | example.com |
The accelerated domain name for which the data was returned. |
RequestId | String | 64D28B53-5902-409B-94F6-FD46680144FE |
The ID of the request. |
StartTime | String | 2018-10-03T16:00:00Z |
The beginning of the time range during which the data was collected. |
Url200List | Array of UrlList |
A list of URLs for which 2xx status codes were returned. |
|
UrlList | |||
Flow | String | 460486880 |
The network traffic that was consumed by visits to the URLs. Unit: bytes. |
FlowProportion | Float | 0.35 |
The proportion of network traffic consumed for accessing the URL. |
UrlDetail | String | http://example.com/nn_live/nn_x64/a0.m3u8 |
The complete string of the URL that was queried. |
VisitData | String | 161673 |
The number of visits to the URL. |
VisitProportion | Float | 0.35 |
The proportion of visits to the URL. |
Url300List | Array of UrlList |
A list of URLs for which 3xx status codes were returned. |
|
UrlList | |||
Flow | String | 460486880 |
The network traffic that was consumed by visits to the URLs. Unit: bytes. |
FlowProportion | Float | 0.35 |
The proportion of network traffic consumed for accessing the URL. |
UrlDetail | String | http://example.com/nn_live/nn_x64/a0.m3u8 |
The complete string of the URL that was queried. |
VisitData | String | 161673 |
The number of visits to the URL. |
VisitProportion | Float | 0.35 |
The proportion of visits. |
Url400List | Array of UrlList |
A list of URLs for which 4xx status codes were returned. |
|
UrlList | |||
Flow | String | 460486880 |
The network traffic that was consumed by visits to the URLs. Unit: bytes. |
FlowProportion | Float | 0.35 |
The proportion of network traffic consumed for accessing the URL. |
UrlDetail | String | http://example.com/nn_live/nn_x64/a0.m3u8 |
The complete string of the URL that was queried. |
VisitData | String | 161673 |
The number of visits to the URL. |
VisitProportion | Float | 0.35 |
The proportion of visits. |
Url500List | Array of UrlList |
A list of URLs for which 5xx status codes were returned. |
|
UrlList | |||
Flow | String | 460486880 |
The network traffic that was consumed by visits to the URLs. Unit: bytes. |
FlowProportion | Float | 0.35 |
The proportion of network traffic consumed for accessing the URL. |
UrlDetail | String | http://example.com/nn_live/nn_x64/a0.m3u8 |
The complete string of the URL that was queried. |
VisitData | String | 161673 |
The number of visits to the URL. |
VisitProportion | Float | 0.35 |
The proportion of visits. |
Examples
Sample requests
http(s)://dcdn.aliyuncs.com/? Action=DescribeDcdnDomainTopUrlVisit
&DomainName=example.com
&StartTime=2018-10-03T16:00:00Z
&<Common request parameters>
Sample responses
XML
format
<DescribeDcdnDomainTopUrlVisitResponse>
<AllUrlList>
<UrlList>
<VisitData>161673</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/a0.m3u8</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
<UrlList>
<VisitData>37</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/ZXg9MQ,,/HNJSMPP360.ts</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
</AllUrlList>
<Url300List>
<UrlList>
<VisitData>161673</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
<UrlList>
<VisitData>3</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDZXg9MQ,,/HNJSMPP360.ts</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
</Url300List>
<Url400List>
<UrlList>
<VisitData>1884</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUhbGxfcGNfbGl2ZQ,,/HNJSMPP360.m3u8</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
<UrlList>
<VisitData>1</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SEEwODgmpbmRleZPTE,/HNJSMPP360.ts</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
</Url400List>
<RequestId>64D28B53-5902-409B-94F6-FD46680144FE</RequestId>
<DomainName>example.com</DomainName>
<Url200List>
<UrlList>
<VisitData>161673</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU0bGxfcGNfbGl2ZQ,,/HNJSMPP360.m3u8</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
<UrlList>
<VisitData>3</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDMlPTIwMTxMDk5ZXg9MQ,,/HNJSMPP360.ts</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
</Url200List>
<StartTime>2018-10-03T16:00:00Z</StartTime>
<Url500List>
<UrlList>
<VisitData>161673</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
<UrlList>
<VisitData>3</VisitData>
<UrlDetail>http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDZXg9MQ,,/HNJSMPP360.ts</UrlDetail>
<VisitProportion>0.35</VisitProportion>
<Flow>460486880</Flow>
<FlowProportion>0.35</FlowProportion>
</UrlList>
</Url500List>
</DescribeDcdnDomainTopUrlVisitResponse>
JSON
format
{
"AllUrlList": {
"UrlList": [
{
"VisitData": "161673",
"UrlDetail": "http://example.com/nn_live/nn_x64/a0.m3u8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "37",
"UrlDetail": "http://example.com/nn_live/nn_x64/ZXg9MQ,,/HNJSMPP360.ts",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
},
"Url300List": {
"UrlList": [
{
"VisitData": "161673",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "3",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDZXg9MQ,,/HNJSMPP360.ts",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
},
"Url400List": {
"UrlList": [
{
"VisitData": "1884",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUhbGxfcGNfbGl2ZQ,,/HNJSMPP360.m3u8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "1",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SEEwODgmpbmRleZPTE,/HNJSMPP360.ts",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
},
"RequestId": "64D28B53-5902-409B-94F6-FD46680144FE",
"DomainName": "example.com",
"Url200List": {
"UrlList": [
{
"VisitData": "161673",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU0bGxfcGNfbGl2ZQ,,/HNJSMPP360.m3u8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "3",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDMlPTIwMTxMDk5ZXg9MQ,,/HNJSMPP360.ts",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
},
"StartTime": "2018-10-03T16:00:00Z",
"Url500List": {
"UrlList": [
{
"VisitData": "161673",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
},
{
"VisitData": "3",
"UrlDetail": "http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDZXg9MQ,,/HNJSMPP360.ts",
"VisitProportion": 0.35,
"Flow": "460486880",
"FlowProportion": 0.35
}
]
}
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | InvalidStartTime.Malformed | The specified StartTime parameter is invalid. | The error message returned because the format of the specified start time is invalid. Specify the time in the ISO 8601 standard in the yyyy-MM-ddTHH:mm:ssZ format. The time must be in UTC. |
400 | InvalidStartTime.ValueNotSupported | The specified StartTime is invalid. | The error message returned because the specified start time is not supported. Specify a valid value. |
For a list of error codes, visit the API Error Center.