功能介绍

创建转发策略。监听器和转发策略共同决定了流量如何转发到后端 云服务器 上。

• 通过匹配action为REDIRECT_TO_POOL的转发策略下的转发规则的url和 域名 ，可以将匹配的流量转发到指定的后端 云服务 器组上，再将流量分发到在这个后端云服务器组关联的后端云服务器上。
• 可以通过创建action为REDIRECT_TO_LISTENER的转发策略，将HTTP监听器的流量都重定向到TERMINATED_HTTPS监听器上，实现请求协议的重定向。

接口约束

当前只支持HTTP协议跳转到HTTPS协议。即当转发策略的action为REDIRECT_TO_LISTENER时，转发策略的listener_id指定的监听器只支持HTTP类型的监听器，redirect_listener_id指定的监听器只支持TERMINATED_HTTPS类型的监听器。

转发策略的redirect_listener只能指定为转发策略所在 负载均衡 器下的监听器。

调试

您可以在API Explorer中直接运行调试该接口。

URI

POST /v2/{project_id}/elb/l7policies

请求消息

响应消息

请求示例

• 请求样例1 创建转发策略，转发到后端云服务器组

  POST https://{Endpoint}/v2/573d73c9f90e48d0bddfa0eb202b25c2/elb/l7policies
  
  {
      "l7policy": {
          "name": "niubiao_yaqing_api-2", 
          "listener_id": "3e24a3ca-11e5-4aa3-abd4-61ba0a8a18f1", 
          "action": "REDIRECT_TO_POOL", 
          "redirect_pool_id": "6460f13a-76de-43c7-b776-4fefc06a676e", 
          "rules": [
              {
                  "type": "PATH", 
                  "compare_type": "EQUAL_TO", 
                  "value": "/test"
              }, 
              {
                  "type": "HOST_NAME", 
                  "compare_type": "EQUAL_TO", 
                  "value": "www.test.com"
              }
          ]
      }
  }

• 请求样例2 创建重定向

  POST https://{Endpoint}/v2/573d73c9f90e48d0bddfa0eb202b25c2/elb/l7policies
  
  {
      "l7policy": {
          "action": "REDIRECT_TO_LISTENER", 
          "listener_id": "4ef8553e-9ef7-4859-a42d-919feaf89d60", 
          "redirect_listener_id": "3ee10199-a7b4-4784-93cd-857afe9d0890", 
          "name": "redirect-test"
      }
  }

响应示例

• 响应样例1

  {
      "l7policy": {
          "redirect_pool_id": "6460f13a-76de-43c7-b776-4fefc06a676e", 
          "description": "", 
          "admin_state_up": true, 
          "rules": [
              {
                  "id": "742600d9-2a14-4808-af69-336883dbb590"
              }, 
              {
                  "id": "3251ed77-0d52-412b-9310-733636bb3fbf"
              }
          ], 
          "tenant_id": "573d73c9f90e48d0bddfa0eb202b25c2", 
          "listener_id": "3e24a3ca-11e5-4aa3-abd4-61ba0a8a18f1", 
          "redirect_url": null, 
          "redirect_listener_id": null, 
          "action": "REDIRECT_TO_POOL", 
          "position": 100, 
          "provisioning_status": "ACTIVE", 
          "project_id": "573d73c9f90e48d0bddfa0eb202b25c2", 
          "id": "65d6e115-f179-4bcd-9bbb-1484e5f8ee81", 
          "name": "niubiao_yaqing-_api-2"
      }
  }

• 响应样例2

  {
      "l7policy": {
          "redirect_pool_id": null, 
          "description": "", 
          "admin_state_up": true, 
          "rules": [ ], 
          "tenant_id": "573d73c9f90e48d0bddfa0eb202b25c2", 
          "listener_id": "4ef8553e-9ef7-4859-a42d-919feaf89d60", 
          "redirect_url": null, 
          "redirect_listener_id": "3ee10199-a7b4-4784-93cd-857afe9d0890", 
          "action": "REDIRECT_TO_LISTENER", 
          "position": 100, 
          "provisioning_status": "ACTIVE", 
          "project_id": "573d73c9f90e48d0bddfa0eb202b25c2", 
          "id": "bc4e4338-480f-4a98-8245-5bb1964f0e1d", 
          "name": "redirect-test"
      }
  }

返回码

请参见状态码。