SetCacheRuleConfig

描述

本接口用于设置缓存规则。加速域名创建后，默认缓存规则为缓存一个月。

注意：

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

请求语法

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

请求参数

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

CacheRule

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

示例

请求示例

POST方式：

 POST /V3/SetCacheRuleConfig
 Host: cdn.api.ksyun.com
 X-Amz-Date: date 
 Authorization:authorization string 
 x-action: SetCacheRuleConfig 
 x-version: V3
 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的具体错误原因详见【使用须知】中错误代码表说明

文档导读

上一篇：查询域名详细配置信息

下一篇：设置过滤参数

纯净模式常规模式

纯净模式

点击可全屏预览文档内容