SetHttpCodeCacheRuleConfig

描述

本接口用于设置 CDN 域名的 HTTP 状态码缓存配置策略。配置规则自上至下生效，请注意配置顺序。

请求语法

本接口请求需要包含指定目录 /V3/SetHttpCodeCacheRuleConfig、公共请求 Header 和接口所特有的请求参数，具体请求语句参照下文请求示例。请求头需携带 X-VERSION 、 X-ACTION。

请求参数

参数名	必选	类型及范围	说明
Domain	是	String	域名
HttpCodeCacheRules	否	Object[]	状态码缓存规则列表，配置规则自上至下生效。

HttpCodeCacheRules 子参数

参数名	必选	类型及范围	说明
HttpCodeCacheRuleType	是	String	可选值：file_suffix/directory/exact/url_regex `file_suffix`：按文件后缀匹配，Value值允许多条，英文后缀名，逗号分隔，如 `jpg,png`；每段须字母数字且非纯数字 `directory`：按目录匹配，Value值仅单条，须以 `/` 开头且 `/` 结尾，如 `/a/b/` `exact`：按完整路径匹配，Value值仅单条，完整路径且须以 `/` 开头,如 `/a/b/c.html` `url_regex`：按正则表达式匹配，Value值仅单条，标准正则表达式
Value	是	String	规则匹配值，按类型校验： `file_suffix`：逗号分隔，每段须匹配 `([a-zA-Z0-9])+`，且不能是纯数字`directory`：须匹配 `/((([^/?"<>\ ])+/))` — 以/开头以/结尾 `exact`：须匹配 `/(((([^/?"<>\ ])+/))(([^/*?"<>\ ])+)` 或裸 `/url_regex`：不做正则校验，任意值通过
HttpCode	是	String	需要缓存的状态码，支持录入范围是 300、301、302、307和400-999。支持填写多个，使用逗号分隔。支持区间设置，类似400-500代表缓存状态码在400到500间的值。3XX状态码缓存仅在未开启回源跳转跟随时生效。
CacheTime	是	Long	缓存时间，单位秒，RespectOrigin=on时可选(默认60)；off时必填；范围1-86400
RespectOrigin	是	String	是否遵从源站，on/off

示例

请求示例

POST方式：

POST  /
 Host: cdn.api.ksyun.com
 X-Amz-Date: date 
 Authorization:authorization string 
 X-Action: SetHttpCodeCacheRuleConfig
 X-Version: V3
Content-Type: application/json

{
  "Domain": "example.com",
  "HttpCodeCacheRules": [
    {
      "HttpCodeCacheRuleType": "directory",
      "Value": "/images/",
      "HttpCode": "404,500-502",
      "CacheTime": 3600,
      "RespectOrigin": "off"
    }
  ]
}

返回示例

本接口调用成功返回 200 状态码，响应体为空（无 JSON 返回）；若调用失败，参数校验失败返回 400 + Error JSON（含Error.Code/Message）；鉴权失败返回 403；具体错误原因详见【使用须知】中错误代码表说明。

文档导读

上一篇：设置TLS协议版本

下一篇：回源超时配置

纯净模式常规模式

纯净模式

点击可全屏预览文档内容