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
}