You can call this operation to query frequently referenced URLs in the back-to-origin requests for one or more CDN domains.

If you do not specify the StartTime parameter, the data for the previous day is returned.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameters

Parameter Type Required Example Description
Action String Yes DescribeDomainSrcTopUrlVisit

The operation that you want to perform. Set the value to DescribeDomainSrcTopUrlVisit.

DomainName String Yes example.com

The name of the CDN domain that you want to query data for. You can specify multiple CDN domains and separate them with commas (,).

If you do not set this parameter, the data of all your CDN domains is returned.
EndTime String No 2018-10-03T20:00:00Z

The end of the time range to query.

  • The end time must be later than the start time.
  • Specify the time in the ISO 8601 standard in the YYYY-MM-DDThh:mm:ssZ format. The time must be in Coordinated Universal Time (UTC).
SortBy String No pv

The method for ranking the URLs that you want to query. Valid values: traf and pv. Default value: pv.

StartTime String No 2018-10-03T16:00:00Z

The beginning 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.
  • The time granularity is 5 minutes.
  • If you do not specify this parameter, the data for the last 24 hours is queried.

Response parameters

Parameter Type Example Description
AllUrlList

The list of all frequently referenced URLs that were queried.
UrlList

The details of the URL that was queried.
Flow String 460486880

The network traffic consumed for the visits to the queried URL. Unit: bytes.
FlowProportion Float 0.35

The proportion of the 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 that was queried.
VisitProportion Float 0.35

The proportion of the visits to the URL.
DomainName String example.com

The name of the CDN domain that was queried.
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 queried.
Url200List

The list of URLs for which a 2xx HTTP status code was returned.
UrlList

The details of the URL for which a 2xx HTTP status code was returned.
Flow String 460486880

The network traffic consumed for the visits to the queried URL. Unit: bytes.
FlowProportion Float 0.35

The proportion of the 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 that was queried.
VisitProportion Float 0.35

The proportion of the visits to the URL.
Url300List

The list of URLs for which a 3xx HTTP status code was returned.
UrlList

The details of the URL for which a 3xx HTTP status code was returned.
Flow String 460486880

The network traffic consumed for the visits to the queried URL. Unit: bytes.
FlowProportion Float 0.35

The proportion of the 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 that was queried.
VisitProportion Float 0.35

The proportion of the visits to the URL.
Url400List

The list of URLs for which a 4xx HTTP status code was returned.
UrlList

The details of the URL for which a 4xx HTTP status code was returned.
Flow String 460486880

The network traffic consumed for the visits to the queried URL. Unit: bytes.
FlowProportion Float 0.35

The proportion of the 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 that was queried.
VisitProportion Float 0.35

The proportion of the visits to the URL.
Url500List

The list of URLs for which a 5xx HTTP status code was returned.
UrlList

The details of the for which a 5xx HTTP status code was returned.
Flow String 460486880

The network traffic consumed for the visits to the queried URL. Unit: bytes.
FlowProportion Float 0.35

The proportion of the 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 that was queried.
VisitProportion Float 0.35

The proportion of the visits to the URL.

Examples

Sample requests

http://cdn.aliyuncs.com?Action=DescribeDomainSrcTopUrlVisit
&DomainName=example.com
&StartTime=2018-10-03T16:00:00Z
&<Common request parameters>

Sample success responses

XML format 

<DescribeDomainSrcTopUrlVisitResponse>
  <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/aWQ9SE5KU01QUhb,,/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/aWQ9SEEwODgm,/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/aWQ9SE5KU0bGxfcG,,/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/aWQ9SE5KDMlPTIwMTQ,,/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>
</DescribeDomainSrcTopUrlVisitResponse>

JSON format 

{
	"Url300List":{
		"UrlList":[
			{
				"Flow":"460486880",
				"VisitProportion":0.35,
				"VisitData":"161673",
				"UrlDetail":"http://example.com/nn_live/nn_x64/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8",
				"FlowProportion":0.35
			},
			{
				"Flow":"460486880",
				"VisitProportion":0.35,
				"VisitData":"3",
				"UrlDetail":"http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDZXg9MQ,,/HNJSMPP360.ts",
				"FlowProportion":0.35
			}
		]
	},
	"AllUrlList":{
		"UrlList":[
			{
				"Flow":"460486880",
				"VisitProportion":0.35,
				"VisitData":"161673",
				"UrlDetail":"http://example.com/nn_live/nn_x64/a0.m3u8",
				"FlowProportion":0.35
			},
			{
				"Flow":"460486880",
				"VisitProportion":0.35,
				"VisitData":"37",
				"UrlDetail":"http://example.com/nn_live/nn_x64/ZXg9MQ,,/HNJSMPP360.ts",
				"FlowProportion":0.35
			}
		]
	},
	"Url400List": {
		"UrlList":[
			{
				"Flow":"460486880",
				"VisitProportion":0.35,
				"VisitData":"1884",
				"UrlDetail":"http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUhb,,/HNJSMPP360.m3u8",
				"FlowProportion":0.35
			},
			{
				"Flow":"460486880",
				"VisitProportion":0.35,
				"VisitData":"1",
				"UrlDetail":"http://example.com/nn_live/nn_x64/aWQ9SEEwODgm,/HNJSMPP360.ts",
				"FlowProportion":0.35
			}
		]
	},
	"RequestId":"64D28B53-5902-409B-94F6-FD46680144FE",
	"DomainName":"example.com",
	"Url200List":{
		"UrlList":[
			{
				"Flow":"460486880",
				"VisitProportion":0.35,
				"VisitData":"161673",
				"UrlDetail":"http://example.com/nn_live/nn_x64/aWQ9SE5KU0bGxfcG,,/HNJSMPP360.m3u8",
				"FlowProportion":0.35
			},
			{
				"Flow":"460486880",
				"VisitProportion":0.35,
				"VisitData":"3",
				"UrlDetail":"http://example.com/nn_live/nn_x64/aWQ9SE5KDMlPTIwMTQ,,/HNJSMPP360.ts",
				"FlowProportion":0.35
			}
		]
	},
	"StartTime":"2018-10-03T16:00:00Z",
	"Url500List":{
		"UrlList":[
			{
				"Flow":"460486880",
				"VisitProportion":0.35,
				"VisitData":"161673",
				"UrlDetail":"http://example.com/nn_live/nn_x64/aWQ9SE5KU0GNfbGl2ZQ,,/HNJSMPP360.m3u8",
				"FlowProportion":0.35
			},
			{
				"Flow":"460486880",
				"VisitProportion":0.35,
				"VisitData":"3",
				"UrlDetail":"http://example.com/nn_live/nn_x64/aWQ9SE5KU01QUDZXg9MQ,,/HNJSMPP360.ts",
				"FlowProportion":0.35
			}
		]
	}
}

Error codes

HTTP status code Error code Error message Description
400 InvalidStartTime.Malformed Specified StartTime is malformed. The error message returned because the specified start time is incorrectly formatted. For more information about the time format, see the Request parameters section.
400 InvalidEndTime.Malformed Specified EndTime is malformed. The error message returned because the specified end time is incorrectly formatted. For more information about the time format, see the Request parameters section.
400 InvalidStartTime.ValueNotSupported The specified value of parameter StartTime is not supported. The error message returned because the specified start time is not supported.

For a list of error codes, visit the API Error Center.