最近更新时间:2022-03-17 17:10:28
本接口用于设置wcdn加速的静态内容的缓存规则。wcdn的加速域名创建后,默认都是静态内容,缓存规则为缓存一个月。
注意:
本接口请求需要包含指定目录/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"
}]
}
返回示例
为了帮您快速定位问题,WCDN将错误码集中归类,请到【使用须知】查看详情。
纯净模式