调用 CloneLoadBalancer 接口，复制一个现有 ALB 实例。 ## 使用说明每秒最多提交 2 个 API 请求。 ## 调试 ## 请求参数 **Action** String %%require%% `示例值：CloneLoadBalancer` 接口名称。当前 API 的名称为 `CloneLoadBalancer`。 **Version** String %%require%% `示例值：2020-04-01` 接口版本。当前 API 的版本为 `2020-04-01`。 **RegionId** String %%require%% `示例值：cn-beijing` 请求的Region。 **LoadBalancerId** String %%require%% `示例值：alb-bp1b6c719dfa08ex****` 需要被复制的ALB实例 ID。 **LoadBalancerName** String `可选` `示例值：alb-bp1o94dp5i6ea****` ALB 实例的名称。 * 必须以字母或中文开头，可包含数字、点号（.）、下划线（_）和短横线（\-）。 * 长度限制为1 ～ 128个字符。 * 不填默认为实例ID。 **Description** String `可选` `示例值：This is an ALB instance.` ALB 实例的描述。 * 不填默认为空字符串。 * 必须以字母或中文开头，可包含数字、英文逗号（,）、点号（.）、下划线（_）、空格（）、等号（=）、短横线（\-）、中文逗号（，）、中文句号（。） * 长度限制为1 ～ 255个字符。 **EipBillingConfig.ISP** String `可选` `示例值：BGP` 公网ALB 实例的 IPv4公网IP线路类型。取值如下： * BGP：BGP多线（默认值）。 **EipBillingConfig.EipBillingType** Integer `可选` `示例值：2` 公网ALB 实例的 IPv4公网IP的计费方式。取值如下： * 2：按量计费\-按带宽上限计费（默认值）。 * 3：按量计费\-按实际流量计费。 **EipBillingConfig.Bandwidth** Integer `可选` `示例值：10` 公网ALB 实例的 IPv4 公网 IP 的带宽峰值，默认值为1，单位为 Mbps。 **Ipv6EipBillingConfig.ISP** String `可选` `示例值：BGP` 公网ALB 实例的 IPv6 公网带宽的线路类型。取值如下： * BGP（默认值）：BGP多线。 **Ipv6EipBillingConfig.BillingType** Integer `可选` `示例值：2` 公网ALB 实例的 IPv6 公网带宽的计费类型。取值如下： * 2：按量计费\-按带宽上限计费。 * 3（默认值）：按量计费\-按实际流量计费。 **Ipv6EipBillingConfig.Bandwidth** Integer `可选` `示例值：200` 公网ALB 实例的 IPv6 公网带宽的带宽上限，单位为Mbps。 * 当创建 IPv4&IPv6 双栈类型的公网 ALB 实例时，该参数必填。 * 带宽取值范围如下： * 参数 Ipv6Address.BillingType 取值为2时：默认取值范围1 ~ 500。 * 参数 Ipv6Address.BillingType 取值为3时：默认取值范围1 ~ 200。 * 如您需要提升带宽上限，请联系 IPv6 网关的客户经理。 **DeleteProtection** String `可选` `示例值：off` 是否开启 ALB 实例的删除保护功能。取值如下： * off（默认值）：关闭。 * on：开启。 **ZoneMappings.N.SubnetId** String[] `可选` `示例值：subnet-bp12mw1f8k3jgy****` 子网ID。ALB 实例在此可用区下的私网 IP 地址将从此子网网段中分配。 **ZoneMappings.N.ZoneId** String[] `可选` `示例值：cn-beijing-a` ALB 实例的可用区ID。 ALB允许通过调用 DescribeZones 接口获取可用区ID对应的可用区的信息。SubnetId与ZoneId需要匹配。 **BandwidthPackageId** String `可选` `示例值：bwp-6248cim0mayon3gd5tv****` 克隆ALB 公网实例时，指定公网 IP 要加入的共享带宽包 ID。 **ProjectName** String `可选` `示例值：default` ALB实例所属项目名称。 ## 返回参数 **LoadBalancerId** String `示例值：alb-bp1o94dp5i6ea****` ALB 实例ID。 **RequestId** String `示例值：20210811152539010225146063030****` 请求ID。 ## 请求示例 ```JSON GET /?Action=CloneLoadBalancer&Version=2020-04-01&LoadBalancerId=alb-bp1b6c719dfa08ex**** 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": "CloneLoadBalancer", "Version": "2020-04-01", "Service": "alb", "Region": "cn-beijing" }, "Result": { "RequestId": "20210816110638****2514606306AF947C", "LoadBalancerId": "alb-bp1o94dp5i6ea****" } } ``` ## 错误码如果响应正文包含 Error 字段，则表示 API 请求失败。此处仅展示当前 API 的错误码，更多错误码请参见[公共错误码](https://www.volcengine.com/docs/6406/113579)。 |**状态码** |**错误码** |**错误信息** |**说明** | |---|---|---|---| |400 |InvalidDescription.Malformed |The specified Description is malformed. |指定的 Description 参数格式不合法。 | |400 |InvalidLoadBalancerName.Malformed |The specified LoadBalancerName is malformed. |指定的 LoadBalancerName 参数格式不合法。 | |400 |QuotaExceed.Eip |You've reached the limit on the number of EIP that you can create. |已达到可创建的 EIP 的数量上限。 | |400 |OperationFailed.QueryVpc |The request on the specified resource failed due to the query on VPC failed. |因请求 VPC 失败，对于该资源的操作请求失败。 | |400 |InvalidSubnet.ZoneMismatch |The specified subnet and zone do not match. |指定的子网和可用区不匹配。 | |400 |OperationFailed.QueryProject |The request on the specified resource failed due to the query on project failed. |因查询项目失败，对于该资源的操作请求失败。 | |400 |InvalidZoneMappings.ZoneId.Duplicated |The specified ZoneMappings.ZoneId is duplicated. |指定的 ZoneMappings.ZoneId 重复。 | |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 |InvalidIndexOrder.Malformed |The specified index order is malformed. |指定的索引顺序参数格式不合法。 | |400 |InvalidDeleteProtection.Malformed |The specified DeleteProtection is malformed. |指定的 DeleteProtection 参数格式不合法。 | |404 |InvalidBandwidthPackage.NotFound |The specified BandwidthPackage does not exist. |指定的共享带宽包不存在。 | |404 |InvalidVpc.NotFound |The specified VPC does not exist. |指定的 VPC 不存在。 | |404 |InvalidSubnet.NotFound |The specified Subnet does not exist. |指定的子网不存在。 | |404 |InvalidProject.NotFound |The specified Project does not exist. |指定的项目不存在。 | |404 |InvalidRegion.NotFound |The specified Region does not exist. |指定的 Region 不存在。 | |400 |OperationFailed.AccountBalanceNotEnough |The request on the specified Resource failed due to the account balance and available vouchers are less than 100 yuan in total. |因账户余额及可用代金券共不足 100 元，对于该资源的操作请求失败。请充值后重试。 | |400 |OperationFailed.CreateOrderFailed |The request on the specified LoadBalancer failed due to creating an order failed. |因下单支付失败，对于该 ALB 实例的操作请求失败。 | |400 |OperationFailed.CreatePrivateEniFailed |The request on the specified LoadBalancer failed due to creating private eni failed. |因辅助网卡创建失败，对于该 ALB 实例的操作请求失败。 | |400 |OperationFailed.CreatePreOrderFailed |The request on the specified LoadBalancer failed due to creating a pre order failed. |因配置单下单失败，对于该 ALB 实例的操作请求失败。 | |400 |QuotaExceed.EipInBandwidthPackage |You've reached the limit on the number of EIP per bandwidth package you can add in. |已达到共享带宽包内可加入的 EIP 的数量上限。 | |400 |QuotaExceed.InstancePerRegion |You've reached the limit on the number of loadbalancers the current region you can create in, usage xx/xx. |已达到当前地域可创建的 ALB 实例的数量上限。目前已使用xxx，配额为xxx。 | |400 |InvalidIpv6Gateway.InvalidStatus |The specified IPv6Gateway of VPC is not in the correct status for the request. |指定的 VPC 对应的 IPv6 网关所处状态无法响应该请求。 | |400 |InvalidIpv6EipBillingConfig.Bandwidth.Malformed |The specified Ipv6EipBillingConfig.Bandwidth is malformed. |指定的 Ipv6EipBillingConfig.Bandwidth 参数格式不合法。 | |400 |OperationFailed.QueryIpv6Gateway |The request on the specified resource failed due to the query on ipv6 gateway failed. |因请求 IPv6 网关失败，对于该资源的操作请求失败。 | |400 |OperationFailed.QueryIAM |The request on the specified resource failed due to the query on IAM failed. |因请求 IAM 失败，对于该资源的操作请求失败。 | |400 |InvalidIpv6EipBillingConfig.BillingType.Malformed |The specified Ipv6EipBillingConfig.BillingType is malformed. |指定的 Ipv6EipBillingConfig.BillingType 参数格式不合法。 | |400 |InvalidIpv6EipBillingConfig.ISP.Malformed |The specified Ipv6EipBillingConfig.ISP is malformed. |指定的 Ipv6EipBillingConfig.ISP 参数格式不合法。 | |400 |InvalidISPForEip.BandwidthPackageMismatch |The specified ISP for EIP and BandwidthPackage do not match. |指定的 EIP 与共享带宽包的 ISP 不匹配。 | |400 |OperationDenied.Ipv6NotEnabled |The request on the specified LoadBalancer is denied due to the vpc does not have an IPv6 gateway. |因待创建的 ALB 实例所在的 VPC 未开通 IPv6 网关，对于该 ALB 实例的操作请求被拒绝。 | |400 |InvalidEipBillingConfig.EipBillingType.Malformed |The specified EipBillingConfig.EipBillingType is malformed. |指定的 EipBillingConfig.EipBillingType 参数格式不合法。 | |400 |QuotaExceed.Eni |You've reached the limit on the number of Eni that you can create. |已达到创建弹性网卡的数量上限。 | |403 |Forbidden |You are not authorized to clone LoadBalancer. |您无权限复制 ALB 实例。 | |404 |InvalidLoadBalancer.NotFound |The specified LoadBalancer does not exist. |指定的 ALB 实例不存在。 | |400 |InvalidLoadBalancer.InvalidStatus |The specified LoadBalancer is not in the correct status for the request. |指定的 ALB 实例所处状态无法响应该请求。 | |400 |OperationDenied.CloneLoadBalancer |The request on the specified LoadBalancer is denied due to the LoadBalancer is associated with different EIP attributes. |因 ALB 实例绑定的 EIP 属性不一致，对于该 ALB 实例的操作请求被拒绝。 | |404 |InvalidTopic.NotFound |The specified Topic does not exist. |指定的日志主题不存在。 | |400 |QuotaExceed.ListenerPerInstanceForClone |You've reached the limit on the number of listeners per ALB you can add in for clone, resource {*resource*}, usage {*usage*}/{*tag*}. |已达到每个复制 ALB 实例可创建的监听器的数量上限。资源是{*resource*}，目前已使用{*usage*}，配额为{*tag*}。 | |400 |QuotaExceed.ServerPerInstanceForClone |You've reached the limit on the number of backend servers per ALB you can associate with for clone, resource {*resource*}, usage {*usage*}/{*tag*}. |已达到每个复制实例可关联的后端服务器的数量上限。资源是{*resource*}，目前已使用{*usage*}，配额为{*tag*}。 | |400 |QuotaExceed.RulePerInstanceForClone |You've reached the limit on the number of rules per ALB you can create in for clone, resource {*resource*}, usage {*usage*}/{*tag*}. |已达到每个复制实例可创建转发规则的数量上限。资源是{*resource*}，目前已使用{*usage*}，配额为{*tag*}。 | |400 |QuotaExceed.ListenerPerAcl |You've reached the limit on the number of listeners per ACL you can associate with, resource {*resource*}, usage {*usage*}/{*tag*}. |已达到每个 ACL 可关联的监听器的数量上限。资源是{*resource*}，目前已使用{*usage*}，配额为{*tag*}。 | |400 |QuotaExceed.ListenerPerCustomizedCfg |You've reached the limit on the number of listeners per CustomizedCfg you can associate with, resource {*resource*}, usage {*usage*}/{*tag*}. |已达到每个个性化配置可关联的监听器的数量上限。资源是{*resource*}，目前已使用{*usage*}，配额为{*tag*}。 | |400 |QuotaExceed.RulePerGroup |You've reached the limit on the number of rules per server group you can associate with, resource {*resource*}, usage {*usage*}/{*tag*}. |已达到每个服务器组可关联转发规则的数量上限。资源是{*resource*}，目前已使用{*usage*}，配额为{*tag*}。 | |404 |InvalidEip.NotFound |The specified EIP does not exist. |指定的 EIP 不存在。 |