文档首页 > > API参考> API(共享型)> 转发策略> 更新转发策略

更新转发策略

分享
更新时间: 2020/06/01 GMT+08:00

功能介绍

更新转发策略。通过更新可以将匹配的流量转发到新的后端云服务器组或新的监听器上。

URI

PUT /v2.0/lbaas/l7policies/{l7policy_id}

表1 参数说明

参数

是否必选

参数类型

描述

l7policy_id

Object

转发策略ID。

请求消息

表2 请求参数

参数

是否必选

参数类型

描述

l7policy

Object

转发策略对象。表3

表3 l7policy字段说明

参数

是否必选

参数类型

描述

name

String

转发策略名称。

支持的最大字符长度:255

description

String

转发策略的描述信息。

支持的最大字符长度:255

redirect_pool_id

String

流量匹配后转发到后端云服务器组的ID。默认值:null;

当action为REDIRECT_TO_POOL时为必选字段。

当action为REDIRECT_TO_LISTENER时,不可指定该字段。

指定的后端云服务器组需满足以下条件:

  • 不能是监听器的default_pool;
  • 不能是除该转发策略所在的监听器以外的其他监听器的转发策略使用的后端云服务器组。

redirect_listener_id

String

流量匹配后转发到的监听器的ID。默认值:null;

当action为REDIRECT_TO_LISTENER时为必选字段。

当action为REDIRECT_TO_POOL时不可指定。

  • 只支持指定为protocol为TERMINATED_HTTPS的listener。
  • 只支持指定为当前转发策略所在的负载均衡器下的监听器。

admin_state_up

Boolean

转发策略的管理状态;

取值范围: true/false。

该字段为预留字段,暂未启用。默认为true。

响应消息

表4 响应参数

参数

是否必选

参数类型

描述

l7policy

Object

转发策略对象。详见表5

表5 l7policy字段说明

参数

参数类型

描述

id

String

转发策略ID。

tenant_id

String

转发策略所在的项目ID。

project_id

String

转发策略所在的项目ID。

name

String

转发策略名称。

admin_state_up

Boolean

转发策略的管理状态;

取值范围: true/false。

该字段为预留字段,暂未启用。默认为true。

description

String

转发策略的描述信息。

listener_id

String

转发策略所在的监听器ID。

action

String

转发策略的匹配动作。

取值范围:

  • REDIRECT_TO_POOL:将匹配的流量转发到redirect_pool_id指定的后端云服务器组上;
  • REDIRECT_TO_LISTENER:将listener_id指定的HTTP监听器的流量重定向到redirect_listener_id指定的TERMINATED_HTTPS监听器上。

redirect_pool_id

String

流量匹配后转发到后端云服务器组的ID。

redirect_listener_id

String

流量匹配后转发到的监听器的ID。

redirect_url

String

转发策略重定向到的url。

该字段为预留字段,暂未启用。

rules

Array

转发策略关联的转发规则的ID列表。

position

Integer

转发优先级,从1递增,最高100。默认值:100;

该字段为预留字段,暂未启用。

provisioning_status

String

转发策略的配置状态,可以为ACTIVE、PENDING_CREATE 或者ERROR。

默认值:ACTIVE;

该字段为预留字段,暂未启用。

示例

  • 请求样例 更新转发策略
    PUT https://{Endpoint}/v2.0/lbaas/l7policies/5ae0e1e7-5f0f-47a1-b39f-5d4c428a1586
    
    {
        "l7policy": {
            "name": "test"
        }
    }
  • 响应样例
    {
        "l7policy": {
            "redirect_pool_id": "431a03eb-81bb-408e-ae37-7ce19023692b", 
            "redirect_listener_id": null,
            "description": "", 
            "admin_state_up": true, 
            "rules": [
                {
                    "id": "67d8a8fa-b0dd-4bd4-a85b-671db19b2ef3"
                }, 
                {
                    "id": "f02b3bca-69d2-4335-a3fa-a8054e996213"
                }
            ], 
    
            "tenant_id": "a31d2bdcf7604c0faaddb058e1e08819",
            "project_id": "a31d2bdcf7604c0faaddb058e1e08819", 
            "listener_id": "26058b64-6185-4e06-874e-4bd68b7633d0", 
            "redirect_url": null, 
            "action": "REDIRECT_TO_POOL", 
            "provisioning_status": "ACTIVE",
            "position": 2, 
            "id": "5ae0e1e7-5f0f-47a1-b39f-5d4c428a1586", 
            "name": "test"
        }
    }

返回码

请参见共享型负载均衡返回码说明

分享:

    相关文档

    相关产品

文档是否有解决您的问题?

提交成功!

非常感谢您的反馈,我们会继续努力做到更好!

反馈提交失败,请稍后再试!

*必选

请至少选择或填写一项反馈信息

字符长度不能超过200

提交反馈 取消

如您有其它疑问,您也可以通过华为云社区问答频道来与我们联系探讨

智能客服提问云社区提问