通过OpenAPI创建ALB实例时指定私网IP-负载均衡-阿里云

如果您对地址管理有诉求并需要为应用型负载均衡ALB实例指定私网IP，您可以通过阿里云OpenAPI开发者门户，在创建公网或私网ALB实例时，在ALB实例所属的每个交换机网段中指定一个IPv4地址，作为该ALB实例的私网IP地址。

注意事项

仅支持为IPv4或双栈ALB实例指定私网IPv4地址，不支持为双栈ALB实例指定私网IPv6地址。
创建ALB升级实例，请确保实例所选可用区的交换机中已预留足够的可用IP。ALB实例会从每个指定的交换机中分配3个IP地址，包含1个VIP（对外提供服务）和2个Local IP（用于与后端服务器通信），如果IP不足会出现报错并且无法创建实例；升级前的ALB实例不受该限制。
为确保ALB升级实例各项弹性能力可用，建议您在ALB实例所在的每个交换机内预留至少8个IP地址。
- 调用DescribeZones可查看ALB实例指定地域支持的可用区。
- 调用DescribeVSwitches可查看已创建的交换机及网段。

操作步骤

登录OpenAPI开发者门户。

在CreateLoadBalancer接口调用页面，设置用于创建ALB实例的请求参数。本文以服务地址选择华东1（杭州）为例。

此处仅列出主要参数的配置，其余参数的配置请参见CreateLoadBalancer。

参数	说明	本文示例值
VpcId	ALB实例的专有网络ID。您可登录专有网络管理控制台，在顶部菜单栏选择华东1（杭州）地域，在专有网络页面找到并查看目标VPC的ID。	vpc-bp1wfo2ytjbr9zs3y****
AddressType	ALB实例的IPv4地址类型。 Internet：实例具有公网IP地址，DNS域名被解析到公网IP，因此可以在公网环境访问。 Intranet：实例只有私网IP地址，DNS域名被解析到私网IP，因此只能被ALB实例所在VPC的内网环境访问。本文支持输入Internet和Intranet，您可以按需配置。	Intranet
LoadBalancerName	ALB实例名称。	ALB-test01
ZoneMappings	可用区及交换机映射列表。若当前地域支持2个及以上的可用区，为保障业务高可用，请至少选择2个可用区。 VSwitchId：可用区对应的交换机ID。您可以通过调用DescribeVSwitches查询交换机ID。 ZoneId：可用区ID。您可以通过调用DescribeZones查询可用区ID。 IntranetAddress：IPv4私网地址。重要指定ALB实例的私网IP地址时，请注意该地址必须包含在交换机的目标网段内，且未被占用。您可登录专有网络管理控制台，在顶部菜单栏选择华东1（杭州）地域，在专有网络页面单击目标VPC的ID。在资源管理页签，单击交换机的个数，查看交换机的ID及网段。	本文以添加可用区G和可用区I为例进行说明，您可以根据ALB实例的实际可用区数量进行配置。可用区G的参数配置： ZoneMappings.1.VSwitchId：vsw-bp1jiciza3mpuyphn** ZoneMappings.1.ZoneId：cn-hangzhou-g ZoneMappings.1.IntranetAddress：192.168.1.13 可用区I的参数配置： ZoneMappings.0.VSwitchId：vsw-bp1uwoih7uwew975k ZoneMappings.0.ZoneId：cn-hangzhou-i ZoneMappings.0.IntranetAddress**：192.168.0.230
LoadBalancerEdition	应用型负载均衡的版本，不同版本有不同功能限制和计费策略。取值： Basic：基础版。 Standard：标准版。 StandardWithWaf：WAF增强版。	Basic
AddressAllocatedMode	地址模式。取值： Fixed（默认值）：固定IP模式，表示每个可用区分配固定IP地址。 Dynamic：动态 IP 模式，表示每个可用区动态分配 IP 地址。说明自北京时间2025年2月25日00:00:00起，通过本文所述接口CreateLoadBalancer新建实例时，无论您指定何种模式，实际均创建为ALB升级实例，不再区分IP模式，分配的IP地址具备自动弹性能力；升级前的ALB实例不受影响。	Fixed
LoadBalancerBillingConfig	应用型负载均衡实例计费配置。 PayType：实例的计费类型。仅取值PostPay：表示按量计费。 BandwidthPackageId：公网类型实例关联的共享带宽包ID。	PayType：PostPay。 BandwidthPackageId：按需配置。
AddressIpVersion	协议版本。取值： IPv4（默认值）：IPv4类型。 DualStack：双栈类型。本文支持输入IPv4和DualStack，您可以按需配置。输入DualStack时，请确保ALB实例所在的交换机已开启IPv6功能。更多信息，请参见交换机开通IPv6。	IPv4

单击发起调用。
返回结果如下。如果返回结果的状态码是200，表示实例创建成功。如果是其他状态码，请参考返回的message信息或者ALB状态码说明进行排查。
```
{
  "RequestId": "0A1F39B6-4BDE-5923-A3BE-E98708413D1B",
  "LoadBalancerId": "alb-gokux4i116yiqf****"
}
```
调用成功后，您可以通过GetLoadBalancerAttribute接口，查看已创建的ALB实例的具体参数信息，该实例的可用区VIP即为您指定的私网IP地址。
可选：调用成功后，您也可登录应用型负载均衡ALB控制台查看私网IP地址为192.168.1.13和192.168.0.230的实例的参数信息。
1. 在顶部菜单栏，选择华东1（杭州）地域。
2. 在实例页面，找到新创建的实例，单击该实例ID。
3. 在实例详情页签，可查看到该实例的可用区VIP为您指定的私网IP地址。

注意事项

操作步骤

相关文档