你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn。
Azure 内容分发网络标准规则引擎中的操作
重要
Microsoft Azure CDN Standard(经典版)将于 2027 年 9 月 30 日停用。 为了避免任何服务中断,请务必在 2027 年 9 月 30 日之前将 Microsoft Azure CDN Standard(经典版)配置文件迁移到 Azure Front Door Standard 层或 Premium 层。 有关详细信息,请参阅 Microsoft Azure CDN Standard(经典版)停用。
Edgio 的 Azure CDN 将于 2025 年 11 月 4 日停用。 为了避免服务中断,必须在此日期之前将工作负载迁移到 Azure Front Door。 有关详细信息,请参阅 Edgio 的 Azure CDN 停用常见问题解答。
在 Azure 内容分发网络标准规则引擎中,规则由一个或多个匹配条件和一个操作组成。 本文将详细介绍可在 Azure 内容分发网络标准规则引擎中使用的操作。
规则的第二部分是一个操作。 操作定义了要应用于某个匹配条件或匹配条件集所识别的请求类型的行为。
操作
可在 Azure 内容分发网络标准规则引擎中使用以下操作。
缓存到期
根据规则匹配条件指定的请求,使用此操作来覆盖终结点的生存时间 (TTL) 值。
Required fields
缓存行为 | 说明 |
---|---|
绕过缓存 | 如果选择此选项并且规则匹配,则不对内容进行缓存。 |
替代 | 如果选择此选项并且规则匹配,则从原点返回的 TTL 值会被该操作中指定的值覆盖。 仅当响应可缓存时才会应用此行为。 cache-control 响应头的值为“no-cache”、“private”、“no-store”时,操作将不适用。 |
缺少时设置 | 如果选择此选项并且规则匹配,而没有 TTL 值从原点返回,那么规则会将 TTL 设置为被该操作中指定的值。 仅当响应可缓存时才会应用此行为。 cache-control 响应头的值为“no-cache”、“private”、“no-store”时,操作将不适用。 |
其他字段
天 | 小时 | 分钟数 | 秒 |
---|---|---|---|
int | int | int | int |
缓存键查询字符串
使用此操作来根据查询字符串修改缓存键。
Required fields
行为 | 说明 |
---|---|
包括 | 如果选择此选项并且规则匹配,则在生成缓存键时将包含参数中指定的查询字符串。 |
缓存每个唯一的 URL | 如果选择此选项并且规则匹配,则每个唯一 URL 都有其自己的缓存键。 |
Exclude | 如果选择此选项并且规则匹配,则在生成缓存键时将排除参数中指定的查询字符串。 |
忽略查询字符串 | 如果选择此选项并且规则匹配,则在生成缓存键时不考虑查询字符串。 |
修改请求标头
使用此操作可以修改发送到源的请求中提供的标头。
Required fields
操作 | HTTP 标头名称 | 值 |
---|---|---|
附加 | 如果选择此选项并且规则匹配,则会将“标头名称”中指定的标头添加到请求并使用指定的值。 如果该标头已存在,则会将该值追加到现有值后面。 | 字符串 |
Overwrite | 如果选择此选项并且规则匹配,则会将“标头名称”中指定的标头添加到请求并使用指定的值。 如果该标头已存在,则指定的值将替代现有值。 | 字符串 |
删除 | 如果选择此选项,规则匹配,并且在规则中指定的标头存在,则会从请求中删除该标头。 | 字符串 |
修改响应标头
使用此操作可以修改返回给客户端的响应中提供的标头。
Required fields
操作 | HTTP 标头名称 | 值 |
---|---|---|
附加 | 如果选择此选项并且规则匹配,则会将“标头名称”中指定的标头添加到响应并使用指定的“值” 。 如果该标头已存在,则会将该“值”追加到现有值后面。 | 字符串 |
Overwrite | 如果选择此选项并且规则匹配,则会将“标头名称”中指定的标头添加到响应并使用指定的“值” 。 如果该标头已存在,则该“值”将替代现有值。 | 字符串 |
删除 | 如果选择此选项,规则匹配,并且在规则中指定的标头已存在,则会从响应中删除该标头。 | 字符串 |
URL 重定向
使用此操作可将客户端重定向到一个新 URL。
Required fields
字段 | 描述 |
---|---|
类型 | 选择要返回给请求方的响应类型:“已找到”(302)、“已移动”(301)、“临时重定向”(307) 和“永久重定向”(308)。 |
协议 | 匹配请求、HTTP、HTTPS。 |
主机名 | 选择要将请求重定向到的主机名。 留空会保留传入主机。 |
路径 | 定义要在重定向中使用的路径。 留空会保留传入路径。 |
查询字符串 | 定义重定向中使用的查询字符串。 留空会保留传入的查询字符串。 片段 | 定义要在重定向中使用的片段。 留空会保留传入片段。
强烈建议使用绝对 URL。 使用相对 URL 可能会将 Azure 内容分发网络 URL 重定向到无效的路径。
URL 重写
使用此操作可以重写路由到源的请求的路径。
Required fields
字段 | 说明 |
---|---|
源模式 | 定义要替换的 URL 路径中的源模式。 若要匹配所有 URL 路径,请使用正斜杠(/)作为源模式值。 |
目标 | 定义要在重写中使用的目标路径。 目标路径会覆盖源模式。 |
暂留不匹配的路径 | 如果设置为“是”,则会将源模式后面的剩余路径追加到新的目标路径。 |