You need to enable JavaScript to run this app.
导航
刷新预热
最近更新时间:2024.03.13 12:04:11首次发布时间:2023.03.09 17:23:38

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 不以 / 结尾。

注意

如您需要使用正则刷新能力,请提交工单联系技术支持。

  1. 单击确定,按钮提交刷新任务。

管理任务

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获取刷新预热任务详情。