设置缓存策略

最近更新时间:2020-10-30 18:59:16

查看PDF

SetCacheRuleConfig

描述

本接口用于设置缓存规则。加速域名创建后,默认缓存规则为空

注意:

  • 更新加速域名的缓存规则为覆盖更新,需要对全部的规则进行修改,不能仅提交需要修改的部分。
  • 区别于不缓存,若设置缓存0秒,cdn会存储内容,在下一次收到用户访问时,cdn会发起If-Modified-Since回源校验,根据源站响应的 Last-Modified 来判断源站内容是否变化。
    A、若检验内容有变化,则cdn从源站拿到实际请求内容,返回给用户 ;
    B、若检验内容没有变化,则源站响应304,cdn将本地存储的内容返回给用户。(若您的源站不能正确支持If-Modified-Since校验,则cdn可能会将旧的内容返回用户)

请求语法

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

请求参数

参数名 必选 类型及范围 说明
DomainId String 域名ID
CacheRules CacheRule[] 由CacheRule组成的数组,表示缓存规则列表。注意:该数组是有序的,优先级按照数组的输入顺序排序,即第一个输入的数组则为最高优先级。

CacheRule

参数名 必选 类型及范围 说明
CacheRuleType String 缓存规则类型,具体枚举类型表见使用须知
Value String 缓存规则的内容。当缓存规则类型为目录时,仅允许单条输入,目录必须以/开头且以/结尾;当缓存规则类型为全路径时,仅允许单条输入,全路径需输入完整路径,且必须以/开头;当缓存规则为文件后缀时,允许多个输入,文件后缀必须输入文件后缀名,多个文件后缀名以逗号(半角)间隔
CacheEnable String 配置缓存功能的开启或关闭,对应缓存/不缓存 取值:on、off ,默认为on 。配置on时,下面 CacheTime 为必选项,RespectOrigin为可选项;配置off时,下面 CacheTime 、RespectOrigin都为不可选项
CacheTime Long 缓存时间,以秒为单位。当CacheEnable = on时,为必选项
RespectOrigin String 是否遵循源站,off表示不遵循,on(默认)表示遵循

示例

请求示例

POST方式:

 POST /2016-09-01/domain/SetCacheRuleConfig
 Host: cdn.api.ksyun.com
 X-Amz-Date: date 
 Authorization:authorization string 
 x-action: SetCacheRuleConfig 
 x-version: 2016-09-01 
 Content-Type: application/json

{
    "DomainId":"2D09XC0",
    "CacheRules":
    [{
         "CacheRuleType":"directory",
            "Value":"/XXX/",
            "CacheTime":11,
            "RespectOrigin":"",
            "CacheEnable":"on"
    },
    {
          "CacheRuleType":"exact",
            "Value":"/XXX/XXX.TXT",
            "CacheEnable":"off"
    }]
}

返回示例

  • 说明:本接口调用成功只会返回200的状态码,无返回值,若调用失败,则会返回403/400状态码,400的具体错误原因详见【使用须知】中错误代码表说明

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

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

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

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

更多建议

0/200

评价建议不能为空

提交成功!

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

问题反馈