刷新缓存接口

最近更新时间:2022-03-17 17:10:27

查看PDF

RefreshCaches

描述

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

  • 说明:

    • 每个ID每日设有提交刷新类请求条数限制额度,与金山云WCDN控制台、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

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

返回示例

{
    "RefreshTaskId": "7414be58-ff9f-408e-b4ad-31fa08847a33"
}

错误码

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

文档内容是否对您有帮助?

根本没帮助
文档较差
文档一般
文档不错
文档很好

在文档使用中是否遇到以下问题

内容不全,不深入
内容更新不及时
描述不清晰,比较混乱
系统或功能太复杂,缺乏足够的引导
内容冗长

更多建议

0/200

评价建议不能为空

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

问题反馈