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
X-Action: PreloadCaches
X-Version: 2016-09-01

{
    "Urls": [
        {
            "Url": "http://wcdn-20220304-1.ksc-test.com/abc.txt"
        },
        {
            "Url": "http://wcdn-20220304-1.ksc-test.com/test"
        }
    ]
}

返回示例

{
    "PreloadTaskId": "8108f920-088d-468d-b093-dbbe94dc1c7c"
}

错误码

为了帮您快速定位问题，WCDN将错误码集中归类，请到【使用须知】查看详情。