提交文件预热任务--多云CDN-火山引擎

文档中心

导航

提交文件预热任务

最近更新时间：2024.09.11 16:30:48首次发布时间：2022.12.28 21:36:45

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

背景信息

云服务商提供文件预热功能。文件预热表示让 CDN/DCDN 节点主动从源站拉取特定文件（一般是大文件，如视频文件、安装包文件等），并将文件缓存在节点上。这样当用户请求对应文件时，CDN/DCDN 节点可以直接返回文件。该方式减少了节点从源站获取文件带来的延时，避免了用户同时请求大文件时源站下载压力过大。

在以下场景，您可能需要执行文件预热：

为新的域名开启 CDN/DCDN 服务后
执行了缓存刷新后
发布新的 App 或安装包前
发布大型运营活动前

如果您的站点同时启用了多家云服务商的加速服务，而您希望在多家云服务商平台预热特定的文件，往往您需要分别登录不同云服务商平台进行操作。多云CDN的刷新预热功能使您可以通过多云CDN统一提交文件预热任务到多家云服务商。多云CDN能够在所有云服务商中匹配待预热的文件，然后自动调用云服务商的相关接口来完成您的请求。

影响与风险

使用多云CDN提交文件预热任务会使云服务商 CDN/DCDN 节点回源获取相关文件，可能导致回源请求数、回源流量、回源带宽突增等情形发生。

使用限制

因云服务商平台的限制，您无法使用多云CDN向以下云服务商产品提交文件预热任务：
- Akamai—AMD 和 DSA
- Google Cloud—Media CDN
- AWS—CloudFront
关于多云CDN支持的云服务商产品的范围，请参见使用限制。
不同云服务商产品对每日可执行的预热任务数量有限制。您通过多云CDN向指定云服务商产品提交的文件预热任务，不能超出对应限制。
文件预热仅支持按 URL 缓存特定的文件，不支持按目录缓存文件夹下的所有文件。

前提条件

您已经将云服务商账号添加到多云CDN，并且云服务商账号满足以下全部条件：
- 拥有云服务商产品中以下接口的使用权限：创建文件预热任务。更多信息，请参见云服务商账号授权。
- 未启用 只读访问 模式。更多信息，请参见管理云服务商账号。
您的加速域名已经通过云服务商账号同步到多云CDN。更多信息，请参见数据同步。

操作步骤

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

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

配置说明

说明

云服务商平台针对 URL 预热限制了任务配额。您可以在 配额管理 标签页了解具体的配额。

alt

配置项说明

配置项	说明
下发方式	为预热任务选择一种提交方式。可选项：默认：表示向所有相关的云服务商提交预热任务。多云CDN会根据 URL 自动匹配云服务商，向匹配到的云服务商都提交预热任务。关于具体的匹配规则，请参见任务提交说明。指定云服务商：表示指定一个或多个云服务商，只向指定的云服务商提交预热任务。
URL	设置要缓存的 URL 列表。URL 列表包含待缓存的文件。您可以通过以下方式之一进行设置：手动输入：输入一个或多个 URL。输入要求如下： URL 必须以 `http://` 或者 `https://` 开头。每行输入一个 URL。上传文件：选择一个包含 URL 列表的本地 TXT 文件进行上传。 TXT 文件中的 URL 列表也必须按照手动输入中的要求进行设置。否则，文件将会上传失败。当 URL 中指定的 URL 数量超过 500 时，多云CDN将按照每个任务 200 个 URL，自动拆分出多个任务。

下发方式

为预热任务选择一种提交方式。可选项：

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

URL

设置要缓存的 URL 列表。URL 列表包含待缓存的文件。您可以通过以下方式之一进行设置：

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

当 URL 中指定的 URL 数量超过 500 时，多云CDN将按照每个任务 200 个 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。