优先级

表示规则的优先级。当收到用户请求时，CDN 基于规则在列表中出现的顺序，依次处理规则。在处理规则时，CDN 尝试将规则与用户请求匹配。如果任意一条规则匹配了用户请求，CDN 就执行该规则中指定的操作，并停止处理其余规则。您可以拖动规则调整规则在列表中的出现顺序。

规则类型

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

• 文件后缀：表示请求 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 个字符。键值对只能包含除了空格以外的字符。例如：size=12-inch;food=pizza;type=pepperoni。

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

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

/a/bbb/image.png

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

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

/aaa/bbb/image.png

/a{1,2}.*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。