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

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

刷新缓存

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

适用场景

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

注意事项

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

提交额度

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

操作步骤

创建任务

1. 登录 veImageX 控制台，进入刷新预热禁用页面。

2. 在刷新缓存页签，单击上传按钮，在弹出的输入框中设置要刷新的 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 以换行分隔。 注意 您在开启前缀刷新开关后，所需要填写的目录 URL 不以 / 结尾。

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

管理任务

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

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

预热 URL

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

注意事项

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

适用场景

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

提交限额

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

操作步骤

创建任务

1. 登录 veImageX 控制台，进入刷新预热禁用页面。

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

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

   

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

   说明

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

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

管理任务

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

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

  说明

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

其他操作

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