RefreshCaches

描述

本接口用于刷新节点上的文件内容。刷新指定URL内容至Cache节点，支持URL、目录批量刷新。

说明：
- 每个ID每日设有提交刷新类请求条数限制额度，与金山云CDN控制台共享此额度，具体额度可查看控制台或调用GetRefreshOrPreloadQuota接口获取
- 刷新预热类接口包含 RefreshCaches刷新接口和PreloadCaches 预热接口
- Files与Dirs必须至少指定一种，可同时指定，即文件刷新和目录刷新可同时进行
注意：
- 每个 Url 必须以http:// 或者https:// 开头
- 每个 Url 最大长度 1000 字符
- 每个 Url 所在的域名必须是该用户在金山云加速的域名。
- Url 如果包含中文字符，请使用urlencode方式提交。
- 单次调用文件类刷新 Url上限为1000条，目录类刷新 Url 上限为30条
- 支持Url及目录精确匹配，不支持正则匹配
- 接口仅支持POST请求格式

请求语法

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

请求参数

参数名	必选	类型及范围	说明
Files	否	Url[]	需要文件类型刷新的Url列表
Dirs	否	Url[]	需要目录类型刷新的Url列表

Url

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

返回参数

参数名	类型及范围	说明
RefreshTaskId	String	刷新返回的任务ID

示例

请求示例

POST方式：

POST /2016-09-01/content/RefreshCaches 1.1
Host: cdn.api.ksyun.com
X-Amz-Date: date
Authorization:authorization string
x-action: RefreshCaches
x-version: 2016-09-01
Content-Type:application/json
Accept:application/json
{
  "Files": [
    {
      "Url": "http://test.dxz.ksyun.8686c.com/abc.txt"
    },
    {
      "Url": "http://test.dxz.ksyun.8686c.com/test"
    }
  ],
  "Dirs": [
    {
      "Url": "http://test.dxz.ksyun.8686c.com/abc"
    },
    {
      "Url": "http://test.dxz.ksyun.8686c.com/def"
    }
  ]
}

返回示例

{
 "RefreshTaskId": "1e16f42c-e9fe-4d71-9dcc-4dd33b523a7c"
}

文档导读

上一篇：查询屏蔽URL剩余量接口

下一篇：预热缓存接口

纯净模式常规模式

纯净模式

点击可全屏预览文档内容