Queries the specifications of one or more Anti-DDoS Pro or Anti-DDoS Premium instances.

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 DescribeInstanceSpecs

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

InstanceIds.N RepeatList Yes ddoscoo-cn-mp91j1ao****

The ID of instance N.

Note You can call the DescribeInstanceIds operation to query the IDs of all instances.
RegionId String No cn-hangzhou

The region ID of the instance. Valid values:

  • cn-hangzhou: mainland China, which indicates an Anti-DDoS Pro instance
  • ap-southeast-1: outside mainland China, which indicates an Anti-DDoS Premium instance

Response parameters

Parameter Type Example Description
InstanceSpecs Array

The specifications of the instance.
BandwidthMbps Integer 100

The clean bandwidth of the instance. Unit: Mbit/s.
BaseBandwidth Integer 30

The basic protection bandwidth of the instance. Unit: Gbit/s.
DefenseCount Integer 1

The number of available advanced mitigation sessions for this month.-1 indicates there is no limit on the number of available advanced mitigation sessions. That is, the instance uses the Unlimited mitigation plan.

Note This parameter is returned only if Anti-DDoS Premium instances are queried.
DomainLimit Integer 50

The number of domain names that the instance can protect.
ElasticBandwidth Integer 30

The brustable protection bandwidth of the instance. Unit: Gbit/s.
FunctionVersion String default

The function plan of the instance. Valid values:

  • default: standard function plan
  • enhance: enhanced function plan
InstanceId String ddoscoo-cn-mp91j1ao****

The ID of the instance.
PortLimit Integer 50

The number of ports that the instance can protect.
QpsLimit Integer 3000

The queries per second (QPS) of services.
SiteLimit Integer 5

The number of websites that the instance can protect.
RequestId String 23B0245A-0CCC-4637-A8C6-7CA0479395B2

The ID of the request.

Examples

Sample requests

http(s)://[Endpoint]/? Action=DescribeInstanceSpecs
&InstanceIds.1=ddoscoo-cn-mp91j1ao****
&<Common request parameters>

Sample success responses

XML format 

<DescribeInstanceSpecsResponse>
      <RequestId>23B0245A-0CCC-4637-A8C6-7CA0479395B2</RequestId>
      <InstanceSpecs>
            <QpsLimit>3000</QpsLimit>
            <BaseBandwidth>30</BaseBandwidth>
            <PortLimit>50</PortLimit>
            <InstanceId>ddoscoo-cn-mp91j1ao****</InstanceId>
            <DomainLimit>50</DomainLimit>
            <FunctionVersion>default</FunctionVersion>
            <ElasticBandwidth>30</ElasticBandwidth>
            <SiteLimit>5</SiteLimit>
            <BandwidthMbps>100</BandwidthMbps>
      </InstanceSpecs>
</DescribeInstanceSpecsResponse>

JSON format 

{
    "RequestId": "23B0245A-0CCC-4637-A8C6-7CA0479395B2",
    "InstanceSpecs": [
        {
            "QpsLimit": 3000,
            "BaseBandwidth": 30,
            "PortLimit": 50,
            "InstanceId": "ddoscoo-cn-mp91j1ao****",
            "DomainLimit": 50,
            "FunctionVersion": "default",
            "ElasticBandwidth": 30,
            "SiteLimit": 5,
            "BandwidthMbps": 100
        }
    ]
}

Error codes

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