You can call this operation to query the regional distribution of daily visitors for an accelerated domain.

When you call this operation, follow these rules:
  • If you do not specify the StartTime and EndTime parameters, the data within the last 24 hours is queried. If you specify the StartTime and EndTime parameters, the data within the specified time range is queried.
  • The maximum time range that can be specified is 90 days.

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 DescribeDcdnDomainRegionData

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

DomainName String No example.com

The name of the accelerated domain. You can specify only one domain name. If you do not specify this parameter, all the accelerated domains under your account are queried.

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 UTC+8.
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+8.
  • If you do not specify this parameter, the data within the last 24 hours is queried.

Response parameters

Parameter Type Example Description
DataInterval String 86400

The sampling interval of the visit data. Unit: seconds.

DomainName String test.com

The name of the accelerated domain returned.

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

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

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

The ID of the request.

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

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

Value

The proportion of visit data from each region.

RegionProportionData

The proportion of visit data from each region.

AvgObjectSize String 0

The average response size. Unit: bytes.

AvgResponseRate String 0

The average response speed. Unit: byte/s.

AvgResponseTime String 0

The average response time. Unit: milliseconds.

Bps String 0

The bandwidth.

BytesProportion String 0.003544181046236794

The proportion of the network traffic. For example, a value of 90 indicates that 90% of the network traffic is transferred from the specified region.

Proportion String 0

The proportion of visits from each region. For example, a value of 90 indicates that 90% of the visits are from the specified region.

Qps String 0

The number of queries per second.

Region String Tibet Autonomous Region

The region information.

RegionEname String xizang

The name of the region.

TotalBytes String 0

The total network traffic.

TotalQuery String 0

The total number of queries.

Examples

Sample requests

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

Sample success responses

XML format

<DescribeDcdnDomainRegionDataResponse>
	  <Value>
		    <RegionProportionData>
			      <Bps>380.9614285714286</Bps>
			      <Proportion>0.01155980271270037</Proportion>
			      <TotalBytes>2400057</TotalBytes>
			      <BytesProportion>0.003544181046236794</BytesProportion>
			      <TotalQuery>3</TotalQuery>
			      <RegionEname></RegionEname>
			      <Region>Japan</Region>
			      <AvgResponseRate>154.3345765545624</AvgResponseRate>
			      <AvgObjectSize>800019.0</AvgObjectSize>
			      <Qps>5.9523809523809524E-5</Qps>
			      <AvgResponseTime>5183.666666666667</AvgResponseTime>
		    </RegionProportionData>
		    <RegionProportionData>
			      <Bps>25110.431412698414</Bps>
			      <Proportion>0.31211467324291</Proportion>
			      <TotalBytes>158195717</TotalBytes>
			      <BytesProportion>0.23360872886644055</BytesProportion>
			      <TotalQuery>81</TotalQuery>
			      <RegionEname>xizang</RegionEname>
			      <Region>Tibet Autonomous Region</Region>
			      <AvgResponseRate>1397.1430909315718</AvgResponseRate>
			      <AvgObjectSize>1953033.5543209878</AvgObjectSize>
			      <Qps>0.0016071428571428571</Qps>
			      <AvgResponseTime>1397.8765432098764</AvgResponseTime>
		    </RegionProportionData>
		    <RegionProportionData>
			      <Bps>40343.86242857143</Bps>
			      <Proportion>0.33908754623921084</Proportion>
			      <TotalBytes>254166333</TotalBytes>
			      <BytesProportion>0.37532921137846464</BytesProportion>
			      <TotalQuery>88</TotalQuery>
			      <RegionEname>chongqing</RegionEname>
			      <Region>Chongqing</Region>
			      <AvgResponseRate>787.8073097249128</AvgResponseRate>
			      <AvgObjectSize>2888253.7875</AvgObjectSize>
			      <Qps>0.001746031746031746</Qps>
			      <AvgResponseTime>3666.193181818182</AvgResponseTime>
		    </RegionProportionData>
	  </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>
</DescribeDcdnDomainRegionDataResponse>

JSON format

{
	"Value":{
		"RegionProportionData":[
			{
				"RegionEname":"",
				"TotalQuery":"3",
				"Region": "Japan",
				"Bps":"380.9614285714286",
				"Proportion":"0.01155980271270037",
				"AvgResponseRate":"154.3345765545624",
				"AvgObjectSize":"800019.0",
				"Qps":"5.9523809523809524E-5",
				"AvgResponseTime":"5183.666666666667",
				"TotalBytes":"2400057",
				"BytesProportion":"0.003544181046236794"
			},
			{
				"RegionEname":"xizang",
				"TotalQuery":"81",
				"Region": "Tibet Autonomous Region",
				"Bps":"25110.431412698414",
				"Proportion":"0.31211467324291",
				"AvgResponseRate":"1397.1430909315718",
				"AvgObjectSize":"1953033.5543209878",
				"Qps":"0.0016071428571428571",
				"AvgResponseTime":"1397.8765432098764",
				"TotalBytes":"158195717",
				"BytesProportion":"0.23360872886644055"
			},
			{
				"RegionEname":"chongqing",
				"TotalQuery":"88",
				"Region":"Chongqing",
				"Bps":"40343.86242857143",
				"Proportion":"0.33908754623921084",
				"AvgResponseRate":"787.8073097249128",
				"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 together.
400 InvalidStartTime.Malformed The specified StartTime is invalid. The error message returned because 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 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 start time 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.