本文为您介绍如何在视频点播中对加速域名配置回源参数。
适用范围
回源参数配置适用于自定义源站加速域名。
功能介绍
配置 CDN 回源请求中包含的参数。默认情况下,CDN 在回源时,回源请求文件的 URL 中包含的参数和用户请求文件的 URL 中包含的参数是一致的。比如用户请求文件的 URL 是 http://www.example.com/volcano.png?version=1。该 URL 包含参数 version。在回源时,CDN 也会包含这个参数。
如果在您的业务场景中,这两边的参数不一致,可以配置回源参数。
说明
目前视频点播仅支持在回源时,保留所有或者删除所有 URL 参数的设置,并且对源站所有文件生效。
预设规则
回源参数配置中有一条预设规则,该条规则对所有文件生效,并且优先级始终最低。如果一个用户请求未匹配您创建的所有规则,这个用户请求就会匹配该预设规则。您无法删除这条预设规则,无法调整其优先级,也无法修改这条规则中的规则类型和规则内容。您仅可以修改该规则中的参数设置配置。
操作步骤
- 登录视频点播控制台,进入指定空间。
- 选择左侧导航栏分发加速 > 域名管理,进入域名管理页面。
- 在加速域名页签下,根据您的域名类型,在域名列表中找到您需要配置的域名。
- 单击操作列的配置按钮,进入加速域名配置页面,切换回源配置页签。
- 单击页面下方的修改配置按钮。
- 在回源参数配置区域,单击新增按钮,参照配置说明新增规则。


- 完成配置后,单击保存配置按钮。
配置说明
配置 | 说明 |
|---|
优先级 | 表示规则的优先级。当收到用户请求时,CDN 基于规则在列表中出现的顺序,依次处理规则。在处理规则时,CDN 尝试将规则与用户请求匹配。如果任意一条规则匹配了用户请求,CDN 就执行该规则中指定的操作,并停止处理其余规则。除预设规则外,您可以拖动规则调整其在列表中的出现顺序。 |
规则类型 | 表示规则中的过滤类型。该配置有以下选项: - 文件后缀:表示请求 URL 中的扩展名。
- 文件目录:表示请求路径中的某个目录。
- 文件全路径:表示请求 URL。
|
规则内容 | 表示规则的内容。内容长度不能超过 1,024 个字符,不能包含以下字符: 在匹配用户请求时,规则内容不区分大小写。
该配置的额外说明如下: - 如果 规则类型 是 文件后缀,规则内容必须是一个或者多个以分号(;)分隔的文件后缀。文件后缀无需以句点(.)开头。例如:
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 中的全部查询参数。同时,对于您在 参数内容 中指定的查询参数和参数值,CDN 会执行以下操作:
- 如果这些查询参数在用户请求 URL 中,CDN 会在回源请求 URL 中将这些查询数的值设置为您指定的值。
- 如果用户请求 URL 中不包含这些查询参数,CDN 会在回源请求 URL 中添加这些查询参数。
|
参数名称 | 表示一个或者多个查询参数,多个查询参数之间使用分号(;)分隔,总长度不能超过 1,024 个字符。查询参数只能包含字母、数字、下划线(_)、逗号(,)、短横线(-)、句点(.)和感叹号(!)。
在匹配请求 URL 中的查询参数时,该配置中的参数是大小写敏感的。
仅当 参数设置 是 删除指定参数 或 保留指定参数 时,该配置会出现。 |
参数内容 | 表示一个或者多个键值对,代表查询参数和参数值。
键值对的格式是 key=value,多个键值对之间使用分号(;)分隔,总长度不能超过 1,024 个字符。键值对只能包含除了空格以外的字符。例如:size=12-inch;food=pizza;type=pepperoni。
在匹配请求 URL 中的查询参数时,该配置中的参数是大小写敏感的。
仅当 参数设置 是 添加指定参数 或 重置指定参数 时,该配置会出现。 |