Queries the information about advanced mitigation sessions of an Anti-DDoS Premium instance, such as the numbers of available and used advanced mitigation sessions.

Note This operation is suitable only for Anti-DDoS Premium.

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 DescribeDefenseCountStatistics

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

RegionId String No ap-southeast-1

The region ID of the instance. Set the value to ap-southeast-1, which indicates an Anti-DDoS Premium instance.

ResourceGroupId String No default

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.

Response parameters

Parameter Type Example Description
DefenseCountStatistics Struct

Details about mitigation sessions.
DefenseCountTotalUsageOfCurrentMonth Integer 1

The number of advanced mitigation sessions used in this month.
FlowPackCountRemain Integer 1

The remaining number of global advanced mitigation sessions that you can use.

Note The global advanced mitigation sessions start to consume when free advanced mitigation sessions of an Anti-DDoS Premium Insurance Plan instance are used up.
MaxUsableDefenseCountCurrentMonth Integer 2

The maximum number of advanced mitigation sessions available for this month.

Note This parameter is available for only Anti-DDoS Premium Insurance Plan instances. Its value is the sum of the number of free advanced mitigation sessions per month plus that of global advanced mitigation sessions that you purchased.
RequestId String 0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=DescribeDefenseCountStatistics
&<Common request parameters>

Sample responses

XML format 

<DescribeDefenseCountStatisticsResponse>
	  <DefenseCountStatistics>
		    <DefenseCountTotalUsageOfCurrentMonth>1</DefenseCountTotalUsageOfCurrentMonth>
		    <FlowPackCountRemain>1</FlowPackCountRemain>
		    <MaxUsableDefenseCountCurrentMonth>2</MaxUsableDefenseCountCurrentMonth>
	  </DefenseCountStatistics>
	  <RequestId>0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc</RequestId>
</DescribeDefenseCountStatisticsResponse>

JSON format 

{
    "DefenseCountStatistics": {
        "DefenseCountTotalUsageOfCurrentMonth": 1,
        "FlowPackCountRemain": 1,
        "MaxUsableDefenseCountCurrentMonth": 2
    },
    "RequestId": "0bcf28g5-d57c-11e7-9bs0-d89d6717dxbc"
}

Error codes

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