全部文档
当前文档
最近更新时间：2021-12-16 10:22:47
本接口用于设置缓存规则。加速域名创建后，默认缓存规则为缓存一个月。
注意：
本接口请求需要包含指定目录/2016-09-01/domain/SetCacheRuleConfig、公共请求header和该接口所特有的请求参数，具体请求语句参照下文请求示例。
| 参数名 | 必选 | 类型及范围 | 说明 |
|---|---|---|---|
| DomainId | 是 | String | 域名ID |
| CacheRules | 是 | 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"
}]
}
返回示例
纯净模式