Queries IP addresses in the blacklist of an Anti-DDoS Pro or Anti-DDoS Premium instance.

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 DescribeAutoCcBlacklist

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

InstanceId String Yes ddoscoo-cn-mp91j1ao****

The ID of the instance.

Note You can call the DescribeInstanceIds operation to query the IDs of all instances.
PageNumber Integer Yes 1

The number of the page to return. For example, to query the returned results on the first page, set the value to 1.

PageSize Integer Yes 10

The number of entries to return on each page.

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
KeyWord String No 138

The keyword for the query. This keyword is used to specify the prefix of the source IP address that you want to query.

Note It must be greater than three characters in length.

Response parameters

Parameter Type Example Description
AutoCcBlacklist Array

Details about the IP address in the blacklist of the instance.

DestIp String 203.***. ***.132

The IP address of the instance.

EndTime Long 1584093569

The validity period of the IP address in the blacklist. 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.

SourceIp String 1.1.1.1

The IP address in the blacklist.

Type String manual

The mode of how an IP address is added to the blacklist. Valid values:

  • manual: manually added
  • auto: automatically added
RequestId String E78C8472-0B15-42D5-AF22-A32A78818AB2

The ID of the request.

TotalCount Long 2

The total number of returned IP addresses in the blacklist.

Examples

Sample requests

http(s)://[Endpoint]/?Action=DescribeAutoCcBlacklist
&InstanceId=ddoscoo-cn-mp91j1ao****
&PageNumber=1
&PageSize=10
&<Common request parameters>

Sample success responses

XML format

<DescribeAutoCcBlacklistResponse>
      <TotalCount>2</TotalCount>
      <RequestId>E78C8472-0B15-42D5-AF22-A32A78818AB2</RequestId>
      <AutoCcBlacklist>
            <Type>manual</Type>
            <SourceIp>1.1.1.1</SourceIp>
            <EndTime>1584093569</EndTime>
            <DestIp>203. ***. ***.132</DestIp>
      </AutoCcBlacklist>
      <AutoCcBlacklist>
            <Type>manual</Type>
            <SourceIp>2.2.2.2</SourceIp>
            <EndTime>1584093569</EndTime>
            <DestIp>203. ***. ***.132</DestIp>
      </AutoCcBlacklist>
</DescribeAutoCcBlacklistResponse>

JSON format

{
    "TotalCount": 2,
    "RequestId": "E78C8472-0B15-42D5-AF22-A32A78818AB2",
    "AutoCcBlacklist": [
        {
            "Type": "manual",
            "SourceIp": "1.1.1.1",
            "EndTime": "1584093569",
            "DestIp": "203. ***. ***.132"
        },
        {
            "Type": "manual",
            "SourceIp": "2.2.2.2",
            "EndTime": "1584093569",
            "DestIp": "203. ***. ***.132"
        }
    ]
}

Error codes

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