UpdateLoadBalancerZones - 更新负载均衡可用区 - 负载均衡

更新负载均衡实例可用区。

接口说明

请确保在使用该接口前，已充分了解网关型负载均衡产品的收费方式和价格。

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

重要每次调用该接口时，请确保您传入该网关型负载均衡实例的所有可用区参数，包括当前和新增的可用区。如您未传入当前的可用区参数，表示需要将当前可用区删除。您可以通过 GetLoadBalancerAttribute 接口查询该实例的当前可用区。

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

操作

访问级别

资源类型

条件关键字

关联操作

gwlb:UpdateLoadBalancerZones

update

*LoadBalancer

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

*VSwitch

acs:vpc:{#regionId}:{#accountId}:vswitch/{#VSwitchId}

无

名称	类型	必填	描述	示例值
LoadBalancerId	string	是	网关型负载均衡实例的 ID。	gwlb-9njtjmqt7zfcqm****
ZoneMappings	array<object>	是	可用区及交换机映射列表。至少需要添加一个可用区，最多支持添加 20 个可用区。若当前地域支持 2 个及以上的可用区，建议添加 2 个及以上可用区。
	object	否	可用区及交换机映射对象。
VSwitchId	string	是	可用区对应的交换机，每个可用区只能使用一台交换机和一个子网。	vsw-bp1n75pbs77v5q6p3****
ZoneId	string	是	可用区 ID，通过调用网关型负载均衡 DescribeZones 接口获得。	cn-hangzhou-h
DryRun	boolean	否	是否只预检此次请求。取值： true：发送检查请求，不会更新实例可用区。检查项包括是否填写了必需参数、请求格式、业务限制。如果检查不通过，则返回对应错误。如果检查通过，则返回错误码`DryRunOperation`。 false（默认值）：发送正常请求，通过检查后返回 HTTP 2xx 状态码并直接进行操作。	false
ClientToken	string	否	客户端 Token，用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一。ClientToken 只支持 ASCII 字符。说明若您未指定，则系统自动使用 API 请求的 RequestId 作为 ClientToken 标识。每次 API 请求的 RequestId 不一样。	123e4567-e89b-12d3-a456-42665544****

正常返回示例

JSON格式

{
  "RequestId": "ED8905C2-A4F6-5E43-87B7-6A5DC8757146"
}

HTTP status code	错误码	错误信息	描述
400	OperationDenied.VSwitchChangeNotSupport	The operation is not allowed because of VSwitchChangeNotSupport.	修改交换机vSwitch操作不支持
400	DuplicatedParam.VSwitchId	The param of VSwitchId is duplicated.	列表中的vSwitchId参数重复
400	DuplicatedParam.ZoneId	The param of ZoneId is duplicated.	列表中的ZoneId参数重复
400	IllegalParamSize.ZoneMappings	The param size of ZoneMappings is illegal.	ZoneMappings列表数量不合法
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	Mismatch.ZoneIdAndVSwitchId	The ZoneId and VSwitchId are mismatched.	参数ZoneId和vSwitchId的值不匹配
400	MissingParam.LoadBalancerId	The param of LoadBalancerId is missing.	负载均衡ID参数缺失
400	OperationDenied.VSwitchNotSupportIpv6	The operation is not allowed because of VSwitchNotSupportIpv6.	交换机vSwitch没有开启IPv6，操作不支持
400	ResourceAlreadyAssociated.GwlbeAssociated	The specified resource of %s is already associated.	指定资源%s已被关联
400	ResourceNotEnough.VSwitchIp	The specified resource of VSwitchIp is not enough.	vSwitch IP资源不足
400	ResourceNotFound.LoadBalancer	The specified resource of %s is not found.

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

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