Queries the administrative regions in China from which requests are sent to one or more Anti-DDoS Pro or Anti-DDoS Premium instances within a specific period of time.

Note This operation cannot reflect the actual traffic volume because the algorithm to collect identity statistics at Layer 4 is updated for Anti-DDoS Pro and Anti-DDoS Premium. You can call this operation to calculate only the proportion of requests sent from the administrative regions in China. If you want to query the request traffic volume, we recommend that you call the DescribePortFlowList operation.

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 DescribePortViewSourceProvinces

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

RegionId String No cn-hangzhou

The region ID of the instance. Valid values:

  • cn-hangzhou: the Chinese mainland, which indicates an Anti-DDoS Pro instance. This is the default value.
  • ap-southeast-1: outside the Chinese mainland, which indicates an Anti-DDoS Premium instance.
ResourceGroupId String No rg-acfm2pz25js****

The ID of the resource group to which the instance belongs in Resource Management. This parameter is empty by default, which indicates that the instance belongs to the default resource group.

For more information about resource groups, see Create a resource group.

EndTime Long No 1583683200

The end of the time range to query. The value is a UNIX timestamp. Unit: seconds. If you do not specify this parameter, the current system time is used as the end time.

Note This UNIX timestamp must indicate a time that is accurate to the minute.
StartTime Long Yes 1582992000

The beginning of the time range to query. The value is a UNIX timestamp. Unit: seconds.

Note This UNIX timestamp must indicate a time that is accurate to the minute.
InstanceIds.N String Yes ddoscoo-cn-mp91j1ao****

The ID of instance N.

Note You can call the DescribeInstanceIds operation to query the IDs of all instances.

All Alibaba Cloud API operations must include common request parameters. For more information about common request parameters, see Common parameters.

For more information about sample requests, see the "Examples" section of this topic.

Response parameters

Parameter Type Example Description
SourceProvinces Array of Province

Details about the administrative region in China from which the requests are sent.

ProvinceId String 440000

The ID of the administrative region in China from which the requests are sent. For example, 110000 indicates Beijing, and 120000 indicates Tianjin.

Note For more information, see Location parameters.
Count Long 3390671

The number of requests.

Note This parameter does not indicate the accurate number of requests. You can use this parameter to calculate the proportion of requests from different administrative regions in China.
RequestId String C33EB3D5-AF96-43CA-9C7E-37A81BC06A1E

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribePortViewSourceProvinces
&EndTime=1583683200
&StartTime=1582992000
&InstanceIds=["ddoscoo-cn-mp91j1ao****"]
&<Common request parameters>

Sample success responses

XML format 

HTTP/1.1 200 OK
Content-Type:application/xml

<DescribePortViewSourceProvincesResponse>
    <SourceProvinces>
        <ProvinceId>440000</ProvinceId>
        <Count>3390671</Count>
    </SourceProvinces>
    <RequestId>C33EB3D5-AF96-43CA-9C7E-37A81BC06A1E</RequestId>
</DescribePortViewSourceProvincesResponse>

JSON format 

HTTP/1.1 200 OK
Content-Type:application/json

{
  "SourceProvinces" : [ {
    "ProvinceId" : "440000",
    "Count" : 3390671
  } ],
  "RequestId" : "C33EB3D5-AF96-43CA-9C7E-37A81BC06A1E"
}

Error codes

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