/v2/buckets/cdn/cache/
设置 CDN 空间自定义缓存规则(根据 URL 设置)
请求地址
/v2/buckets/cdn/cache/
HTTP请求方法
POST
是否需要登陆授权
是,关于登录授权,参见授权机制
请求参数
必选 | 数据类型及范围 | 说明 | |
---|---|---|---|
bucket_name | true | string | 空间名 |
specific_rules | true | json | 特殊缓存规则 |
nocache_list | true | json | 不缓存列表 |
expires
缓存时间范围: 5~31536000(一年) 秒。 nocache_list
优先级高于 specific_rules
。
specific_rules
参数格式:
[
{
"uri": "*.jpg",
"expires": 3600
},
{
"uri": "/*.zip",
"expires": 7200
}
]
nocache_list
参数格式
[
{
"uri": "*.rar"
},
{
"uri": "/a/*"
}
]
uri 支持的规则说明:
支持四种类型:
- 前缀加星号,例如
*.jpg
- 后缀加星号,例如
/d/e/*
- 中间加星号,例如
/a/b/*.zip
- 不加任何星号,例如
/m/foo.png
以上规则都支持携带 querystring
, 例如:
/m/n/*?foo&bar=123
querysting
可以为正常的 key=value
格式,也可以只包含 key
。对于只有 key
的情况,我们会匹配该参数 key
所有对应的值以及值为空这种特殊情况;前一种会精确匹配。
uri
字段只支持字母数字、中文和特殊字符: * . % + - _
。每个 uri
规则只能使用一次通配符。specific_rules
和 nocache_list
的规则条数不能超过 50 条。
返回结果
{
"result": true,
"data" :
{
"bucket_name": "bucket",
"specific_rules" : [
{"uri": "*.rar", "expires": 7200}
],
"nocache_list": [
{"uri": "*.rar"}
]
}
}
Last edited by hubiao, 2016-09-27 14:21:19