调用 ModifyLoadBalancerZones 接口，变更 ALB 实例可用区。 ## 使用说明 * 每秒最多提交 5 个 API 请求。 * 您需要至少保留一个 ALB 实例当前在用的可用区。 ## 调试 ## 请求参数 **Action** `String` %%require%% 示例值：`ModifyLoadBalancerZones` 接口名称。当前 API 的名称为 `ModifyLoadBalancerZones`。 **Version** `String` %%require%% 示例值：`2020-04-01` 接口版本。当前 API 的版本为 `2020-04-01`。 **LoadBalancerId** `String` %%require%% 示例值：`alb-*******` ALB 实例 ID。 **ZoneMappings.N.AllocationId** `String[]` `可选` 示例值：`ZoneMappings.1.AllocationId=eip-bp12mw1f8k3jgy****&ZoneMappings.2.AllocationId=eip-bp0ohf1f8k3jgy****` 公网 IP 的 ID。 **ZoneMappings.N.SubnetId** `String[]` %%require%% 示例值：`ZoneMappings.1.SubnetId=subnet-bp12mw1f8k3jgy****&ZoneMappings.2.SubnetId=subnet-bp0ohf1f8k3jgy****` 子网 ID。ALB 实例在此可用区下的私网 IP 地址将从此子网网段中分配。 **ZoneMappings.N.ZoneId** `String[]` %%require%% 示例值：`ZoneMappings.1.ZoneId=cn-beijing-a&ZoneMappings.2.ZoneId=cn-beijing-b` ALB 实例的可用区 ID。 * 您可以调用 [DescribeZones](/docs/6406/145473) 接口，获取ALB实例可部署的可用区 ID。 * `SubnetId` 与 `ZoneId` 需要匹配。 ## 返回参数 **RequestId** `String` `可选` 示例值：`202411152539010225146063030****` 请求 ID。 ## 请求示例 ```JSON GET /?Action=ModifyLoadBalancerZones&Version=2020-04-01&LoadBalancerId=alb-habjsbfjbesjbchjbs&ZoneMappings.1.ZoneId=cn-beijing-a&ZoneMappings.1.AllocationId=eip-knkjsefksenckjscn&ZoneMappings.1.SubnetId=subnet-mndfkjsfkjcsck Host: alb.cn-beijing.volcengineapi.com X-Date: 20251121T094038Z Authorization: HMAC-SHA256 Credential=Adfks******wekfwe/20251121/cn-beijing/alb/request, SignedHeaders=host;x-date, Signature=47a7d934ff7b37c03938******cd7b8278a40a1057690c401e92246a0e41085f ``` ## 返回示例 ```JSON { "ResponseMetadata": { "RequestId": "20210816110638****2514606306AF947C", "Action": "ModifyLoadBalancerZones", "Version": "2020-04-01", "Service": "alb", "Region": "cn-beijing" }, "Result": { "RequestId": "20210811152539010225146063030****" } } ``` ## 错误码如果响应正文包含 Error 字段，则表示 API 请求失败。此处仅展示当前 API 的错误码，更多错误码请参见[公共错误码](https://www.volcengine.com/docs/6406/113579)。 |**状态码** |**错误码** |**错误信息** |**说明** | |---|---|---|---| |400 |OperationDenied.ModifyLoadBalancerZones |The request on the specified LoadBalancer is denied due to the count of listeners bound with the LoadBalancer is too much. |因 ALB 实例配置的监听器数量过多，对于该 ALB 实例的操作请求被拒绝。 | |400 |OperationDenied.ZoneUnsupported |The request on the specified LoadBalancer is denied due to the specified zone is unsupported. DescribeZones will tell you which zones ALB supports. |因指定的可用区内不支持创建 ALB 实例，对于该 ALB 实例的操作请求被拒绝。通过调用 DescribeZones 接口，可获得 ALB 实例支持部署的可用区信息。 | |400 |OperationDenied.ZoneInfoChanged |The request on the specified LoadBalancer is denied due to the subnet id or eip id of the existing zone has changed. |因已有可用区的子网或者公网 IP 信息发生更改，对于该 ALB 实例的操作请求被拒绝。 | |400 |OperationDenied.MissingOldZone |The request on the specified LoadBalancer is denied due to missing old zones. Please specify an old zone at least. |因未指定旧可用区，对于该 ALB 实例的操作请求被拒绝。请至少指定一个旧可用区。 | |400 |OperationDenied.ZoneMappingsNotChanged |The request on the specified LoadBalancer is denied due to the zone info has not changed. |因可用区信息未发生变更，对于该 ALB 实例的操作请求被拒绝。 | |400 |OperationDenied.Ipv6NotEnabled |The request on the specified LoadBalancer is denied due to subnet is not IPv6 enabled. |因子网未启用 IPv6，对于该 ALB 实例的操作请求被拒绝。 | |400 |OperationDenied.IPv6OnlySubnetNotAllowed |The request on the specified LoadBalancer is denied due to IPv6\-only subnets can not be specified to add zones. |因子网仅支持 IPv6，无法指定该子网部署 ALB 实例的新可用区，对于该 ALB 实例的操作请求被拒绝。 | |400 |OperationDenied.LoadBalancerWithAnycastEipNotAllowed |The request on the specified LoadBalancer is denied due to the LoadBalancer associated with anycast eip does not support to modify zone. |因绑定 Anycast EIP 的 ALB 实例不支持变更可用区，对于该 ALB 实例的操作请求被拒绝。 | |400 |OperationDenied.UnsupportedEipBillingType |The request on the specified LoadBalancer is denied due to unsupported EIP billing type. |因私网 ALB 实例绑定的 EIP 不支持此计费方式，对于该 ALB 实例的操作请求被拒绝。 | |400 |OperationDenied.MissIPv6Address |The request on the specified LoadBalancer is denied due to the subnet missing ipv6 address. |因子网缺少 IPv6 地址，对于该 ALB 实例的操作请求被拒绝。 | |400 |InvalidZoneMappings.ZoneId.Duplicated |The specified ZoneMappings.ZoneId is duplicated. |指定的 ZoneMappings.ZoneId 重复。 | |400 |InvalidZoneMappings.AllocationId.Duplicated |The specified ZoneMappings.AllocationId is duplicated. |指定的 ZoneMappings.AllocationId 重复。 | |400 |InvalidSubnet.ZoneMismatch |The specified subnet and zone do not match. |指定的子网和可用区不匹配。 | |400 |LimitExceed.Zone |You've reached the limit on the number of zones that you can operate at a time. |已达到单次可操作的可用区的数量上限。 | |400 |QuotaExceed.Eni |You've reached the limit on the number of Eni that you can create. |已达到创建弹性网卡的数量上限。 | |400 |InvalidEip.InvalidStatus |The specified EIP is not in the correct status for the request. |指定的 EIP 所处状态无法响应该请求。 | |400 |InvalidEni.InvalidStatus |The specified Eni is not in the correct status for the request. |指定的弹性网卡所处状态无法响应该请求。 | |400 |InvalidIPv6Eip.InvalidStatus |The specified IPv6 EIP is not in the correct status for the request. |指定的 IPv6 EIP 所处状态无法响应该请求。 | |400 |InvalidLoadBalancer.InvalidStatus |The specified LoadBalancer is not in the correct status for the request. |指定的 ALB 实例所处状态无法响应该请求。 | |400 |OperationFailed.QueryVpc |The request on the specified resource failed due to the query on VPC failed. |因请求 VPC 失败，对于该资源的操作请求失败。 | |400 |OperationFailed.CreatePrivateEniFailed |The request on the specified LoadBalancer failed due to creating private eni failed. |因辅助网卡创建失败，对于该 ALB 实例的操作请求失败。 | |400 |OperationFailed.EipUsedByBandwidthPackage |The request on the specified LoadBalancer failed due to eip being used by bandwidth package. |因 EIP 实例仍然被共享带宽包使用，对于该 ALB 实例的操作请求失败。请先将 EIP 实例从共享带宽包移出后再进行操作。 | |403 |Forbidden |You are not authorized to modify zones for the LoadBalancer. |您无权限更改 ALB 实例的可用区。 | |404 |InvalidLoadBalancer.NotFound |The specified LoadBalancer does not exist. |指定的 ALB 实例不存在。 | |404 |InvalidSubnet.NotFound |The specified Subnet does not exist. |指定的子网不存在。 | |404 |InvalidEip.NotFound |The specified EIP does not exist. |指定的 EIP 不存在。 |