你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站，请访问 https://docs.azure.cn。

使用 Azure CLI 在 Azure Front Door 中清除缓存

Azure Front Door 会缓存资产，直到其生存时间 (TTL) 过期。 当客户端请求 TTL 过期的资产时，Azure Front Door 将检索该资产的新副本，处理该请求，并更新缓存。

为了确保用户始终能获得最新的资产，请围绕每次更新对资产进行版本控制，并使用新 URL 发布这些资产。 Azure Front Door 将提取新资产，以应对后续客户端请求。 有时，可能需要清除所有边缘节点的缓存内容，以强制它们检索更新后的资产。 当对应用程序进行更新或需要更正不正确的信息时，此操作非常有用。

先决条件

• 在 Azure Cloud Shell 中使用 Bash 环境。 有关详细信息，请参阅 Azure Cloud Shell 中的 Bash 快速入门。

  

• 如需在本地运行 CLI 参考命令，请安装 Azure CLI。 如果在 Windows 或 macOS 上运行，请考虑在 Docker 容器中运行 Azure CLI。 有关详细信息，请参阅如何在 Docker 容器中运行 Azure CLI。

  • 如果使用的是本地安装，请使用 az login 命令登录到 Azure CLI。 若要完成身份验证过程，请遵循终端中显示的步骤。 有关其他登录选项，请参阅使用 Azure CLI 登录。

  • 出现提示时，请在首次使用时安装 Azure CLI 扩展。 有关扩展详细信息，请参阅使用 Azure CLI 的扩展。

  • 运行 az version 以查找安装的版本和依赖库。 若要升级到最新版本，请运行 az upgrade。

• 查看使用 Azure Front Door 进行缓存以了解缓存的工作原理。
• 确保有一个功能运行的 Azure Front Door 配置文件。 请参阅创建 Azure Front Door - CLI，了解如何创建一个实例。

配置缓存清除

使用必要的参数运行 az afd endpoint purge：

• 资源组名称
• 资源组中的 Azure Front Door 配置文件名称
• 包含待清除资产的终结点
• 包含待清除资产的域/子域

重要

不支持针对通配符域的缓存清除。 请为通配符域指定要进行缓存清除的子域。 可以针对通配符域添加多个单级子域。 例如，对于通配符域 *.afdxgatest.azfdtest.xyz，可以添加 contoso.afdxgatest.azfdtest.xyz 或 cart.afdxgatest.azfdtest.xyz 等子域。 有关详细信息，请参阅 Azure Front Door 中的通配符域。

• 待清除内容的路径：
  • 支持的格式：
    • 单一路径清除 - 指定资产的完整路径（不带协议和域，但包含文件扩展名），例如 /pictures/strasbourg.png。
    • 根域清除：清除路径中具有“/*”的终结点的根。

az afd endpoint purge \
    --resource-group myRGFD \
    --profile-name contosoafd \
    --endpoint-name myendpoint \
    --domains www.contoso.com \
    --content-paths '/scripts/*'

Azure Front Door 配置文件上的缓存清除不区分大小写且与查询字符串无关，这意味着清除一个 URL 时会清除其所有查询字符串变体。

注意

缓存清除最长可能需要 10 分钟才能传播到整个网络以及所有边缘位置。

后续步骤

若要继续，请了解如何创建 Azure Front Door 配置文件。