全部文档
当前文档

暂无内容

如果没有找到您期望的内容,请尝试其他搜索词

文档中心

设置缓存策略

最近更新时间:2021-12-16 10:22:47

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 缓存规则的内容;
当缓存规则类型为目录时,目录必须以/开头且以/结尾,允许多个输入,多个目录以逗号(半角)间隔;
当缓存规则类型为全路径时,全路径需输入完整路径,且必须以/开头;
当缓存规则为文件后缀时,允许多个输入,文件后缀必须输入文件后缀名,多个文件后缀名以逗号(半角)间隔;
当CacheRuleType的值为 exact(全路径 )时,Value可以直接输入 / 表示一个完整路径,而非一个目录;
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的具体错误原因详见【使用须知】中错误代码表说明
文档导读
纯净模式常规模式

纯净模式

点击可全屏预览文档内容
文档反馈