You can call this operation to query visit statistics collected at intervals of one day for one or all accelerated domains of your account. The statistics are aggregated by Internet service provider (ISP) for your Dynamic Route for Content Delivery Network (DCDN) service.

When you call this operation, follow these rules:
  • If you do not set StartTime and EndTime, the data for the last 24 hours is returned. If you set both StartTime and EndTime, the data for the specified time range is returned.
  • You can only query data for one domain or all domains of your account.
  • You can only query the data within the last 90 days in each call.

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 No DescribeDcdnDomainIspData

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

DomainName String No example.com

The name of the accelerated domain for which you want to query data. You can specify only one domain name. If you do not specify this parameter, the data for all the accelerated domains of your account is returned.

EndTime String No 2015-12-07T12: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).

StartTime String No 2015-12-05T12: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.

Response parameters

Parameter Type Example Description
DataInterval String 86400

The minimum time interval between the entries returned. The value is 86400 seconds.

DomainName String example.com

The name of the accelerated domain for which the data was returned.

EndTime String 2015-12-05T12:00:00Z

The end of the time range during which the data was returned.

RequestId String 2E5AD83F-BD7B-462E-8319-2E30E305519A

The ID of the request.

StartTime String 2015-12-07T12:00:00Z

The beginning of the time range during which the data was returned.

Value

The list of proportions of visits aggregated by ISP.

AvgObjectSize String 800019.0

The average size of returned content, in bytes.

AvgResponseRate String 154.3345765545624

The average response rate, in bytes per second.

AvgResponseTime String 5183.666666666667

The average response time, in milliseconds.

Bps String 380.9614285714286

The bandwidth data.

BytesProportion String 0.003544181046236794

The amount of network traffic transmitted through the specified ISP to the total amount of network traffic in percentile. For example, a value of 90 indicates that 90% of the total network traffic is transferred from the specified region.

Isp String China Unicom

The information about the ISP.

IspEname String unicom

The name of the ISP.

Proportion String 0.01155980271270037

The proportion of the visits aggregated by ISP.

Qps String 5.9523809523809524E-5

The queries per second.

TotalBytes String 2400057

The total amount of network traffic.

TotalQuery String 3

The total number of queries.

Examples

Sample requests

http://dcdn.aliyuncs.com?Action=DescribeDcdnDomainIspData
&DomainName=example.com
&StartTime=2015-12-05T12:00:00Z
&EndTime=2015-12-07T12:00:00Z
&<Common request parameters>

Sample success responses

XML format

<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>China Unicom</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>China Telecom</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>China Mobile</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>2015-12-05T12:00:00Z</EndTime>
	  <StartTime>2015-12-07T12:00:00Z</StartTime>
</DescribeDcdnDomainIspDataResponse>

JSON format

{
	"Value":{
		"IspProportionData":[
			{
				"TotalQuery":"3",
				"Isp":"China Unicom",
				"Bps":"380.9614285714286",
				"Proportion":"0.01155980271270037",
				"AvgResponseRate":"154.3345765545624",
				"IspEname":"unicom",
				"AvgObjectSize":"800019.0",
				"Qps":"5.9523809523809524E-5",
				"AvgResponseTime":"5183.666666666667",
				"TotalBytes":"2400057",
				"BytesProportion":"0.003544181046236794"
			},
			{
				"TotalQuery":"81",
				"Isp":"China Telecom",
				"Bps":"25110.431412698414",
				"Proportion":"0.31211467324291",
				"AvgResponseRate":"1397.1430909315718",
				"IspEname":"telecom",
				"AvgObjectSize":"1953033.5543209878",
				"Qps":"0.0016071428571428571",
				"AvgResponseTime":"1397.8765432098764",
				"TotalBytes":"158195717",
				"BytesProportion":"0.23360872886644055"
			},
			{
				"TotalQuery":"88",
				"Isp":"China Mobile",
				"Bps":"40343.86242857143",
				"Proportion":"0.33908754623921084",
				"AvgResponseRate":"787.8073097249128",
				"IspEname":"mobile",
				"AvgObjectSize":"2888253.7875",
				"Qps":"0.001746031746031746",
				"AvgResponseTime":"3666.193181818182",
				"TotalBytes":"254166333",
				"BytesProportion":"0.37532921137846464"
			}
		]
	},
	"DataInterval":"86400",
	"RequestId":"2E5AD83F-BD7B-462E-8319-2E30E305519A",
	"DomainName":"example.com",
	"EndTime":"2015-12-05T12:00:00Z",
	"StartTime":"2015-12-07T12:00:00Z"
}

Error codes

HTTP status code Error code Error message Description
400 MissingTimeParameter The StartTime and EndTime must be both specified. The error message returned because the StartTime and EndTime parameters must be specified at the same time.
400 InvalidStartTime.Malformed The specified StartTime is invalid. The error message returned because the format of the specified StartTime parameter 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 InvalidEndTime.Malformed The specified EndTime is invalid. The error message returned because the format of the specified EndTime parameter 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 InvalidEndTime.Mismatch The specified EndTime is earlier than the StartTime. The error message returned because the specified EndTime parameter is earlier than the specified StartTime parameter.
400 InvalidStartTime.ValueNotSupported The specified StartTime is invalid. The error message returned because the specified StartTime parameter is invalid.
404 InvalidDomain.NotFound The specified domain does not exist. The error message returned because the specified domain does not exist.

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