刷新预热

veImageX 通过缓存静态资源，使用户能够就近访问，达到访问加速的效果。若已经分发的内容需要更新，就需要删除节点上缓存内容。或在大型活动前，需要将资源预先推送至 CDN 节点进行缓存，此时就需要进行刷新、预热操作。

以下将为您介绍刷新和缓存的注意事项、适用场景、操作步骤等内容。

刷新缓存

资源刷新后，该资源在全网 CDN 节点上缓存的指定内容，即 URL 或目录（包括根目录），将被删除。资源删除后，当用户请求到达节点时节点会回源站拉取对应的最新资源，并缓存到节点，保证用户获取到最新资源。

适用场景

• 资源更新：如果您的源站某个页面或资源更新，为避免用户仍访问到旧的缓存资源。您可通过刷新对应资源的 URL 或目录，使用户访问最新资源并缓存至 CDN 节点；
• 资源清理：如果您的源站存在违法违规内容，由于缓存机制即使您已删除源站资源，但 CDN 节点仍存在缓存，资源仍可以被用户访问。此时您可通过刷新缓存功能更新 CDN 缓存内容。

注意事项

• 提交大批量的目录刷新后会触发大量回源请求，导致您的回源带宽增加，建议在业务低峰期进行操作或扩充源站带宽；
• 刷新任务从提交到生效，大约需要 5 分钟，若您文件或者目录配置的缓存过期时间低于 5 分钟，您无需执行刷新操作，等待文件或者目录缓存超时更新即可。

提交额度

• 单账号每日可提交的 URL 刷新额度为 2000 个；
• 单任务可提交的 URL 刷新额度为 2000 个；
• 单账号每日可提交的目录刷新额度为 50 个；
• 单任务可提交的目录刷新额度为 50 个。

操作步骤

创建任务

1. 登录 veImageX 控制台，选择资源管理，进入资源管理页面。

2. 单击刷新缓存。

3. 单击上传按钮，在弹出的输入框中设置要刷新的 URL 或目录（包含根目录）。
   可直接填写需要刷新的资源 URL 或将需要刷新的内容以每行一个的格式保存为 txt 文件中，并直接拖拽到指定位置。

   

   配置	说明
   刷新方式	刷新的类型。 URL 刷新：刷新对象是一个或者多个文件。 目录刷新：刷新对象是一个或者多个目录（包含根目录）。
   URL/目录	需要刷新的 URL。支持手动输入（您可手动输入那些需要刷新的 URL）和上传文件（您可上传一个 .txt 文本文件，该文件中包含了需要刷新的 URL）。 其中 URL 必须满足以下条件： 当 刷新类型 是 URL 刷新，您可以指定一个或者多个文件的 URL。条件如下所示： 文件 URL 必须 以 https:// 或者 http:// 开头。 刷新 URL：http://example.com/image/test/772edb133f7b 多个文件 URL 以换行分隔。 当 刷新类型 是 目录刷新，您可以指定一个或者多个目录（包含根目录）的 URL。条件如下所示： 目录 URL 必须 以 https:// 或者 http:// 开头，并且以 / 结尾。 刷新根目录下所有文件：http://example.com/ 刷新子目录/image/test/下所有文件：http://example.com/image/test/ 多个目录 URL 以换行分隔。

4. 单击确定，按钮提交刷新任务。

管理任务

veImageX 保存近 30 天内的操作记录，您可筛选历史提交的预热任务进行查看：

• 执行中：提交的任务仍在处理中，请耐心等待。
• 完成：任务已完成，全网已生效。
• 失败：任务执行遇到问题。

预热 URL

资源预热后，该资源会提前缓存到全网 CDN 节点。当您的请求到达节点时可以直接在节点获取到资源，可以降低活动或发布期间源站的下载压力。

注意事项

• 预热任务从提交到生效，大约需要 5 分钟。
• 节点预热时会回源拉取所需内容，因此当您提交大批量预热任务后，会造成源站带宽增大，建议控制提交频率或扩充源站带宽。
• 节点预热时后台会逐步处理提交的资源，由于文件大小不同则处理耗时也不一致。

适用场景

• 营销活动：营销活动开始前，使搜索引擎和 CDN 节点预热资源，以提高活动中用户的访问速度。
• 升级应用：在发布新产品软件包前，提前在 CDN 节点预热资源，以提升产品发布后的下载速度。

提交限额

• 单账号每日可提交的 URL 预热额度为 2000 个；
• 单任务可提交的 URL 预热额度为 2000 个。

操作步骤

创建任务

1. 登录 veImageX 控制台，选择资源管理，进入资源管理页面。

2. 单击 URL 预热。

3. 单击上传按钮，在弹出的输入框中设置要预热的 URL。

   您可直接填写需要预热的资源 URL 或将需要预热的内容以每行一个的格式保存为 txt 文件中，并直接拖拽到指定位置。

   

   配置	说明
   URL	需要预热的 URL。支持手动输入（您可手动输入那些需要预热的 URL）和上传文件（您可上传一个 .txt 文本文件，该文件中包含了需要预热的 URL）。 URL 必须满足以下条件： 文件 URL 必须 以 https:// 或者 http:// 开头。 预热 URL：http://example.com/image/test/772edb133f7b 多个文件 URL 以换行分隔。

   说明

   veImageX 支持添加泛域名，泛域名的刷新缓存请参考如何刷新泛域名的资源缓存。

4. 单击确定按钮，提交预热任务。

管理任务

veImageX 保存近 30 天内的操作记录，您可筛选历史提交的预热任务进行查看：

• 执行中：提交的任务仍在处理中，请耐心等待。
• 完成：任务已完成，全网已生效。
• 失败：任务执行遇到问题。

  说明

  对于预热任务，如果源站的响应状态码是 4xx 或者 5xx，则提示失败为源站问题，此时请检查您的源站是否能正常响应内容。

其他操作

开通服务后，您可通过调用 OpenAPI 的方式创建刷新预热任务，具体请参考 CreateImageContentTask。您也可以通过调用 GetImageContentTaskDetail获取刷新预热任务详情。