UpdateLoadBalancerAttribute - 更新负载均衡实例属性

接口说明

UpdateLoadBalancerAttribute 属于异步接口，即系统返回一个请求 ID，但该实例属性尚未修改成功，系统后台的变更任务仍在进行。您可以调用 GetLoadBalancerAttribute 查询网关型负载均衡实例的更新状态：
- 当网关型负载均衡实例处于 Configuring 状态时，表示网关型负载均衡实例正在更新中。
- 当网关型负载均衡实例处于 Active 状态时，表示网关型负载均衡实例更新成功。

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作

访问级别

资源类型

条件关键字

关联操作

gwlb:UpdateLoadBalancerAttribute

update

*LoadBalancer

acs:gwlb:{#regionId}:{#accountId}:loadbalancer/{#LoadBalancerId}

无

名称	类型	必填	描述	示例值
LoadBalancerId	string	是	网关型负载均衡实例的 ID。	gwlb-9njtjmqt7zfcqm****
LoadBalancerName	string	否	网关型负载均衡实例名称。长度为 2~128 个英文或中文字符，必须以字母或中文开头，可包含数字、半角句号（.）、下划线（_）和短划线（-）。	testGwlbName
DryRun	boolean	否	是否只预检此次请求。取值： true：发送检查请求，不会更新实例属性。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码`DryRunOperation`。 false（默认值）：发送正常请求，通过检查后返回 HTTP 2xx 状态码并直接进行操作。	false
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	123e4567-e89b-12d3-a456-426655440000
TrafficMode	string	否	流量模式。取值： LoadBalance：负载均衡。 ByPass：绕行模式。	LoadBalance

正常返回示例

JSON格式

{
  "RequestId": "B956C629-0E8C-5EFF-BAC1-B0E3A8C5CBDD"
}

HTTP status code	错误码	错误信息	描述
400	IncorrectBusinessStatus.LoadBalancer	The business status of %s [%s] is incorrect.	资源%s业务状态%s不支持当前操作
400	IncorrectStatus.LoadBalancer	The status of %s [%s] is incorrect.	资源%s当前状态%s不支持操作
400	ResourceNotFound.LoadBalancer	The specified resource of %s is not found.

访问错误中心查看更多错误码。

更多信息，参考变更详情。