更新时间:2022-03-31 GMT+08:00
分享

批量更新转发策略优先级

功能介绍

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

接口约束

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

调试

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

URI

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

表1 路径参数

参数

是否必选

参数类型

描述

project_id

String

项目ID。

请求参数

表2 请求Body参数

参数

是否必选

参数类型

描述

l7policies

Array of BatchUpdatePriorityRequestBody objects

转发策略的结构体

表3 BatchUpdatePriorityRequestBody

参数

是否必选

参数类型

描述

id

String

待更新的l7policy的ID。

最小长度:1

最大长度:36

priority

Integer

转发策略的优先级。当监听器的高级转发策略功能(enhance_l7policy_enable)开启后才会生效,未开启传入该字段会报错。共享型负载均衡器下的转发策略不支持该字段。

数字越小表示优先级越高,同一监听器下不允许重复。

当action为REDIRECT_TO_LISTENER时,仅支持指定为0,优先级最高。 当关联的listener没有开启enhance_l7policy_enable,按原有policy的排序逻辑,自动排序。各域名之间优先级独立,相同域名下,按path的compare_type排序,精确>前缀>正则,匹配类型相同时,path的长度越长优先级越高。若policy下只有域名rule,没有路径rule,默认path为前缀匹配/。 当关联的listener开启了enhance_l7policy_enable,且不传该字段,则新创建的转发策略的优先级的值为:同一监听器下已有转发策略的优先级的最大值+1。因此,若当前已有转发策略的优先级的最大值是10000,新创建会因超出取值范围10000而失败。此时可通过传入指定priority,或调整原有policy的优先级来避免错误。若监听器下没有转发策略,则新建的转发策略的优先级为1。

最小值:1

最大值:10000

响应参数

状态码: 201

表4 响应Body参数

参数

参数类型

描述

request_id

String

请求ID。

请求示例

批量更新转发策略优先级

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

{
  "l7policies" : [ {
    "id" : "2f124f60-980a-42f3-b201-35461df1b936",
    "priority" : 1
  } ]
}

响应示例

状态码: 201

Created

{
  "request_id" : "bffcc63e6ef5deb7f52c1ae675a7b177"
}

状态码

状态码

描述

201

Created

错误码

请参见错误码

分享:

    相关文档

    相关产品

关闭导读