如果客户端实际请求的URI与DCDN节点上缓存资源的URI不匹配，可通过URI重写功能，将请求URI重定向到目标URI。

背景信息

HTTP 302状态码（即302 Found），可表示资源被临时改变了位置。配置URI重写后，DCDN节点会在给客户端发送的302状态码响应信息的HTTP Location头部中放置新的URI地址信息，客户端收到302状态码响应之后，将会向新的URI地址发起请求。

配置URI重写规则后，DCDN节点默认给客户端发送302重定向状态码，同时也支持303和307重定向状态码，如果您需要修改重定向状态码，可以通过填写信息申请。

编码含义处理方法典型应用场景
302FoundGET方法不会发生变更，其他方法有可能会变更为GET方法。由于不可预见的原因该页面暂不可用。在这种情况下，搜索引擎不会更新它们的链接。
303See OtherGET方法不会发生变更，其他方法会变更为 GET 方法（消息主体会丢失）。用于PUT或POST请求完成之后进行页面跳转，防止由于页面刷新导致的操作的重复触发。
307Temporary Redirect方法和消息主体都不发生变化。由于不可预见的原因该页面暂不可用。在这种情况下，搜索引擎不会更新它们的链接。当站点支持非 GET 方法的链接或操作的时候，该状态码优于 302 状态码。
重要 单个域名最多可以配置50条重写规则。配置多条规则时，按照DCDN控制台URI重写列表由上而下的顺序执行。

适用场景

客户源站的资源存放路径发生了变更，DCDN节点上的资源存放路径也发生了变更，但是用户请求URL里面包含的资源路径没有变更，这时就需要DCDN节点来改写用户请求里面的资源路径。例如：图片文件原先存放在目录“/download/”，现在变更为“/image/”。

URI重写

操作步骤

  1. 登录DCDN控制台。
  2. 在左侧导航栏，单击域名管理。
  3. 在域名管理页面，单击目标域名对应的配置。
  4. 在指定域名的左侧导航栏，单击缓存配置。
  5. 单击重写页签。
  6. 单击添加，根据您的实际需求，配置重写规则。
    重写
    参数说明
    待重写URI以正斜线（/）开头的URI，不含http://头及域名。支持PCRE正则表达式，例如：^/hello$。
    目标URI以正斜线（/）开头的URI，不含http://头及域名，例如：/index.html。
    执行规则支持Redirect和Break这两种规则。
    • Redirect：如果请求的URI匹配了当前规则，该请求将被302重定向到目标URI。执行完当前规则后，当存在其他配置规则时，会继续匹配剩余规则。
    • Break：如果请求的URI匹配了当前规则，请求将被改写为目标URI。执行完当前规则后，当存在其他配置规则时，将不再匹配剩余规则。
  7. 单击确定，完成配置。

    成功配置重写功能后，您可以在重写列表中，对当前的配置进行修改或删除操作。

配置示例

URI重写规则按照正则表达式配置如下图所示：重写设置

客户端请求http://example.aliyundoc.com/hello时，请求中包含/hello，DCDN节点会在302状态码的Location信息里写入新的URI地址http://example.aliyundoc.com/index.html，并返回给客户端，客户端对http://example.aliyundoc.com/index.html发起请求。

相关API

BatchSetDcdnDomainConfigs