提交缓存刷新任务--多云CDN-火山引擎

文档中心

导航

提交缓存刷新任务

最近更新时间：2024.12.11 10:54:12首次发布时间：2022.06.07 21:18:33

您可以使用多云CDN的刷新预热功能，统一向云服务商（包含多云CDN内置的CDN加速服务、第三方云服务商加速产品）提交缓存刷新任务。只需提交一次任务，便可在所有云服务商平台上对特定文件进行刷新。该方式帮助您提升加速类服务日常运维的效率。

背景信息

CDN/DCDN 节点通过缓存站点资源，使用户能够就近访问内容，以此来达到内容加速分发的目的。如果已经分发的内容发生更新，则您需要删除掉节点已缓存内容，避免用户获取过时的内容。云服务商提供缓存刷新功能。缓存刷新表示在 CDN/DCDN 节点上删除已经缓存的指定内容或将其标记为已过期。这样当用户下次访问节点获取内容时，节点将从源站拉取最新的内容，返回给用户并进行缓存。

如果您的站点同时启用了多家云服务商的加速服务，而您希望在多家云服务商平台刷新特定的文件，往往您需要分别登录不同云服务商平台进行操作。多云CDN的刷新预热功能使您可以通过多云CDN统一提交缓存刷新任务到多家云服务商平台。

影响与风险

使用多云CDN提交缓存刷新任务会使云服务商平台中的节点缓存失效。用户请求会触发云服务商的 CDN/DCDN 节点回源获取最新文件，可能导致回源请求数、回源流量、回源带宽突增等情形发生。

使用限制

多云CDN默认不允许您提交对站点根目录的刷新请求。如有相关需求，请提交工单。
您可以使用多云CDN向多云CDN能够接入的所有云服务商产品（包含 CDN、DCDN 等）提交缓存刷新任务。关于云服务商产品的范围，请参见使用限制。
不同云服务商产品对每日可执行的刷新任务数量有限制。您通过多云CDN向指定云服务商产品提交的缓存刷新任务，不能超出对应限制。
对于（多云CDN内置的）CDN加速服务，账号每日刷新配额如下：
- 如果您刷新的是 URL，您每天最多可以刷新 1,000 个 URL。每个刷新任务中最多可以包含 100 个 URL。
- 如果您刷新的是目录，您每天最多可以刷新 50 个目录。
说明
刷新配额是主账号和子账号共用的。

前提条件

要向（多云CDN内置的）CDN加速服务提交刷新请求：
您已经添加域名到CDN加速服务。相关操作，请参见添加域名。
要向第三方云服务商加速产品提交刷新请求：
- 您已经将云服务商账号添加到多云CDN，并且云服务商账号满足以下全部条件：
  - 拥有云服务商产品中以下接口的使用权限：创建缓存刷新任务。更多信息，请参见云服务商账号授权。
  - 未启用 只读访问 模式。更多信息，请参见管理云服务商账号。
- 第三方加速域名已经通过云服务商账号同步到多云CDN。更多信息，请参见数据同步。

操作步骤

登录多云CDN控制台。
在左侧导航栏，单击 刷新预热。
单击 缓存刷新 页签。
根据配置说明完成刷新任务设置。
单击提交。

提交刷新任务后，您可以前往 操作记录 页面，查询刷新任务在不同云服务商平台的提交状态。相关操作，请参见查看操作记录。

配置说明

配置项说明

配置项	说明
刷新类型	选择一种刷新方式。可选项： URL刷新：表示按 URL 刷新特定的文件。目录刷新：表示按目录刷新文件夹下的所有文件。说明云服务商平台针对不同刷新方式限制了任务配额。您可以在配额管理标签页了解具体的配额。
下发方式	为刷新任务选择一种提交方式。可选项：默认：表示向所有相关的云服务商提交刷新任务。多云CDN会根据 URL 自动匹配云服务商，向匹配到的云服务商都提交刷新任务。关于具体的匹配规则，请参见任务提交说明。指定云服务商：表示指定一个或多个云服务商，只向指定的云服务商提交刷新任务。
URL列表	设置要刷新的 URL 列表。URL 列表包含待刷新的站点文件或目录。您可以通过以下方式之一进行设置：手动输入：输入一个或多个 URL。输入要求如下： URL 必须以 `http://` 或者 `https://` 开头。如果刷新类型为目录刷新，则 URL 必须以斜杠（/）结尾。每行输入一个 URL。上传文件：选择一个包含 URL 列表的本地 TXT 文件进行上传。 TXT 文件中的 URL 列表也必须按照手动输入中的要求进行设置。否则，文件将会上传失败。在以下情形，多云CDN会自动拆分任务： URL刷新：当 URL列表中指定的 URL 数量超过 1000 时，多云CDN将按照每个任务 200 个 URL，自动拆分出多个任务。目录刷新：当 URL列表中指定的 URL 数量超过 20 时，多云CDN将按照每个任务 20 个 URL，自动拆分出多个任务。

刷新类型

选择一种刷新方式。可选项：

URL刷新：表示按 URL 刷新特定的文件。
目录刷新：表示按目录刷新文件夹下的所有文件。

说明

云服务商平台针对不同刷新方式限制了任务配额。您可以在 配额管理 标签页了解具体的配额。

alt

下发方式

为刷新任务选择一种提交方式。可选项：

默认：表示向所有相关的云服务商提交刷新任务。
多云CDN会根据 URL 自动匹配云服务商，向匹配到的云服务商都提交刷新任务。关于具体的匹配规则，请参见任务提交说明。
指定云服务商：表示指定一个或多个云服务商，只向指定的云服务商提交刷新任务。

URL列表

设置要刷新的 URL 列表。URL 列表包含待刷新的站点文件或目录。您可以通过以下方式之一进行设置：

手动输入：输入一个或多个 URL。输入要求如下：
- URL 必须以 http:// 或者 https:// 开头。
- 如果 刷新类型 为 目录刷新，则 URL 必须以斜杠（/）结尾。
- 每行输入一个 URL。
上传文件：选择一个包含 URL 列表的本地 TXT 文件进行上传。
TXT 文件中的 URL 列表也必须按照 手动输入 中的要求进行设置。否则，文件将会上传失败。

在以下情形，多云CDN会自动拆分任务：

URL刷新：当 URL列表 中指定的 URL 数量超过 1000 时，多云CDN将按照每个任务 200 个 URL，自动拆分出多个任务。
目录刷新：当 URL列表 中指定的 URL 数量超过 20 时，多云CDN将按照每个任务 20 个 URL，自动拆分出多个任务。

任务提交说明

如果您将 下发方式 设置为默认，那么多云CDN会按照您提供的 URL列表 自动匹配所有相关的云服务商，并向匹配到的所有云服务商都提交刷新/预热请求。

以一个 URL 为例，多云CDN首先提取 URL 中的域名，然后将该域名与多云CDN中的加速域名列表进行匹配。对于匹配到的加速域名，多云CDN向该加速域名所属的云服务商产品（如火山引擎 CDN、阿里云 DCDN等）提交刷新/预热请求。

您指定的 URL 必须满足以下要求，才能确保任务提交成功：

URL 中的域名必须是多云CDN中的某个加速域名。
URL 中的域名必须是任务提交给的云服务商产品中的某个加速域名。

示例

假设您分别从云服务商 A 和 B 的 CDN 同步了以下加速域名到多云CDN：

云服务商 A：a.example.com 和 mcdn.example.com
云服务商 B：b.example.com 和 mcdn.example.com

那么，

如果 下发方式 为默认，URL 为 http://mcdn.example.com/home/intro.video，多云CDN会向云服务商 A 和 B 提交对 http://mcdn.example.com/home/intro.video 的刷新请求。
如果 下发方式 为默认，URL 为 http://a.example.com/home/intro.video 和 http://b.example.com/home/intro.video，多云CDN会按如下方式提交任务：
- 向云服务商 A 提交对 http://a.example.com/home/intro.video 的刷新请求。
- 向云服务商 B 提交对 http://b.example.com/home/intro.video 的刷新请求。
如果 下发方式 为 指定云服务商 且 下发云服务商 为 A，URL 中将不允许出现 b.example.com 下的文件，否则多云CDN无法提交任务。这是因为云服务商 A 的 CDN 中没有加速域名 b.example.com。