查询URI重写
所有文档
menu

内容分发网络 CDN

查询URI重写

产品详情立即购买

本接口用于查询指定加速域名的重写配置。

Method Path 说明
GET /v2/domain/{domain}/config?urlRules 查询URI重写

domain: 需要查询CDN的加速域名

请求示例

GET /v2/domain/test.baidu.com/config?urlRules HTTP/1.1
Host: cdn.baidubce.com
x-bce-date: 2022-02-17T08:19:20Z
x-bce-request-id: 04c43778-8163-4f80-941c-2d2246b6b2a5

响应体 (Response Body)

参数 可选 类型 说明
urlRules 必选 []UrlRule UrlRule的定义见下面,UrlRule数组个数<=10

UrlRule

参数可选类型说明
action 必选 string 合法值为redirect或者break。
redirect:若请求的URI匹配了当前规则,该请求将被302重定向跳转到目标URI。 
break:若请求的URI匹配了当前规则,执行完当前规则后,将不再匹配剩余规则。
src 必选 string 字符串长度小于等于128。
不含http(s)://头和域名。
最终生成的URI必须以/开头。
支持捕获,比如${1}/test。
目标URI里面如果没有?,则会带上原始参数。如果有?,则会用?后面的参数替换原始参数。
比如访问URI为/a?c=1
• 待重写URI为/a,目标URI为/b,改写后URI为/b?c=1
• 待重写URI为/a,目标URI为/b?,改写后URI为/b
• 待重写URI为/a,目标URI为/b?d=1,改写后URI为/b?d=1
dst 必选 string 字符串长度小于等于128。
执行规则设置为break的情况下,不含http(s)://头和域名;执行规则设置为redirect的情况下,可以包含http(s)://头和域名。
可以匹配参数,比如只改写带有特定参数的URI。
支持正则以及捕获,比如(/[^?]+)\?c=1

响应示例:

HTTP/1.1 200 OK
Server: nginx/1.14.0
Date: Thu, 17 Feb 2022 08:21:05 GMT
Content-Type: application/json; charset=utf-8
Transfer-Encoding: chunkedConnection: keep-alive
X-Powered-By: PHP/5.6.36
x-bce-request-id: 04c43778-8163-4f80-941c-2d2246b6b2a5

{
    "urlRules": [
        {
            "action": "redirect",
            "src": "/data/(.*)",
            "dst": "/${1}/data2222"
        }
    ]
}
上一篇
设置URI重写
下一篇
访问控制接口