Querying Geo-blocking Rules_AAD Protection Policies_AAD APIs_API Reference

Function

This API is used to query a geo-blocking rule.

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/waf/geoip-rule

**Table 1** Query Parameters
Parameter	Mandatory	Type	Description
domain_name	Yes	String	Domain name
overseas_type	Yes	Integer	Protection region. 0: regions in the Chinese mainland. 1: regions outside the Chinese mainland.

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
items	Array of WafGeoIpRule objects	items

**Table 4** WafGeoIpRule
Parameter	Type	Description
geoip	String	Location
id	String	id
name	String	Rule name
overseas_type	Integer	Protected area.
timestamp	Integer	Addition time
white	Integer	Protective action. The options are 0, 1, and 2. 0: The service blocks attacks. 1: The service allows requests. 2: The service only logs requests.

Example Requests

None

Example Responses

Status code: 200

{
  "total" : 1,
  "items" : [ {
    "id" : "bf2db709-xxxx-xxxx-ba37-70bd389117cc",
    "name" : "ttt",
    "timestamp" : 1750643260278,
    "white" : 1,
    "geoip" : "GD|AU"
  } ]
}

Status Codes

Status Code	Description
200	OK

Error Codes

See Error Codes.

Querying Geo-blocking Rules