SetUrlRewriteAndRedirectConfig

描述

本接口用于设置 CDN 域名的 URL 重写和重定向规则，可根据文件后缀、目录或精确 URL 对请求进行改写或跳转。

请求语法

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

请求参数

参数名	必选	类型及范围	说明
DomainId	是	String	域名ID
UrlRewriteAndRedirectRules	是	Object[]	URL重写及跳转规则列表

UrlRewriteAndRedirectRules 子参数

参数名	必选	类型及范围	说明
ConditionType	是	String	匹配条件类型可选值：file_suffix/directory/exact（不含 url_regex）
ConditionValue	是	String	匹配条件值，校验规则 `file_suffix`：逗号分隔，每段须匹配 `([a-zA-Z0-9])+`，且不能是纯数字`directory`：须匹配 `/((([^/?"<>\ ])+/))` — 以`/`开头以`/`结尾 `exact`：须匹配 `/(((([^/?"<>\ ])+/))(([^/*?"<>\ ])+)` 或裸 `/`
UrlChangeType	是	String	URL变更类型可选值：rewrite/redirect
SourceUri	否	String	回源URI；UrlChangeType=rewrite时必填；redirect时可选
TargetUri	否	String	目标URI；SourceUri非空时必填。有SourceUri时必填
RedirectCode	否	String	跳转状态码UrlChangeType=redirect时必填，可选值 301/302/307
RedirectProtocol	否	String	跳转协议UrlChangeType=redirect时可填，可选值 follow/http/https
RedirectHost	否	String	跳转域名，默认是原始的加速域名；支持通配符，不支持IP，≤255字符

示例

请求示例

POST方式：

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

{
  "DomainId": "2D09M8B",
  "UrlRewriteAndRedirectRules": [
    {
      "ConditionType": "directory",
      "ConditionValue": "/old/",
      "UrlChangeType": "redirect",
      "SourceUri": "/old/",
      "TargetUri": "/new/",
      "RedirectCode": "301",
      "RedirectProtocol": "https",
      "RedirectHost": "www.example.com"
    }
  ]
}

返回示例

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

文档导读

上一篇：全网限速

下一篇：设置回源Follow302开关

纯净模式常规模式

纯净模式

点击可全屏预览文档内容