优先级

表示规则的优先级。在规则列表中，每条规则都有优先级。优先级为 1 的规则具有最高优先级。当收到一个用户请求时，CDN 按规则的优先级，从高到低尝试将请求与规则匹配。如果请求匹配了一条规则，匹配过程就停止了。您可以拖动规则来调整优先级。需要留意的是，您无法调整那条预设规则的优先级。

规则中的过滤条件定义了规则的作用范围。如果您创建了多条规则，请留意这些规则的作用范围是否存在交集，并按您的预期设置规则的优先级。例如，您创建了两条规则。规则A 的作用范围是 /dir/，规则B 的作用范围是 png;jpg。如果 /dir/ 目录下存在 .png 文件，并且您希望规则B 对 .png 文件的请求生效，那么您需要设置规则B 的优先级高于规则A。

规则类型

表示规则中的过滤类型。该配置有以下选项：

• 文件后缀：表示请求 URL 中的扩展名。

• 文件目录：表示请求路径中的某个目录。

• 文件全路径：表示请求 URL。

• 全路径正则：表示通过正则表达式匹配请求 URL。

规则

表示规则的内容。内容长度不能超过 1,024 个字符，不能包含以下字符：

• 连续斜杠（//）、空格、美元符号（$）、问号（?）、Delete（ASCII code 127）。

在匹配用户请求时，规则内容不区分大小写。

该配置的额外说明如下：

• 如果 规则类型 是 文件后缀，规则内容必须是一个或者多个以分号（;）分隔的文件后缀。文件后缀无需以句点（.）开头。例如：png;txt。

• 如果 规则类型 是 文件目录，规则内容必须是一个或者多个以分号（;）分隔的目录路径。目录路径必须以斜杠（/）开头和结尾。例如：/chs/foods/;/us/birds/。

• 如果 规则类型 是 文件全路径，规则内容必须是一个或者多个以分号（;）分隔的文件路径。文件路径必须以斜杠（/）开头，可以包含星号（*）用来表示一个或者多个字符。例如：/chs/foods/local*sets;/us/birds/chickadee。

• 如果 规则类型 是 全路径正则，规则内容是一个或者多个正则表达式，用于匹配用户请求 URL 中的路径。对于一个用户请求，如果该正则表达式匹配了路径中的任何部分，这条规则就匹配了该用户请求。参见 配置示例。要指定 全路径正则，请 提交工单。

参数设置

表示回源请求 URL 中查询参数的设置方式。该配置有以下选项：

• 保留全部参数：表示回源请求 URL 中包含用户请求 URL 中的全部查询参数。

• 删除全部参数：表示回源请求 URL 中不包含用户请求 URL 中的任何查询参数。

• 添加指定参数：表示回源请求 URL 中包含用户请求 URL 中的全部查询参数，并额外包含 参数内容 中指定的那些查询参数。

• 保留指定参数：表示如果用户请求 URL 中存在 参数名称 中指定的查询参数，那么回源请求 URL 中包含这些指定的查询参数。

• 删除指定参数：表示回源请求 URL 中包含用户请求 URL 中的全部查询参数，除了 参数名称 中指定的那些查询参数。

• 重置指定参数：表示回源请求 URL 中包含用户请求 URL 中的全部查询参数。同时，对于您在 参数内容 中指定的查询参数和参数值，CDN 会执行以下操作:

  • 如果这些查询参数在用户请求 URL 中，CDN 会在回源请求 URL 中将这些查询数的值设置为您指定的值。
  • 如果用户请求 URL 中不包含这些查询参数，CDN 会在回源请求 URL 中添加这些查询参数。

参数名称

表示一个或者多个查询参数，多个查询参数之间使用分号（;）分隔，总长度不能超过 1,024 个字符。查询参数只能包含字母、数字、下划线（_）、逗号（,）、短横线（-）、句点（.）和感叹号（!）。

在匹配请求 URL 中的查询参数时，该配置中的参数是大小写敏感的。

仅当 参数设置 是 删除指定参数 或 保留指定参数 时，该配置会出现。

参数内容

表示一个或者多个键值对，代表查询参数和参数值。

键值对的格式是 key=value，多个键值对之间使用分号（;）分隔，总长度不能超过 1,024 个字符。键值对只能包含除了空格以外的可打印 ASCII 字符。例如：size=12-inch;food=pizza;type=pepperoni。

在匹配请求 URL 中的查询参数时，该配置中的参数是大小写敏感的。

仅当 参数设置 是 添加指定参数 或 重置指定参数 时，该配置会出现。

/a/bbb/image.png

^/a{1,2}.*g$ 用于匹配以 / 开头和以 g 结尾的路径。

正则表达式匹配了请求 URL 中的路径。

/food/aaa/pngs/image.png

正则表达式匹配了请求 URL 中的路径。

/aaa/bbb/image.png

aaa.* 用于匹配请求路径中的特定字符串。

正则表达式匹配了请求路径中的 aaa/bbb/image.png。

/aaa/bbb/image.png

aaa/.* 用于匹配请求路径中的特定字符串。

正则表达式匹配了请求路径中的 aaa/bbb/image.png。