文件预取
更新时间：2021-06-09 16:22:33
概述
域名启用CDN后，初始状态下，全网 CDN 加速节点上无任何域名资源缓存，节点缓存行为由用户请求触发，当用户请求至 CDN 加速节点时，节点上若无缓存资源或缓存资源已过期，则回源至 CDN 中间层节点获取，若中间层仍无缓存或资源已过期，则回源至用户源站进行拉取。
CDN提供文件预取功能，可以将源站的内容主动预取到CDN节点，使用户首次访问可直接命中缓存，既提升首次访问速度，又能有效缓解源站压力。
适用场景：
-
安装包发布
新版本安装包或是升级包发布前，提前将资源预热至 CDN 加速节点。正式上线后，海量用户的下载请求将直接由全球加速节点响应，提升下载速度的同时，大幅度降低源站压力。 -
运营活动
运营活动发布前，提前将活动页涉及到的静态资源预热至 CDN 加速节点。活动开始后，用户访问中所有静态资源均由加速节点响应，海量带宽储备保障用户服务可用性，提升用户体验。
操作说明
创建文件预取任务
-
登录网宿科技控制台，通过左侧导航栏进入产品与服务-应用与服务，点击【内容管理】进入【文件预取】>【任务创建】
-
根据页面提示信息输入要预取到CDN节点的URL集合，URL格式说明如下：
- 每个URL所在的域名须是在网宿加速的域名且有预取权限，域名预取权限可联系技术支持人员配置。
- 每行请只输入一个URL，多个URL请换行（一次性提交的URL限额为500条）。
- URL须携带’http://’ 或 ‘https://’ 协议标识，且为具体的URL，不支持正则与目录。输入示例：http://www.a.com/image/test.png。
- 每个URL最大长度为 2000 字符。
- URL中如果包含中文字符，则提交的URL需是中文转义后的URL（采用UTF-8方式转义）。
- 每个账号默认每日预取URL限额为20000条，预取空间总限额为5000M（账号粒度可调，可联系技术支持人员调整）。
-
根据需要选择是否清楚CDN缓存后再预取：
选择“是”，则先清除全部启动预取任务的节点上的缓存，再回源获取新文件
选择“否”，则仅当启动预取任务的节点上没有最新缓存，才回源获取新文件
-
预取时间：文件预取支持即时预取和预约预取。
预约预取可预设任务开始时间，当到预设日期时间时自动执行推送
任务查询
单击【文件预取】>【任务查询】，可指定时间周期、关键字进行预热任务查询，支持指定域名查询，或指定完整的 URL 进行查询：
- 任务状态：
| 状态 | 含义 |
|---|---|
| init | 表示文件预取的任务初始化中 |
| run | 表示文件预取的任务正在执行中 |
| success | 表示文件预取的任务执行成功 |
| wait | 表示文件预取的任务正在排队中 |
| failure | 表示文件预取的任务执行失败 |
| cancel | 指该文件预取被取消（由于您的后续的操作导致前面的有关的操作被取消，如12点10分有一次预取操作，文件处于wait和run状态，12点12分又预取一个同名文件，则前一个文件的状态将被置为cancel） |
- 错误信息：
| 类型 | 含义 |
|---|---|
| 正常 | 预取任务运行正常 |
| 运行异常 | 预取任务运行异常 |
- 查询时间：可查询最近七天的预取任务
使用统计
单击【文件预取】>【使用统计】，可指定时间周期、产品进行预取任务使用情况统计，可查近一年内的数据：
- 查询时间：所选时间跨度不能超过31天
注意事项
预取限制
- 每个URL所在的域名须是在网宿加速的域名且有预取权限，域名预取权限可联系技术支持人员配置。
- 每行请只输入一个URL，多个URL请换行（一次性提交的URL限额为500条）。
- URL须携带’http://’ 或 ‘https://’ 协议标识，且为具体的URL，不支持正则与目录。输入示例：http://www.a.com/image/test.png。
- 每个URL最大长度为 2000 字符。
- URL中如果包含中文字符，则提交的URL需是中文转义后的URL（采用UTF-8方式转义）。
- 每个账号默认每日预取URL限额为20000条，预取空间总限额为5000M（账号粒度可调，可联系技术支持人员调整）。
子用户权限配置
- 预热 URL、查询预热记录目前已经接入最新的权限系统，支持资源（域名）维度权限配置。
- 分配方式请参见 权限配置说明。