CDN

设置缓存策略

最近更新时间:2020-06-02 21:52:45

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/statistics/SetCacheRuleConfig 1.1 
 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",
    }]
}

金山云,开启您的云计算之旅

免费注册