Querying Traffic Blocking Information_AAD Protection Policies_AAD APIs_API Reference

Function

This API is used to query traffic blocking information.

Calling Method

For details, see Calling APIs.

Authorization Information

Each account has all the permissions required to call all APIs, but IAM users must be assigned the required permissions.

If you are using role/policy-based authorization, see Permissions Policies and Supported Actions for details on the required permissions.
If you are using identity policy-based authorization, no identity policy-based permission required for calling this API.

URI

GET /v2/aad/policies/ddos/flow-block

**Table 1** Query Parameters
Parameter	Mandatory	Type	Description
instance_id	Yes	String	instanceId

Request Parameters

**Table 2** Request header parameters
Parameter	Mandatory	Type	Description
X-Auth-Token	Yes	String	token
Content-Type	Yes	String	Content-Type

Response Parameters

Status code: 200

**Table 3** Response body parameters
Parameter	Type	Description
total	Integer	total
ips	Array of Ips objects	ips

**Table 4** Ips
Parameter	Type	Description
ip_id	String	ip id
ip	String	ip
isp	String	Line
data_center	String	Data center
foreign_switch_status	Integer	Blocking status of regions outside the Chinese mainland. *0: disabled. 1: enabled.
udp_switch_status	Integer	Whether to disable UDP. 0: disabled. 1: enabled.

Status code: 400

**Table 5** Response body parameters
Parameter	Type	Description
error_code	String	Error code.
error_description	String	Error description.

Example Requests

Query the traffic blocking information of the instance whose ID is fcf2-xxxx-xxxx-xxxx-fa16.

GET https://{endpoint}/v2/aad/policies/ddos/flow-block?instance_id=fcf2-xxxx-xxxx-xxxx-fa16

Example Responses

Status code: 200

{
  "total" : 2,
  "ips" : [ {
    "ip_id" : "9115fcf2-xxxx-xxxx-xxxx-fa163eaa216e",
    "ip" : "1.x.x.111",
    "isp" : "bgp",
    "data_center" : "hybgp",
    "foreign_switch_status" : 0,
    "udp_switch_status" : 0
  }, {
    "ip_id" : "1dc01300-xxxx-xxxx-xxxx-286ed488d4b1",
    "ip" : "3.x.x.22",
    "isp" : "china_mobile",
    "data_center" : "eastchina",
    "foreign_switch_status" : 0,
    "udp_switch_status" : 0
  } ]
}

Status Codes

Status Code	Description
200	OK
400	Error response

Error Codes

See Error Codes.

Querying Traffic Blocking Information