/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 支持的规则说明:

支持四种类型:

  1. 前缀加星号,例如 *.jpg
  2. 后缀加星号,例如 /d/e/*
  3. 中间加星号,例如 /a/b/*.zip
  4. 不加任何星号,例如 /m/foo.png

以上规则都支持携带 querystring, 例如:

/m/n/*?foo&bar=123

querysting 可以为正常的 key=value 格式,也可以只包含 key。对于只有 key 的情况,我们会匹配该参数 key 所有对应的值以及值为空这种特殊情况;前一种会精确匹配。

uri 字段只支持字母数字、中文和特殊字符: * . % + - _。每个 uri 规则只能使用一次通配符。specific_rulesnocache_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