PreloadCaches

描述

本接口用于将源站的内容主动预热到Cache节点上，用户首次访问可直接命中缓存，缓解源站压力。

• 注意：

  • 每个 Url 必须以http:// 或者https:// 开头
  • 每个 Url 最大长度 1000 字符
  • 每个 Url 所在的域名必须是该用户在金山云加速的域名。
  • Url 如果包含中文字符，请使用urlencode方式提交。
  • 单次调用 Url 上限为1000条
  • 预热仅支持Url精确匹配，不支持目录预热，不支持正则匹配
  • 接口仅支持POST请求格式

请求语法

本接口请求需要包含指定目录/2016-09-01/content/PreloadCaches、公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。

请求参数

参数名	必选	类型及范围	说明
Urls	是	Url[]	需要预热的Url列表

Url

参数名	必选	类型及范围	说明
Url	是	String	需要提交预热的Url，单条输入

返回参数

参数名	类型及范围	说明
PreloadTaskId	String	预热返回的任务ID

示例

请求示例

POST方式：

POST /2016-09-01/content/PreloadCaches 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
Content-Type:application/json
Accept:application/json
X-Action: PreloadCaches
X-Version: 2016-09-01

{
  "Urls": [
    {
      "Url": "http://test1.ksyun.com/1.html"
    },
    {
      "Url": "http://test2.ksyun.com/2.html"
    }
  ]
}

返回示例

{
    "PreloadTaskId": "3e16f42c-e9fe-4d71-9dcc-4dd53b573a7c"
}