url预热

描述

用户希望首次访问某个对象时，就能从从边缘节点获取数据，而不要从源站拉取

请求语法

PUT /domain/${domain-name}?prehot&fetchOption=${fetchOption}&isRange=${isRange} HTTP/1.1
HOST: cdn.netease.com
Date: ${date}
Accept: application/json
Authorization: ${signature}

{
    "urls":[
      "http://${domain_name}/${objectName1}",
      "https://${domain_name}/${objectName2}"
    ]
}
参数及头部描述是否必须
fetchOption预取方式，类型string,取值”Y”只预取（default）,”N”非只预取NO
isRange本次提交的任务是否要只预取range段，类型int,0表示预取完整的文件(default),1表示是只预取文件前面的range段，不预取完整文件,默认只预取0~512KB的大小NO
domain_name域名，必须为domain_id对应的域名，否者报错YES
objectName对象名，不支持目录的形式YES

注

  • urls的个数一次最多400条，不能不存在urls，如果不存在urls，那么将报错
  • 一天可以预热的个数默认为1000，如果需要更多的资源，通过其他的接口设置
  • urls中重复的地址会被合并，是否重复的判断使用字符串的equals来判断，区分大小写
  • url必须为以http或https开头，而且host必须为加速域名，否者会因为域名不匹配而失败

只预取

不管节点是否有缓存要预取的文件，都将文件预取并缓存到节点。即只有当要预取的文件在CDN节点上不存在或缓存已过期，CDN节点才会回源获取文件。

非只预取

先清理节点要预取文件的缓存，再将文件预取到节点。即不管要预取的文件在CDN节点上是否有缓存或是否过期，CDN节点都会回源获取文件。

3.响应语法

如果请求成功，返回无body，内容如下

HTTP/1.1 202 Accept
Content-Type: application/json;charset=utf-8
Date: ${date}
x-ncdn-request-id: ${x-ncdn-request-id}


{
  "prehot-id":1000
}