CDN:Rules engine

Match type

Corresponding parameter in the condition function

Description

Match object

Match operator

Match value

Case sensitivity

Corresponding variable in NGINX or Tengine

Protocol

scheme

The protocol over which the request is sent, such as HTTP or HTTPS.

N/A

• Equal to

• Not equal to

• http

• https

N/A

$scheme

Request method

method

The request method, such as GET or PUT.

N/A

• Equal to

• Not equal to

• get

• put

• post

• delete

• head

N/A

$request_method

URI

uri

The path in the request URL, excluding request parameters. Example: /favicon.ico.

N/A

• Include any

• Exclude any

The question mark (?) and asterisk (*) wildcards are supported. For example, /*/my_path/* is a valid expression. You can specify multiple values in each expression.

• Case-sensitive

• Case-insensitive

$raw_uri or $uri

File name

basename

The name of the file that is requested by the client. Example: name1.

N/A

• Include any

• Exclude any

The question mark (?) and asterisk (*) wildcards are supported. You can specify multiple values in each expression.

• Case-sensitive

• Case-insensitive

-

File name extension

extension

The suffix of the file that is requested by the client, which starts from the last period (.), such as, .mp4.

N/A

• Include any

• Exclude any

The question mark (?) and asterisk (*) wildcards are supported. You can specify multiple values in each expression.

• Case-sensitive

• Case-insensitive

-

Hostname

hostname

The hostname that is carried in the request. The matching priority: host in the request URL > host in the HOST header of the request.

N/A

• Include any

• Exclude any

The host of the request. You can specify multiple values.

• Case-sensitive

• Case-insensitive

$host or $http_host

Client IP address

clientip

The IP address of the client. IPv4 addresses such as 1.1.X.X, IPv6 addresses such as 240e:95c:3004:2:3:0:0:XXX, and CIDR blocks such as 20.209.XXX.XXX/31 are supported.

• IP addresses that are used to connect to POPs

• XFF IP

• Include any

• Exclude any

IPv6 addresses such as 240e:XXX:3004:2:3:0:0:3f7 and CIDR blocks such as 120.209.XXX.XXX/31 are supported. You can specify multiple values.

N/A

$remote_addr

Client IP version

clientipVer

IPv4 or IPv6

• IP addresses that are used to connect to POPs

• XFF IP

• Equal to

• Not equal to

• v4

• v6

N/A

-

Internet service provider (ISP)

geolocation

The ISP to which the IP address of the client belongs.

• IP addresses that are used to connect to POPs

• XFF IP

• Include any

• Exclude any

You can select a value from the drop-down list or enter characters to filter options. Fuzzy match by ID or name is supported. You can specify multiple values.

N/A

$ip_isp_id

IP location

geolocation

The geographical location of the client IP address.

• IP addresses that are used to connect to POPs

• XFF IP

• Include any

• Exclude any

You can select a value from the drop-down list or enter characters to filter options. Fuzzy match by ID or name is supported. You can specify multiple values.

N/A

$ip_country_id

Request parameter

querystring

The parameter that is carried in the request URL.

Enter a parameter name.

• Existent

• Non-existent

• Include any

• Exclude any

• Greater than

• Greater than or equal to

• Smaller than

• Smaller than or equal to

The question mark (?) and asterisk (*) wildcards are supported. You can specify multiple values in each expression.

• Case-sensitive

• Case-insensitive

$arg_{name}

Request header

header

The header that is carried in the request.

Enter a parameter name or select a parameter from the drop-down list.

• Existent

• Non-existent

• Include any

• Exclude any

• Greater than

• Greater than or equal to

• Smaller than

• Smaller than or equal to

You can specify multiple values.

• Case-sensitive

• Case-insensitive

$http_{name}

Cookie

cookie

The cookie that is carried in the request.

Enter a cookie name.

• Existent

• Non-existent

• Include any

• Exclude any

• Greater than

• Greater than or equal to

• Smaller than

• Smaller than or equal to

The question mark (?) and asterisk (*) wildcards are supported. You can specify multiple values in each expression.

• Case-sensitive

• Case-insensitive

$cookie_{name}

User-Agent

useragent

The User-Agent field in the request header.

N/A

• Include any

• Exclude any

You can select a value from the drop-down list or enter a User-Agent value, such as *Chrome/25*. The question mark (?) and asterisk (*) wildcards are supported. You can specify multiple values in each expression.

• Case-sensitive

• Case-insensitive

$http_user_agent

Range bucket

range

Requests are grouped and executed based on the percentage.

N/A

• Equal to

• Not equal to

Enter a percentage.

N/A

-

Time range

time

The time range during which the request was initiated, in UTC+8. Example: 09:10 to 14:22.

N/A

• Include any

• Exclude any

Enter a time range, such as 09:10 to 14:22.

N/A

-

Nginx Var

ngxvar

If all the preceding variables in the table cannot meet your requirements, you can use NGINX variables. For more information, see Alphabetical index of variables.

Select a variable from the drop-down list or enter a variable name in the $region:$isp format.

• Existent

• Non-existent

• Include any

• Exclude any

• Greater than

• Greater than or equal to

• Smaller than

• Smaller than or equal to

You can specify multiple values.

N/A

${name}

Operator

Corresponding parameter in the condition function

Description

Equal to

The value of the matchOperator parameter is equals.

The condition is true only when all variables are equal to or not equal to the match value.

Not equal to

The value of the matchOperator parameter is equals, and the value of the negate parameter is true.

Existent

The value of the matchOperator parameter is exists.

The condition is true regardless of whether the variable exists.

Non-existent

The value of the matchOperator parameter is exists, and the value of the negate parameter is true.

Include any

The value of the matchOperator parameter is contains.

The condition is true if variables contain or do not contain any of the match values. You can specify up to 32 match values.

Exclude any

The value of the matchOperator parameter is contains, and the value of the negate parameter is true.

Greater than

The value of the matchOperator parameter is gt.

>

Smaller than

The value of the matchOperator parameter is lt.

<

Greater than or equal to

The value of the matchOperator parameter is ge.

>=

Smaller than or equal to

The value of the matchOperator parameter is le.

<=

Regular expression match

The value of the matchOperator parameter is regex.

You can enter a regular expression as the match value.

Regular expression mismatch

The value of the matchOperator parameter is regex, and the value of the negate parameter is true.

Wildcard

Description

?

One character can be matched.

*

Any characters can be matched.