Queries source regions from which a volumetric attack is initiated.

Note This operation is inapplicable to resource exhaustion attacks on websites or connection flood attacks.

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 DescribeDDosEventArea

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

EventType String Yes defense

The type of the attack event that you want to query. Valid values:

  • defense: attack events that trigger traffic scrubbing
  • blackhole: attack events that trigger blackhole filtering
Ip String Yes 203.***. ***.199

The IP address of the attacked Anti-DDoS Pro or Anti-DDoS Premium instance.

StartTime Long Yes 1598948471

The beginning of the time range to query. This value is a UNIX timestamp representing the number of seconds that have elapsed since the epoch time January 1, 1970, 00:00:00 UTC.

Note You can call the DescribeDDosAllEventList operation to query the beginning time of all attack events.

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
Areas Array of EventArea

The information about the source regions from which the volumetric attack was initiated.

Area String 110000

The code or ID of the source region. For more information, see Codes of administrative regions in China and codes of countries and areas. For example, 110000 indicates Beijing, China, and us indicates the United States.

InPkts Long 228

The number of request packets that were sent from the source region.

RequestId String 11710C9F-BC5E-481A-BEC5-C6D8FBFCA827

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=DescribeDDosEventArea
&EventType=defense
&Ip=203. ***. ***.199
&StartTime=1598948471
&<Common request parameters>

Sample success responses

XML format

<DescribeDDosEventAreaResponse>
	  <RequestId>11710C9F-BC5E-481A-BEC5-C6D8FBFCA827</RequestId>
	  <Areas>
		    <Area>us</Area>
		    <InPkts>2</InPkts>
	  </Areas>
	  <Areas>
		    <Area>110000</Area>
		    <InPkts>228</InPkts>
	  </Areas>
  </DescribeDDosEventAreaResponse>

JSON format

{
    "RequestId": "11710C9F-BC5E-481A-BEC5-C6D8FBFCA827",
    "Areas": [
        {
            "Area": "us",
            "InPkts": 2
        },
        {
            "Area": "110000",
            "InPkts": 228
        }
    ]
}

Error codes

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