最近更新时间:2024.01.16 16:27:00
首次发布时间:2024.01.16 16:27:00
本文档介绍火山引擎内容分发网络中用户请求的自定义拦截功能。
该功能使您可以对请求路径和查询参数设置匹配条件,并对匹配的请求设置拦截方式。拦截的方式包括重定向以及 4xx 响应状态码。
登录 火山引擎内容分发网络控制台。
在左侧导航栏,点击 域名管理。
在 域名管理 页面,找到需要配置的域名,点击 管理。 页面上方的筛选条件和搜索框可以帮助您快速找到要配置的域名。
在域名页面上,点击 访问控制 页签。
在页面右上方,点击 编辑配置。
在 自定义拦截规则 下方,设置 状态 为 开启。
点击 添加规则。您最多可以创建 10 条规则。
在 编辑规则 页面,根据 配置说明 进行设置。
设置完成后, 在页面右上角点击 提交编辑。
说明
关于以下配置的内容输入要求,参见 配置输入要求。
配置 | 说明 |
---|---|
优先级 | 表示规则的优先级。数字 1 的规则优先级最高。在收到请求时,内容分发网络按规则的优先级,从高到低尝试将请求与规则匹配。如果请求匹配了某一条规则,内容分发网络就停止匹配其余规则。您可以通过拖拽调整规则的优先级。 |
规则名称 | 表示规则的名称。 |
生效对象 | 表示一个或者多个匹配条件,用以匹配请求 URL 中的路径或查询参数。点击 添加 创建一个匹配条件,您最多可以创建 5 个匹配条件。如果您不添加任何匹配条件,表示拦截所有请求。匹配方法是精确匹配,但是匹配时内容是否是大小写敏感的取决于您的设置。
|
拦截方式 | 表示内容分发网络如何拦截已匹配的请求。该配置的可选值有:
如果您计划创建多条规则,每条规则中指定的拦截方式必须相同。 |
拦截方式为 4xx 错误 时,您可以设置以下额外配置:
配置 | 说明 |
---|---|
响应状态码 | 表示对于拦截的请求,内容分发网络的响应状态码。您需要设置一个 400-499 范围内的错误码,例如 405 。 |
响应 Body | 表示响应正文中包含的内容。该配置有以下选项:
|
拦截方式为 重定向 时,您可以设置以下额外配置:
配置 | 说明 |
---|---|
响应状态码 | 表示对于拦截的请求,内容分发网络的响应状态码。您可以设置 301 或者 302。 |
Location | 表示一个重定向 URL。URL 必须以 http:// 或 https:// 开头。 |
配置 | 说明 |
---|---|
规则名称 | 长度不超过 20 个字符,可以包含字母、数字、下划线(_)、中划线(-)、汉字。一个汉字占 3 个字符。 |
生效对象 |
|
Location | 长度不能超过 1,024 个字符。 |