文档首页/ 弹性负载均衡 ELB/ API参考（安卡拉区域）/ API（V3）/ 转发策略/ 批量更新转发策略优先级
更新时间：2025-02-24 GMT+08:00
在线调试
CLI示例
查看PDF
分享

批量更新转发策略优先级

功能介绍

批量更新转发策略的优先级。

接口约束

该接口只用于更新action为REDIRECT_TO_POOL的独享型实例下的转发策略。

调用方法

请参见如何调用API。

URI

POST /v3/{project_id}/elb/l7policies/batch-update-priority

表1 路径参数

参数

是否必选

参数类型

描述

project_id

是

String

参数解释：项目ID。

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Auth-Token

是

String

参数解释：IAM鉴权Token。
表3 请求Body参数

参数

是否必选

参数类型

描述

l7policies

否

Array of BatchUpdatePriorityRequestBody objects

参数解释：转发策略的结构体。
表4 BatchUpdatePriorityRequestBody

参数

是否必选

参数类型

描述

id

是

String

参数解释：待更新的l7policy的ID。

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的优先级来避免错误。

响应参数

状态码：202

表5 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

请求示例

批量更新转发策略优先级

POST https://{ELB_Endpoint}/v3/060576782980d5762f9ec014dd2f1148/elb/l7policies/batch-update-priority

{
  "l7policies" : [ {
    "id" : "1fe93e12-6e07-47a9-8f81-3346c015601d",
    "priority" : 11
  } ]
}

响应示例

状态码：202

Created

{
  "request_id" : "e5c07525-1470-47b6-9b0c-567527a036aa"
}

状态码

状态码

描述

202

Created

错误码

请参见错误码。

父主题： 转发策略