批量更新转发策略优先级
功能介绍
批量更新转发策略的优先级。
接口约束
该接口只用于更新action为REDIRECT_TO_POOL的独享型实例下的转发策略。
调用方法
请参见如何调用API。
URI
POST /v3/{project_id}/elb/l7policies/batch-update-priority
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
project_id |
是 |
String |
项目ID。 |
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Auth-Token |
是 |
String |
IAM鉴权Token。 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
l7policies |
否 |
Array of BatchUpdatePriorityRequestBody objects |
转发策略的结构体 |
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
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 |
响应参数
状态码： 202
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
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 |
错误码
请参见错误码。
