
# 更新转发策略 - UpdateL7Policy
#### 功能介绍
更新七层转发策略。
#### 调用方法
请参见[如何调用API](https://support.huaweicloud.com/api-elb/elb_dy_0000.html)。
#### 授权信息
账号具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备调用API所需的权限。
- 如果使用角色与策略授权，具体权限要求请参见[权限和授权项](https://support.huaweicloud.com/api-elb/elb_sq_0001.html)。
- 如果使用身份策略授权，需具备如下身份策略权限。
  
  | 授权项                   | 访问级别  | 资源类型（\*为必须） | 条件键                                                                                                                                                                                                                                                                                                                                      | 别名                 | 依赖的授权项 |
  |:---|:---|:---|:---|:---|:---|
  | elb:l7policies:update | Write | l7policy \* | g:EnterpriseProjectId                                                                                                                                                                                                                                                                                                                    | elb:l7policies:put | -      |
  | elb:l7policies:update | Write | listener    | - g:EnterpriseProjectId   - g:ResourceTag/\<tag-key\>    | elb:l7policies:put | -      |
  | elb:l7policies:update | Write | pool        | g:EnterpriseProjectId                                                                                                                                                                                                                                                                                                                    | elb:l7policies:put | -      |
     
  
 
#### URI
PUT /v3/{project_id}/elb/l7policies/{l7policy_id}
表1路径参数 
| 参数          | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                      |
|:---|:---|:---|:---|
| l7policy_id | 是    | String | **参数解释**：转发策略ID。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及                                                                                           |
| project_id  | 是    | String | **参数解释** ：项目ID。获取方式请参见[获取项目ID](https://support.huaweicloud.com/api-elb/elb_fl_0008.html)。 **约束限制**：不涉及 **取值范围**：长度为32个字符，由小写字母和数字组成。 **默认取值**：不涉及 |
   
#### 请求参数
表2请求Header参数 
| 参数           | 是否必选 | 参数类型   | 描述                                                                                                                                                                |
|:---|:---|:---|:---|
| X-Auth-Token | 是    | String | **参数解释**：IAM鉴权Token。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及 |
   
表3请求Body参数 
| 参数       | 是否必选 | 参数类型                                                                         | 描述                                                                  |
|:---|:---|:---|:---|
| l7policy | 是    | [UpdateL7PolicyOption] object | **参数解释**：l7policy对象。 **约束限制**：不涉及 |
   
 表4UpdateL7PolicyOption 
| 参数                                   | 是否必选 | 参数类型                                                                                                             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
|:---|:---|:---|:---|
| admin_state_up                       | 否    | Boolean                                                                                                          | **参数解释**：转发策略的管理状态。 **约束限制**：只支持设置为true。 **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| description                          | 否    | String                                                                                                           | **参数解释**：转发策略描述信息。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| name                                 | 否    | String                                                                                                           | **参数解释**：转发策略名称。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| redirect_listener_id                 | 否    | String                                                                                                           | **参数解释**：转发到的listener的ID。 **约束限制**： - 当action为REDIRECT_TO_LISTENER时不能更新为空或null。   - 只支持protocol为HTTPS/TERMINATED_HTTPS的listener。   - 不能指定为其他loadbalancer下的listener。   - 当action为REDIRECT_TO_POOL时，创建或更新时不能传入该参数。    **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| redirect_pool_id                     | 否    | String                                                                                                           | **参数解释**：转发到pool的ID。 **约束限制**： - 指定的pool不能是任何listener的default_pool。不能是其他listener的l7policy使用的pool。   - 当action为REDIRECT_TO_POOL时生效，但不能更新为空或null。   - 当action为REDIRECT_TO_LISTENER时，传入会报错。    **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| redirect_pools_config                | 否    | Array of [UpdateRedirectPoolsConfig] objects                 | **参数解释**：转发策略服务器组的权重配置。当监听器的高级转发策略功能（enhance_l7policy_enable）开启后才会生效，未开启传入该字段会报错。 **约束限制**： - 当action为REDIRECT_TO_POOL时，redirect_pool_id和redirect_pools_config必须指定一个，两个都指定时按redirect_pools_config生效。   - 当action是REDIRECT_TO_LISTENER和REDIRECT_TO_URL时，传入该字段会报错。   - 一个policy最多支持配置5个pool。Pool不允许重复。   - 仅支持全量覆盖。   - 共享型负载均衡器下的转发策略不支持该字段，传入会报错。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| redirect_pools_sticky_session_config | 否    | [UpdateRedirectPoolsStickySessionConfig] object | **参数解释**：配置转发策略关联的服务器组之间会话保持。负载均衡器会根据客户端第一个请求生成一个cookie，后续所有包含这个cookie值的请求都会由同一个pool处理。 **约束限制**：共享型负载均衡器下的转发策略不支持该字段，传入会报错。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
| redirect_url_config                  | 否    | [UpdateRedirectUrlConfig] object                               | **参数解释**：转发到的url配置。 **约束限制**： - 当监听器的高级转发策略功能（enhance_l7policy_enable）开启后才会生效，未开启传入该字段会报错。   - 当转发策略的action为REDIRECT_TO_URL时生效，且为必选字段，其他action不可指定，否则报错。   - 共享型负载均衡器下的转发策略不支持该字段，传入会报错。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| fixed_response_config                | 否    | [UpdateFixtedResponseConfig] object                         | **参数解释**：固定返回页面的配置。 **约束限制**： - 当监听器的高级转发策略功能（enhance_l7policy_enable）开启后才会生效，未开启传入该字段会报错。   - 当action为FIXED_RESPONSE时生效。其他action不可指定，否则报错。   - 共享型负载均衡器下的转发策略不支持该字段，传入会报错。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| redirect_pools_extend_config         | 否    | [UpdateRedirectPoolsExtendConfig] object               | **参数解释**：转发到的后端服务器组的配置。 **约束限制**：当action为REDIRECT_TO_POOL时生效。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| rules                                | 否    | Array of [CreateRuleOption] objects                                   | **参数解释**：转发策略关联的转发规则对象。 **约束限制**： - rules列表中最多含有10个rule规则（若rule中包含conditions字段，一条condition算一个规则），且列表中type为HOST_NAME，PATH，METHOD，SOURCE_IP的rule不能重复，至多指定一条。   - 仅支持全量替换。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| priority                             | 否    | Integer                                                                                                          | **参数解释**：转发策略的优先级。数字越小表示优先级越高。 **约束限制**： - 同一个监听器下不同转发策略之间不允许重复的优先级数值。   - 当关联的监听器的高级转发策略功能（enhance_l7policy_enable）开启后才会生效，未开启传入该字段会报错。   - 当关联的监听器的高级转发策略功能（enhance_l7policy_enable）未开启，按原有policy的排序逻辑，自动排序。不同域名优先级独立。相同域名下，按path的compare_type排序，精确\>前缀\>正则，匹配类型相同时，path的长度越长优先级越高。若policy下只有域名rule，没有路径rule，默认path为前缀匹配/。   - 共享型负载均衡器下的转发策略不支持该字段。    **取值范围**： - 当action为REDIRECT_TO_LISTENER时，支持指定为0-10000。   - 其它action取值，支持指定为1-10000。    **默认取值**： - 若关联的监听器的高级转发策略功能（enhance_l7policy_enable）未开启，且不传入该字段，则新创建的转发策略的优先级的值为1。   - 当action为REDIRECT_TO_LISTENER时，则新创建的转发策略的优先级的值为0。   - 其它action取值，新创建的转发策略的优先级的值为同一监听器下已有转发策略的优先级的最大值+1。 - 若监听器下没有转发策略，则新建的转发策略的优先级为1。   - 若当前已有转发策略的优先级的最大值是10000，则新创建的转发策略会因超出取值范围10000而失败。此时可通过传入指定priority，或调整原有policy的优先级来避免错误。      |
   
 表5UpdateRedirectPoolsConfig 
| 参数      | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                        |
|:---|:---|:---|:---|
| pool_id | 是    | String | **参数解释**：所在后端服务器组ID。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及                                                         |
| weight  | 否    | String | **参数解释**：转发策略服务器组的权重。请求将根据该权重进行负载分发到不同的服务器组。权重值越大，分发的请求越多。权重为0的后端不再接受新的请求。 **约束限制**：不涉及 **取值范围**：0-100 **默认取值**：不涉及 |
   
 表6UpdateRedirectPoolsStickySessionConfig 
| 参数      | 是否必选 | 参数类型    | 描述                                                                                                                                                                                       |
|:---|:---|:---|:---|
| enable  | 否    | Boolean | **参数解释**：转发策略服务器组会话保持开启的开关。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：false，表示关闭服务器组会话保持。 |
| timeout | 否    | Integer | **参数解释**：会话保持的时间。 **约束限制**：不涉及 **取值范围**：1-1440（分钟） **默认取值**：1440                   |
   
 表7UpdateRedirectUrlConfig 
| 参数                    | 是否必选 | 参数类型                                                                                   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| protocol              | 否    | String                                                                                 | **参数解释**：重定向的协议。 **约束限制**：不涉及 **取值范围**： - HTTP   - HTTPS   - ${protocol}，表示继承原值（即与被转发请求保持一致）。    **默认取值**：不涉及                                                                                                                                                                                                                                   |
| host                  | 否    | String                                                                                 | **参数解释**：重定向的主机名。 **约束限制**：不涉及 **取值范围**：字符串只能包含英文字母、数字、"-"、"."，必须以字母、数字开头。 **默认取值**：${host}，表示继承原值（即与被转发请求保持一致）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| port                  | 否    | String                                                                                 | **参数解释**：重定向到的端口。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：${port}表示继承原值（即与被转发请求保持一致）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
| path                  | 否    | String                                                                                 | **参数解释**：重定向的路径。 **约束限制**：不涉及 **取值范围**：只能包含英文字母、数字、_\~';@\^-%#\&$.\*+?,=!:\|\\/()\[\]{}，且必须以"/"开头。 **默认取值**：${path}，表示继承原值（即与被转发请求保持一致）。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| query                 | 否    | String                                                                                 | **参数解释**：重定向的查询字符串。举例如下： 将query设置为：${query}\&name=my_name，则在转发符合条件的URL（如https://www.example.com:8080/elb?type=loadbalancer）时，将会重定向到https://www.example.com:8080/elb?type=loadbalancer\&name=my_name。在例子中${query}表示type=loadbalancer。 **约束限制**：不涉及 **取值范围**：只能包含英文字母、数字和特殊字符：!$\&'()\*+,-./:;=?@\^_\`。字母区分大小写。其中$1，$2会匹配请求url通配符星号（\*） **默认取值**：${query}表示继承原值（即与被转发请求保持一致）                                                                                                                                                                                                                                                                                                                                              |
| status_code           | 否    | String                                                                                 | **参数解释**：重定向后的返回码。 **约束限制**：不涉及 **取值范围**： - 301   - 302   - 303   - 307   - 308    **默认取值**：不涉及 |
| insert_headers_config | 否    | [UpdateInsertHeadersConfig] object | **参数解释**：要添加的请求头参数列表。 **约束限制**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| remove_headers_config | 否    | [UpdateRemoveHeadersConfig] object | **参数解释**：要移除的请求头参数列表。 **约束限制**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
   
 表8UpdateFixtedResponseConfig 
| 参数                    | 是否必选 | 参数类型                                                                                   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|:---|
| status_code           | 否    | String                                                                                 | **参数解释**：返回码。 **约束限制**：不涉及 **取值范围**：200-299，400-499，500-599。 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| content_type          | 否    | String                                                                                 | **参数解释**：返回body的格式。 **约束限制**：不涉及 **取值范围**： - text/plain   - text/css   - text/html   - application/javascript   - application/json    **默认取值**：application/json |
| message_body          | 否    | String                                                                                 | **参数解释**：返回消息内容。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| insert_headers_config | 否    | [UpdateInsertHeadersConfig] object | **参数解释**：要添加的请求头参数列表。 **约束限制**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| remove_headers_config | 否    | [UpdateRemoveHeadersConfig] object | **参数解释**：要移除的请求头参数列表。 **约束限制**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| traffic_limit_config  | 否    | [UpdateTrafficLimitConfig] object   | **参数解释**：转发策略限速的配置。 **约束限制**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
   
 表9UpdateRedirectPoolsExtendConfig 
| 参数                    | 是否必选 | 参数类型                                                                                   | 描述                                                                                                                                                                               |
|:---|:---|:---|:---|
| rewrite_url_enable    | 否    | Boolean                                                                                | **参数解释**：是否开启url重定向。 **约束限制**：不涉及 **取值范围**：true 开启，false 未开启。 **默认取值**：不涉及 |
| rewrite_url_config    | 否    | [UpdateRewriteUrlConfig] object       | **参数解释**：URL重定向配置。 **约束限制**：当action为REDIRECT_TO_POOL的时候生效。                                                                                     |
| insert_headers_config | 否    | [UpdateInsertHeadersConfig] object | **参数解释**：要添加的请求头参数列表。 **约束限制**：不涉及                                                                                                             |
| remove_headers_config | 否    | [UpdateRemoveHeadersConfig] object | **参数解释**：要移除的请求头参数列表。 **约束限制**：不涉及                                                                                                             |
| traffic_limit_config  | 否    | [UpdateTrafficLimitConfig] object   | **参数解释**：转发策略限速的配置。 **约束限制**：不涉及                                                                                                               |
| cors_config           | 否    | [CreateCorsConfig] object                   | **参数解释**：转发策略跨域的配置。 **约束限制**：不涉及                                                                                                               |
| traffic_mirror_config | 否    | [CreateTrafficMirrorConfig] object | **参数解释**：流量镜像的配置。 **约束限制**：不涉及                                                                                                                 |
   
 表10UpdateRewriteUrlConfig 
| 参数    | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                         |
|:---|:---|:---|:---|
| host  | 否    | String | **参数解释**：重定向的域名。 **约束限制**：不涉及 **取值范围**：英文字母、数字、"-"、"."，必须以字母、数字开头。 **默认取值**：不涉及                                                                                                                                                      |
| path  | 否    | String | **参数解释**：重定向的请求路径。其中$1-$9会匹配请求url通配符星号(\*)，当正则匹配分组小于指定数字，则$指定数字结果为空。$后面跟字母，匹配结果均为空，直到下一个特殊字符出现，例如$abc#123，则匹配结果为#123；$后面跟特殊字符则直接输出特殊字符，例如$#匹配结果为$#。 **约束限制**：不涉及 **取值范围**：英文字母、数字、_\~';@\^-%#\&$.+?,=!:\|/()，且必须以"/"开头。 **默认取值**：不涉及 |
| query | 否    | String | **参数解释**：重定向的查询字符串。其中$1-$9会匹配请求url通配符星号（\*），当正则匹配分组小于指定数字，则$指定数字结果为空。$后面跟字母，匹配结果均为空，直到下一个特殊字符出现，例如$abc#123，则匹配结果为#123；$后面跟特殊字符则直接输出特殊字符，例如$#匹配结果为$#。 **约束限制**：不涉及 **取值范围**：英文字母、数字和特殊字符：!$\&'()+,-./:;=?@\^_\`。字母区分大小写。 **默认取值**：不涉及 |
   
 表11UpdateInsertHeadersConfig 
| 参数      | 是否必选 | 参数类型                                                                                           | 描述                                                                  |
|:---|:---|:---|:---|
| configs | 是    | Array of [UpdateInsertHeaderConfig] objects | **参数解释**：要添加请求头参数列表。 **约束限制**：不涉及 |
   
 表12UpdateInsertHeaderConfig 
| 参数         | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| key        | 是    | String | **参数解释**：请求头参数名。 **约束限制**：不能是以下字符： connection、upgrade、content-length、transfer-encoding、keep-alive、te、host、cookie、remoteip、authority、x-forwarded-host、x-forwarded-for、x-forwarded-for-port、x-forwarded-tls-certificate-id、x-forwarded-tls-protocol、x-forwarded-tls-cipher、x-forwarded-elb-ip、x-forwarded-port、x-forwarded-elb-id、x-forwarded-elb-vip、x-real-ip、x-forwarded-proto、x-nuwa-trace-ne-in、x-nuwa-trace-ne-out。 **取值范围**：1-40个字符，字母a-z（不区分大小写）、数字，短划线-和下划线_。 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| value_type | 是    | String | **参数解释**：请求头参数类别。 **约束限制**：不涉及 **取值范围**： - USER_DEFINED：用户自定义请求头。   - REFERENCE_HEADER：引用请求头字段中的某一个字段。   - SYSTEM_DEFINED：表示请求头参数只能使用系统定义的一系列固定值，取值列表见value字段描述。    **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| value      | 是    | String | **参数解释**：请求头参数的值。 **约束限制**：当value_type为SYSTEM_DEFINED时，value只可从CLIENT-PORT, CLIENT-IP, ELB-PROTOCOL, ELB-ID, ELB-PORT, ELB-EIP, ELB-VIP, TLS-PROTOCOL, TLS-CIPHER, CLIENTCERT-SUBJECTDN, CLIENTCERT-ISSUERDN, CLIENTCERT-FINGERPRINT, CLIENTCERT-CLIENTVERIFY, CLIENTCERT-SERIALNUMBER, CLIENTCERT, CLIENTCERT-CIPHERS, CLIENTCERT-END, TLS-ALPN-PROTOCOL, TLS-SNI, TLS-JA3, TLS-JA4中取值。{TLS-PROTOCOL, TLS-CIPHER, CLIENTCERT-SUBJECTDN, CLIENTCERT-ISSUERDN, CLIENTCERT-FINGERPRINT, CLIENTCERT-CLIENTVERIFY, CLIENTCERT-SERIALNUMBER, CLIENTCERT, CLIENTCERT-CIPHERS, CLIENTCERT-END, TLS-ALPN-PROTOCOL, TLS-SNI, TLS-JA3, TLS-JA4}只有HTTPS、quic协议类型的监听器支持 **取值范围**：1-128个字符，支持ascii码值32\<=ch\<=127范围内可打印字符，\*和英文问号?。不能以空格开头或结尾，不允许设置值为：connection、upgrade、content-length、transfer-encoding、keep-alive、te、host、cookie、remoteip、authority、transparent、x-forwarded-host、x-forwarded-for、x-forwarded-for-port、x-forwarded-tls-certificate-id、 x-forwarded-tls-protocol、x-forwarded-tls-cipher、x-forwarded-port、x-real-ip、x-forwarded-proto、x-forwarded-elb-ip、 x-forwarded-elb-id、x-forwarded-elb-vip、x-nuwa-trace-ne-in、x-nuwa-trace-ne-out。 **默认取值**：不涉及 |
   
 表13UpdateRemoveHeadersConfig 
| 参数      | 是否必选 | 参数类型                                                                                           | 描述                                                                   |
|:---|:---|:---|:---|
| configs | 是    | Array of [UpdateRemoveHeaderConfig] objects | **参数解释**：要移除的请求头参数列表。 **约束限制**：不涉及 |
   
 表14UpdateRemoveHeaderConfig 
| 参数  | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
|:---|:---|:---|:---|
| key | 是    | String | **参数解释**：被移除的请求头的参数名。 **约束限制**：不能移除以下请求头参数： connection、upgrade、content-length、transfer-encoding、keep-alive、te、host、cookie、remoteip、authority、x-forwarded-host、x-forwarded-for、x-forwarded-for-port、x-forwarded-tls-certificate-id、x-forwarded-tls-protocol、x-forwarded-tls-cipher、x-forwarded-elb-ip、x-forwarded-port、x-forwarded-elb-id、x-forwarded-elb-vip、x-real-ip、x-forwarded-proto、x-nuwa-trace-ne-in、x-nuwa-trace-ne-out **取值范围**：1-40个字符，字母a-z（不区分大小写）、数字，短划线-和下划线_。 **默认取值**：不涉及 |
   
 表15UpdateTrafficLimitConfig 
| 参数                | 是否必选 | 参数类型    | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|:---|
| qps               | 否    | Integer | **参数解释**：转发策略qps限速。 **约束限制**：不涉及 **取值范围**：0-100000，单位：个/秒。0表示不限速。 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| per_source_ip_qps | 否    | Integer | **参数解释**：对转发策略单源(单个客户端IP)进行限速。 **约束限制**： - quic监听器下转发策略不支持配置单源限速。   - 指定该字段时，赋值可以为0或者为null。   - 如果qps不为0，per_source_ip_qps需要小于qps。    **取值范围**：0-100000，单位：个/秒。0表示不限速。 **默认取值**：不涉及 |
| burst             | 否    | Integer | **参数解释**：设置当单源qps超限时，允许的局部突增请求数量。超出该限制的请求将返回503。 **约束限制**：不涉及 **取值范围**：0-100000，单位：个/秒。 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                          |
   
 表16CreateCorsConfig 
| 参数                | 是否必选 | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| allow_origin      | 否    | Array of strings | **参数解释**：允许的访问来源列表。 **约束限制**： - 若配置了通配符（\*），则不能配其他值。   - 不支持IP地址。   - 不能配置重复的值。    **取值范围**：单个列表项的取值 - 通配符（\*），表示匹配所有来源。   - 除通配符外，其他值只能是以http://或者https://开头（小写），后面加域名。可以是具体域名或一级泛域名，可以包含端口或不包含端口。例：http://\*.test.abc.example.com:80    **默认取值**：不涉及 |
| allow_methods     | 否    | Array of strings | **参数解释**：选择跨域访问时允许的 HTTP 方法。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                |
| allow_headers     | 否    | Array of strings | **参数解释**：允许跨域的 Header 列表。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| expose_headers    | 否    | Array of strings | **参数解释**：允许暴露的Header列表。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| allow_credentials | 否    | Boolean          | **参数解释**：是否允许携带凭证信息。 **约束限制**：不涉及 **取值范围**：true 是，false 否。 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| max_age           | 否    | Long             | **参数解释**：预检请求在浏览器的最大缓存时间，单位：秒。 **约束限制**：不涉及 **取值范围**：-1\~172800 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
   
 表17CreateTrafficMirrorConfig 
| 参数                         | 是否必选 | 参数类型             | 描述                                                                                                                                                                        |
|:---|:---|:---|:---|
| target_ids                 | 否    | Array of strings | **参数解释**：流量镜像的目的后端服务器组ID。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及    |
| mirror_request_body_enable | 否    | Boolean          | **参数解释**：镜像请求是否携带请求体，默认true。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及 |
   
 表18CreateRuleOption 
| 参数             | 是否必选 | 参数类型                                                                                 | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|:---|
| admin_state_up | 否    | Boolean                                                                              | **参数解释**：转发规则的管理状态。 **约束限制**：只支持设置为true。 **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| compare_type   | 是    | String                                                                               | **参数解释**：转发匹配方式。 **约束限制**： - type为HOST_NAME时仅支持EQUAL_TO，支持通配符\*。   - type为PATH时可以为REGEX，STARTS_WITH，EQUAL_TO。   - type为METHOD、SOURCE_IP，仅支持EQUAL_TO。   - type为HEADER、QUERY_STRING，仅支持EQUAL_TO，支持通配符\*、？。    **取值范围**： - EQUAL_TO 表示精确匹配。   - REGEX 表示正则匹配。   - STARTS_WITH 表示前缀匹配。    **默认取值**：不涉及                                                                                                                             |
| key            | 否    | String                                                                               | **参数解释**：匹配项的名称，比如转发规则匹配类型是请求头匹配，则key表示请求头参数的名称。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及 不支持该字段，请勿使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
| value          | 是    | String                                                                               | **参数解释**：匹配项的值。比如转发规则匹配类型是域名匹配，则value表示域名的值。 **约束限制**：仅当conditions空时该字段生效。 **取值范围**： - 当转发规则类别type为HOST_NAME时，字符串只能包含英文字母、数字、-、.或\*，必须以字母、数字或\*开头。若域名中包含\*，则\*只能出现在开头且必须以\*.开始。当\*开头时表示通配0\~任一个字符。   - 当转发规则类别type为PATH时，当转发规则的compare_type为STARTS_WITH、EQUAL_TO时，字符串只能包含英文字母、数字、_\~';@\^-%#\&$.\*+?,=!:\|\\/()\[\]{}，且必须以/开头。   - 当转发规则类别type为METHOD、SOURCE_IP、HEADER、QUERY_STRING时，该字段无意义，使用conditions来指定key/value。    **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| project_id     | 否    | String                                                                               | **参数解释**：转发规则所在的项目ID。 **约束限制**：不涉及 **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| type           | 是    | String                                                                               | **参数解释**：转发规则类别。 **约束限制**： - 一个l7policy下创建的l7rule的HOST_NAME，PATH，METHOD，SOURCE_IP不能重复。HEADER、QUERY_STRING支持重复的rule配置。    **取值范围**： - HOST_NAME：匹配域名。   - PATH：匹配请求路径。   - METHOD：匹配请求方法。   - HEADER：匹配请求头。   - QUERY_STRING：匹配请求查询参数。   - SOURCE_IP：匹配请求源IP地址。   - COOKIE: 匹配cookie信息。    **默认取值**：不涉及 |
| invert         | 否    | Boolean                                                                              | **参数解释**：是否反向匹配。 **约束限制**：不涉及 **取值范围**：true、false **默认取值**：false 不支持该字段，请勿使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| conditions     | 否    | Array of [CreateRuleCondition] objects | **参数解释**：转发规则的匹配条件。 **约束限制**： - 当监听器的高级转发策略功能（enhance_l7policy_enable）开启后才会生效。   - 若转发规则配置了conditions，字段key、字段value的值无意义。   - 同一个rule内的conditions列表中所有key必须相同，value不允许重复。    **取值范围**：不涉及 **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
   
 表19CreateRuleCondition 
| 参数    | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
|:---|:---|:---|:---|
| key   | 否    | String | **参数解释**：匹配项的名称。 **约束限制**：同一个rule内的conditions列表中所有key必须相同。 **取值范围**： - 当转发规则类别type为HOST_NAME、PATH、METHOD、SOURCE_IP时，该字段固定为空字符串。   - 当转发规则类别type为HEADER时，key表示请求头参数的名称，value表示请求头参数的值。key的长度限制1-40字符，只允许包含字母、数字和-_。   - 当转发规则类别type为QUERY_STRING时，key表示查询参数的名称，value表示查询参数的值。key的长度限制为1-128字符，不支持空格，中括号，大括号，尖括号，反斜杠，双引号，'#'，'\&'，'\|'，'%'，'\~'，字母区分大小写。    **默认取值**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| value | 是    | String | **参数解释**：匹配项的值。 **约束限制**： - 同一个rule内的conditions列表中所有key必须相同。   - 同一个rule内的conditions列表中所有value不允许重复。    **取值范围**： - 当转发规则类别type为HOST_NAME时，key固定为空字符串，value表示域名的值。value长度1-128字符，字符串只能包含英文字母、数字、-、.或\*，必须以字母、数字或\*开头，\*只能出现在开头且必须以\*.开始。   - 当转发规则类别type为PATH时，key固定为空字符串，value表示请求路径的值。value长度1-128字符。当转发规则的compare_type为STARTS_WITH、EQUAL_TO时，字符串只能包含英文字母、数字、_\~';@\^-%#\&$.\*+?,=!:\|\\/()\[\]{}，且必须以/开头。   - 当转发规则类别type为HEADER时，key表示请求头参数的名称，value表示请求头参数的值。value长度限制1-128字符，不支持空格，双引号，支持以下通配符：\*（匹配0个或更多字符）和？（正好匹配1个字符）。   - 当转发规则类别type为QUERY_STRING时，key表示查询参数的名称，value表示查询参数的值。value长度限制为1-128字符，不支持空格，中括号，大括号，尖括号，反斜杠，双引号，'#'，'\&'，'\|'，'%'，'\~'，字母区分大小写，支持通配符：\*（匹配0个或更多字符）和？（正好匹配1个字符）   - 当转发规则类别type为METHOD时，key固定为空字符串，value表示请求方式。value取值范围为：GET, PUT,POST,DELETE, PATCH, HEAD, OPTIONS。   - 当转发规则类别type为SOURCE_IP时，key固定为空字符串，value表示请求源地址。value为CIDR格式，支持ipv4，ipv6。例如192.168.0.2/32，2049::49/64。    **默认取值**：不涉及 |
   
#### 响应参数
**状态码：200**
表20响应Body参数 
| 参数         | 参数类型                                                  | 描述                                                                                    |
|:---|:---|:---|
| request_id | String                                                | **参数解释**：请求ID。 **取值范围**：由数字、小写字母和中划线（-）组成的字符串，自动生成。 |
| l7policy   | [L7Policy] object | **参数解释**：l7policy对象。                                                                  |
   
 表21L7Policy 
| 参数                                   | 参数类型                                                                                                  | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                              |
|:---|:---|:---|
| action                               | String                                                                                                | **参数解释**：转发策略的转发动作。 **取值范围**： - REDIRECT_TO_POOL：转发到后端服务器组；   - REDIRECT_TO_LISTENER：重定向到监听器；   - REDIRECT_TO_URL：重定向到URL；   - FIXED_RESPONSE：返回固定响应体。    |
| admin_state_up                       | Boolean                                                                                               | **参数解释**：转发策略的管理状态。 **取值范围**：只支持设置为true。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| description                          | String                                                                                                | **参数解释**：转发策略描述信息。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| id                                   | String                                                                                                | **参数解释**：转发策略ID。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| listener_id                          | String                                                                                                | **参数解释**：转发策略所属的监听器ID。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| name                                 | String                                                                                                | **参数解释**：转发策略名称 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| position                             | Integer                                                                                               | **参数解释**：转发策略的优先级，不支持更新。 不支持该字段，请勿使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| priority                             | Integer                                                                                               | **参数解释**：转发策略的优先级。数字越小表示优先级越高。 **取值范围**： - 当action为REDIRECT_TO_LISTENER时，支持指定为0-10000。   - 其它action取值，支持指定为1-10000。                                                                                                                                                                                                                                                                                       |
| project_id                           | String                                                                                                | **参数解释**：转发策略所在的项目ID。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| provisioning_status                  | String                                                                                                | **参数解释**：转发策略的配置状态。 **取值范围**： - ACTIVE: 默认值，表示正常。   - ERROR: 表示当前策略与同一监听器下的其他策略存在相同的规则配置。                                                                                                                                                                                                                                                                                                                 |
| redirect_pool_id                     | String                                                                                                | **参数解释**：转发到pool的ID。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| redirect_listener_id                 | String                                                                                                | **参数解释**：转发到的listener的ID。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| redirect_url                         | String                                                                                                | **参数解释**：转发到的url。 **取值范围**：必须满足格式: protocol://host:port/path?query。 不支持该字段，请勿使用。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                            |
| rules                                | Array of [RuleRef] objects                                         | **参数解释**：转发策略关联的转发规则列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| redirect_url_config                  | [RedirectUrlConfig] object                               | **参数解释**：转发到的url配置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| redirect_pools_config                | Array of [RedirectPoolsConfig] objects                 | **参数解释**：转发策略服务器组的权重配置。当监听器的高级转发策略功能（enhance_l7policy_enable）开启后才会生效，未开启传入该字段会报错。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| redirect_pools_sticky_session_config | [RedirectPoolsStickySessionConfig] object | **参数解释**：配置转发策略关联的服务器组之间会话保持。负载均衡器会根据客户端第一个请求生成一个cookie，后续所有包含这个cookie值的请求都会由同一个pool处理。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| redirect_pools_extend_config         | [RedirectPoolsExtendConfig] object               | **参数解释**：转发到的后端服务器组的配置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| fixed_response_config                | [FixtedResponseConfig] object                         | **参数解释**：固定返回页面的配置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                             |
| created_at                           | String                                                                                                | **参数解释**：创建时间。 **取值范围**：格式：yyyy-MM-dd'T'HH:mm:ss'Z'，UTC时区。 注意：独享型实例的历史数据以及共享型实例下的资源，不返回该字段。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| updated_at                           | String                                                                                                | **参数解释**：更新时间。 **取值范围**：格式：yyyy-MM-dd'T'HH:mm:ss'Z'，UTC时区。 注意：独享型实例的历史数据以及共享型实例下的资源，不返回该字段。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
| enterprise_project_id                | String                                                                                                | **参数解释**：企业项目ID。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                 |
   
 表22RuleRef 
| 参数 | 参数类型   | 描述                                                            |
|:---|:---|:---|
| id | String | **参数解释**：规则ID。 **取值范围**：不涉及 |
   
 表23RedirectUrlConfig 
| 参数                    | 参数类型                                                                        | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
|:---|:---|:---|
| protocol              | String                                                                      | **参数解释**：重定向的协议。 **取值范围**： - HTTP   - HTTPS   - ${protocol}，表示继承原值（即与被转发请求保持一致）。                                                                                                                                                                                                                                      |
| host                  | String                                                                      | **参数解释**：重定向的主机名。 **取值范围**：只能包含英文字母、数字、"-"、"."。且必须以字母、数字开头。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| port                  | String                                                                      | **参数解释**：重定向到的端口。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
| path                  | String                                                                      | **参数解释**：重定向的路径。 **取值范围**：支持英文字母、数字、_\~';@\^-%#\&$.\*+?,=!:\|\\/()\[\]{}，且必须以"/"开头。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| query                 | String                                                                      | **参数解释**：重定向的查询字符串。举例如下： 将query设置为：${query}\&name=my_name，则在转发符合条件的URL（如https://www.example.com:8080/elb?type=loadbalancer）时，将会重定向到https://www.example.com:8080/elb?type=loadbalancer\&name=my_name。在例子中${query}表示type=loadbalancer。 **取值范围**：只能包含英文字母、数字和特殊字符：!$\&'()\*+,-./:;=?@\^_\`。字母区分大小写。其中$1，$2会匹配请求url通配符星号（\*）                                                                                                                                                                                                                                                                                                                                                                                                        |
| status_code           | String                                                                      | **参数解释**：重定向后的返回码。 **取值范围**： - 301   - 302   - 303   - 307   - 308    |
| insert_headers_config | [InsertHeadersConfig] object | **参数解释**：要添加的请求头参数列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
| remove_headers_config | [RemoveHeadersConfig] object | **参数解释**：要移除的请求头参数列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
   
 表24RedirectPoolsConfig 
| 参数      | 参数类型    | 描述                                                                                                                          |
|:---|:---|:---|
| pool_id | String  | **参数解释**：所在后端服务器组ID。 **取值范围**：不涉及                                                         |
| weight  | Integer | **参数解释**：转发策略服务器组的权重。请求将根据该权重进行负载分发到不同的服务器组。权重值越大，分发的请求越多。权重为0的后端不再接受新的请求。 **取值范围**：0-100 |
   
 表25RedirectPoolsStickySessionConfig 
| 参数      | 参数类型    | 描述                                                                      |
|:---|:---|:---|
| enable  | Boolean | **参数解释**：转发策略服务器组会话保持开启的开关。                                             |
| timeout | Integer | **参数解释**：会话保持的时间。 **取值范围**：1-1440（分钟） |
   
 表26RedirectPoolsExtendConfig 
| 参数                    | 参数类型                                                                        | 描述                                                                                 |
|:---|:---|:---|
| rewrite_url_enable    | Boolean                                                                     | **参数解释**：是否开启url重定向。 **取值范围**：true 开启，false 未开启。 |
| rewrite_url_config    | [RewriteUrlConfig] object       | **参数解释**：URL重定向配置。                                                                 |
| insert_headers_config | [InsertHeadersConfig] object | **参数解释**：要添加的请求头参数列表。                                                              |
| remove_headers_config | [RemoveHeadersConfig] object | **参数解释**：要移除的请求头参数列表。                                                              |
| traffic_limit_config  | [TrafficLimitConfig] object   | **参数解释**：转发策略限速的配置。                                                                |
| cors_config           | [CorsConfig] object                   | **参数解释**：转发策略跨域的配置。                                                                |
| traffic_mirror_config | [TrafficMirrorConfig] object | **参数解释**：流量镜像的配置                                                                   |
   
 表27RewriteUrlConfig 
| 参数    | 参数类型   | 描述                                                                                                                                                                                                                                           |
|:---|:---|:---|
| host  | String | **参数解释**：重定向的域名。 **取值范围**：英文字母、数字、"-"、"."，必须以字母、数字开头。                                                                                                                                                      |
| path  | String | **参数解释**：重定向的请求路径。其中$1-$9会匹配请求url通配符星号(\*)，当正则匹配分组小于指定数字，则$指定数字结果为空。$后面跟字母，匹配结果均为空，直到下一个特殊字符出现，例如$abc#123，则匹配结果为#123；$后面跟特殊字符则直接输出特殊字符，例如$#匹配结果为$#。 **取值范围**：英文字母、数字、_\~';@\^-%#\&$.+?,=!:\|/()，且必须以"/"开头。 |
| query | String | **参数解释**：重定向的查询字符串。其中$1-$9会匹配请求url通配符星号（\*），当正则匹配分组小于指定数字，则$指定数字结果为空。$后面跟字母，匹配结果均为空，直到下一个特殊字符出现，例如$abc#123，则匹配结果为#123；$后面跟特殊字符则直接输出特殊字符，例如$#匹配结果为$#。 **取值范围**：英文字母、数字和特殊字符：!$\&'()+,-./:;=?@\^_\`。字母区分大小写。 |
   
 表28CorsConfig 
| 参数                | 参数类型             | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                               |
|:---|:---|:---|
| allow_origin      | Array of strings | **参数解释**：允许的访问来源列表。 **取值范围**：单个列表项的取值 - 通配符（\*），表示匹配所有来源。   - 除通配符外，其他值只能是以http://或者https://开头（小写），后面加域名。可以是具体域名或一级泛域名，可以包含端口或不包含端口。例：http://\*.test.abc.example.com:80    |
| allow_methods     | Array of strings | **参数解释**：选择跨域访问时允许的 HTTP 方法。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| allow_headers     | Array of strings | **参数解释**：允许跨域的 Header 列表。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                         |
| expose_headers    | Array of strings | **参数解释**：允许暴露的Header列表。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                           |
| allow_credentials | Boolean          | **参数解释**：是否允许携带凭证信息。 **取值范围**： - true：是。   - false：否。                                                                                                                      |
| max_age           | Long             | **参数解释**：预检请求在浏览器的最大缓存时间，单位：秒。 **取值范围**：-1\~172800                                                                                                                                                                                                                                                                                                                                                                                                                                             |
   
 表29TrafficMirrorConfig 
| 参数                         | 参数类型             | 描述                                                                          |
|:---|:---|:---|
| target_ids                 | Array of strings | **参数解释**：流量镜像的目的后端服务器组ID。 **取值范围**：不涉及    |
| mirror_request_body_enable | Boolean          | **参数解释**：镜像请求是否携带请求体，默认true。 **取值范围**：不涉及 |
   
 表30FixtedResponseConfig 
| 参数                    | 参数类型                                                                        | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                     |
|:---|:---|:---|
| status_code           | String                                                                      | **参数解释**：返回码。 **取值范围**：200\~299、400\~499和500\~599。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
| content_type          | String                                                                      | **参数解释**：返回body的格式。 **取值范围**： - text/plain   - text/css   - text/html   - application/javascript   - application/json    |
| message_body          | String                                                                      | **参数解释**：返回消息内容。 **取值范围**：不涉及                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                        |
| insert_headers_config | [InsertHeadersConfig] object | **参数解释**：要添加的请求头参数列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| remove_headers_config | [RemoveHeadersConfig] object | **参数解释**：要移除的请求头参数列表。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  |
| traffic_limit_config  | [TrafficLimitConfig] object   | **参数解释**：转发策略限速的配置。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    |
   
 表31InsertHeadersConfig 
| 参数      | 参数类型                                                                                | 描述                   |
|:---|:---|:---|
| configs | Array of [InsertHeaderConfig] objects | **参数解释**：要添加请求头参数列表。 |
   
 表32InsertHeaderConfig 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                   |
|:---|:---|:---|
| key        | String | **参数解释**：请求头参数名。 **取值范围**：1-40个字符，字母a-z（不区分大小写）、数字，短划线-和下划线_。                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                      |
| value_type | String | **参数解释**：请求头参数类别。 **取值范围**： - USER_DEFINED：用户自定义请求头。   - REFERENCE_HEADER：引用请求头字段中的某一个字段。   - SYSTEM_DEFINED：表示请求头参数只能使用系统定义的一系列固定值，取值列表见value字段描述。    |
| value      | String | **参数解释**：请求头参数的值。 **取值范围**：1-128个字符，支持ascii码值32\<=ch\<=127范围内可打印字符，\*和英文问号?。不能以空格开头或结尾，不允许设置值为：connection、upgrade、content-length、transfer-encoding、keep-alive、te、host、cookie、remoteip、authority、transparent、x-forwarded-host、x-forwarded-for、x-forwarded-for-port、x-forwarded-tls-certificate-id、 x-forwarded-tls-protocol、x-forwarded-tls-cipher、x-forwarded-port、x-real-ip、x-forwarded-proto、x-forwarded-elb-ip、 x-forwarded-elb-id、x-forwarded-elb-vip、x-nuwa-trace-ne-in、x-nuwa-trace-ne-out。                              |
   
 表33RemoveHeadersConfig 
| 参数      | 参数类型                                                                                | 描述                    |
|:---|:---|:---|
| configs | Array of [RemoveHeaderConfig] objects | **参数解释**：要移除的请求头参数列表。 |
   
 表34RemoveHeaderConfig 
| 参数  | 参数类型   | 描述                                                                                                   |
|:---|:---|:---|
| key | String | **参数解释**：被移除的请求头的参数名。 **取值范围**：1-40个字符，字母a-z（不区分大小写）、数字，短划线-和下划线_。 |
   
 表35TrafficLimitConfig 
| 参数                | 参数类型    | 描述                                                                                                           |
|:---|:---|:---|
| qps               | Integer | **参数解释**：转发策略qps限速。 **取值范围**：0-100000，单位：个/秒。0表示不限速。                       |
| per_source_ip_qps | Integer | **参数解释**：对转发策略单源(单个客户端IP)进行限速。 **取值范围**：0-100000，单位：个/秒。0表示不限速。            |
| burst             | Integer | **参数解释**：设置当单源qps超限时，允许的局部突增请求数量。超出该限制的请求将返回503。 **取值范围**：0-100000，单位：个/秒。 |
   
#### 请求示例
更新转发策略
```
PUT https://{ELB_Endpoint}/v3/99a3fff0d03c428eac3678da6a7d0f24/elb/l7policies/cf4360fd-8631-41ff-a6f5-b72c35da74be
{
  "l7policy" : {
    "name" : "My policy.",
    "description" : "Update policy.",
    "redirect_listener_id" : "48a97732-449e-4aab-b561-828d29e45050"
  }
}
```
#### 响应示例
**状态码：200**
操作正常返回。
```
{
  "l7policy" : {
    "name" : "my policy",
    "redirect_pool_id" : null,
    "description" : "",
    "admin_state_up" : true,
    "rules" : [ {
      "id" : "a8310d08-6d4c-413a-aa45-7e43f8183193"
    } ],
    "project_id" : "0c1503d710984bad92306faea3654dfd",
    "listener_id" : "8b9d7d2c-49dc-43ba-99f5-3bc476bdf10b",
    "redirect_url" : null,
    "redirect_url_config" : null,
    "redirect_pools_config" : [ {
      "weight" : 100,
      "pool_id" : "599fdd99-d908-4dff-9db3-15eec274dfed"
    } ],
    "redirect_pools_sticky_session_config" : {
      "enable" : false,
      "timeout" : 1000
    },
    "fixed_response_config" : null,
    "redirect_listener_id" : null,
    "action" : "REDIRECT_TO_POOL",
    "position" : 100,
    "priority" : 1,
    "provisioning_status" : "ACTIVE",
    "id" : "10ebd807-54b1-4f73-a21e-4e7af939d13b",
    "enterprise_project_id" : "0",
    "created_at" : "2025-04-15T08:36:43Z",
    "updated_at" : "2025-04-15T11:49:56Z",
    "redirect_pools_extend_config" : {
      "rewrite_url_enable" : false,
      "rewrite_url_config" : null,
      "insert_headers_config" : {
        "configs" : [ {
          "key" : "test",
          "value" : "xxx",
          "value_type" : "USER_DEFINED"
        } ]
      },
      "remove_headers_config" : {
        "configs" : [ {
          "key" : "req-trace-id"
        } ]
      },
      "traffic_limit_config" : null,
      "cors_config" : null,
      "traffic_mirror_config" : null
    }
  },
  "request_id" : "54961722be349499068aa73a5f91745a"
}
```
#### SDK代码示例
SDK代码示例如下。
- [Java]
  更新转发策略
  ```
  package com.huaweicloud.sdk.test;
  import com.huaweicloud.sdk.core.auth.ICredential;
  import com.huaweicloud.sdk.core.auth.BasicCredentials;
  import com.huaweicloud.sdk.core.exception.ConnectionException;
  import com.huaweicloud.sdk.core.exception.RequestTimeoutException;
  import com.huaweicloud.sdk.core.exception.ServiceResponseException;
  import com.huaweicloud.sdk.elb.v3.region.ElbRegion;
  import com.huaweicloud.sdk.elb.v3.*;
  import com.huaweicloud.sdk.elb.v3.model.*;
  public class UpdateL7PolicySolution {
      public static void main(String[] args) {
          // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
          // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
          String ak = System.getenv("CLOUD_SDK_AK");
          String sk = System.getenv("CLOUD_SDK_SK");
          String projectId = "{project_id}";
          ICredential auth = new BasicCredentials()
                  .withProjectId(projectId)
                  .withAk(ak)
                  .withSk(sk);
          ElbClient client = ElbClient.newBuilder()
                  .withCredential(auth)
                  .withRegion(ElbRegion.valueOf("<YOUR REGION>"))
                  .build();
          UpdateL7PolicyRequest request = new UpdateL7PolicyRequest();
          request.withL7policyId("{l7policy_id}");
          UpdateL7PolicyRequestBody body = new UpdateL7PolicyRequestBody();
          UpdateL7PolicyOption l7policybody = new UpdateL7PolicyOption();
          l7policybody.withDescription("Update policy.")
              .withName("My policy.")
              .withRedirectListenerId("48a97732-449e-4aab-b561-828d29e45050");
          body.withL7policy(l7policybody);
          request.withBody(body);
          try {
              UpdateL7PolicyResponse response = client.updateL7Policy(request);
              System.out.println(response.toString());
          } catch (ConnectionException e) {
              e.printStackTrace();
          } catch (RequestTimeoutException e) {
              e.printStackTrace();
          } catch (ServiceResponseException e) {
              e.printStackTrace();
              System.out.println(e.getHttpStatusCode());
              System.out.println(e.getRequestId());
              System.out.println(e.getErrorCode());
              System.out.println(e.getErrorMsg());
          }
      }
  }
  ```
- [Python]
  更新转发策略
  ```
  # coding: utf-8
  import os
  from huaweicloudsdkcore.auth.credentials import BasicCredentials
  from huaweicloudsdkelb.v3.region.elb_region import ElbRegion
  from huaweicloudsdkcore.exceptions import exceptions
  from huaweicloudsdkelb.v3 import *
  if __name__ == "__main__":
      # The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
      # In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
      ak = os.environ["CLOUD_SDK_AK"]
      sk = os.environ["CLOUD_SDK_SK"]
      projectId = "{project_id}"
      credentials = BasicCredentials(ak, sk, projectId)
      client = ElbClient.new_builder() \
          .with_credentials(credentials) \
          .with_region(ElbRegion.value_of("<YOUR REGION>")) \
          .build()
      try:
          request = UpdateL7PolicyRequest()
          request.l7policy_id = "{l7policy_id}"
          l7policybody = UpdateL7PolicyOption(
              description="Update policy.",
              name="My policy.",
              redirect_listener_id="48a97732-449e-4aab-b561-828d29e45050"
          )
          request.body = UpdateL7PolicyRequestBody(
              l7policy=l7policybody
          )
          response = client.update_l7_policy(request)
          print(response)
      except exceptions.ClientRequestException as e:
          print(e.status_code)
          print(e.request_id)
          print(e.error_code)
          print(e.error_msg)
  ```
- [Go]
  更新转发策略
  ```
  package main
  import (
  "fmt"
  "github.com/huaweicloud/huaweicloud-sdk-go-v3/core/auth/basic"
      elb "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3"
  "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3/model"
      region "github.com/huaweicloud/huaweicloud-sdk-go-v3/services/elb/v3/region"
  )
  func main() {
      // The AK and SK used for authentication are hard-coded or stored in plaintext, which has great security risks. It is recommended that the AK and SK be stored in ciphertext in configuration files or environment variables and decrypted during use to ensure security.
      // In this example, AK and SK are stored in environment variables for authentication. Before running this example, set environment variables CLOUD_SDK_AK and CLOUD_SDK_SK in the local environment
      ak := os.Getenv("CLOUD_SDK_AK")
      sk := os.Getenv("CLOUD_SDK_SK")
      projectId := "{project_id}"
      auth, err := basic.NewCredentialsBuilder().
          WithAk(ak).
          WithSk(sk).
          WithProjectId(projectId).
          SafeBuild()
      if err != nil {
          fmt.Println(err)
          return
      }
      hcClient, err := elb.ElbClientBuilder().
           WithRegion(region.ValueOf("<YOUR REGION>")).
           WithCredential(auth).
           SafeBuild()
      if err != nil {
          fmt.Println(err)
          return
      }
      client := elb.NewElbClient(hcClient)
      request := &model.UpdateL7PolicyRequest{}
  request.L7policyId = "{l7policy_id}"
  descriptionL7policy:= "Update policy."
  nameL7policy:= "My policy."
  redirectListenerIdL7policy:= "48a97732-449e-4aab-b561-828d29e45050"
  l7policybody := &model.UpdateL7PolicyOption{
  Description: &descriptionL7policy,
  Name: &nameL7policy,
  RedirectListenerId: &redirectListenerIdL7policy,
  }
  request.Body = &model.UpdateL7PolicyRequestBody{
  L7policy: l7policybody,
  }
  response, err := client.UpdateL7Policy(request)
  if err == nil {
          fmt.Printf("%+v\n", response)
      } else {
          fmt.Println(err)
      }
  }
  ```
- [更多]
  更多编程语言的SDK代码示例，请参见[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/ELB/sdk?api=UpdateL7Policy&version=v3)的代码示例页签，可生成自动对应的SDK代码示例。
#### 状态码
| 状态码 | 描述      |
|:---|:---|
| 200 | 操作正常返回。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-elb/ErrorCode.html)。
