调用CreateLoadBalancer创建负载均衡实例。

注意事项:

  • 实例创建前,请调用DescribeAvailableResource查询可用区支持的资源售卖情况。
  • 实例创建后,会产生费用。
  • 如果不指定实例规格LoadBalancerSpec,则创建性能共享型实例。建议在创建负载均衡实例时,通过规格参数LoadBalancerSpec指定实例的规格。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String CreateLoadBalancer

要执行的操作。

取值:CreateLoadBalancer

RegionId String cn-hangzhou

负载均衡实例的地域ID。

您可以通过调用DescribeRegions接口查询地域ID。

AddressType String internet

负载均衡实例的网络类型。取值:

  • internet:创建公网负载均衡实例后,系统会分配一个公网IP地址,可以转发公网请求。
  • intranet:创建专有网络类型的负载均衡实例后,系统会分配一个内网IP地址,仅可转发内网请求。
InternetChargeType String paybytraffic

公网类型实例的付费方式。取值:

  • paybytraffic(默认值):按流量计费。
Bandwidth Integer 10

监听的带宽峰值,单位Mbps。

取值:-11~5120

  • -1:对于按流量计费的公网负载均衡实例,可以将带宽峰值设置为-1,即不限制带宽峰值。
  • 1~5120: 对于按带宽计费的公网负载均衡实例,可以设置每个监听的带宽峰值,但所有监听的带宽峰值之和不能超过实例的带宽峰值。
ClientToken String 593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3

用于保证请求的幂等性。由客户端生成该参数值,要保证在不同请求间唯一,最大不超过64个ASCII字符。

说明 若您未指定,则系统自动使用API请求的RequestId作为ClientToken标识。每次API请求的RequestId可能不一样。
LoadBalancerName String lb-bp1o94dp5i6ea****

负载均衡实例的名称。

长度为1~80个英文或中文字符,必须以大小写字母或中文开头,可包含数字、半角句号(.)、下划线(_)和短划线(-)。

不指定该参数时,默认由系统分配一个实例名称。

VpcId String vpc-bp1aevy8sofi8mh1****

负载均衡实例的所属的VPC ID。

VSwitchId String vsw-bp12mw1f8k3jgy****

专有网络实例的所属的交换机ID。

创建专有网络类型的负载均衡实例,必须指定该参数。如果指定了该参数,AddessType参数的值会默认被设置为intranet

MasterZoneId String cn-hangzhou-b

负载均衡实例的主可用区ID。

您可以通过调用DescribeZone接口可查到相应地域下的主备可用区信息。

SlaveZoneId String cn-hangzhou-d

负载均衡实例的备可用区ID。

您可以通过调用DescribeZone接口查询相应地域下的主备可用区信息。

LoadBalancerSpec String slb.s1.small

负载均衡实例的规格。取值:

  • slb.s1.small
  • slb.s2.small
  • slb.s2.medium
  • slb.s3.small
  • slb.s3.medium
  • slb.s3.large
    说明 若不指定规格,则创建性能共享型实例。目前,共享型实例已停止售卖,请指定实例规格。
ResourceGroupId String rg-atstuj3rtopt****

企业资源组ID。

PayType String PayOnDemand

实例的计费类型,取值:

  • PayOnDemand:按量付费。
PricingCycle String month

预付费公网实例的计费周期,取值:monthyear

说明 该参数仅适用于中国站且仅对包年包月实例有效,即PayType的参数值为PrePay时有效。
Duration Integer 1

预付费公网实例的购买时长,取值:

  • 如果PricingCyclemonth,取值为1~9
  • 如果PricingCycleyear,取值为1~3
说明 该参数仅适用于中国站且仅对包年包月实例有效,即PayType的参数值为PrePay时有效。
AutoPay Boolean true

是否是自动支付预付费公网实例的账单。取值:

  • true:自动支付。调用API后,马上生成SLB实例。
  • false(默认):默认选择。调用API后SLB的订单创建成功,但是未支付。您可以在控制台看到未支付订单。由于订单未支付,SLB实例不会被创建出来。
说明 该参数仅适用于中国站且仅对包年包月实例有效,即PayType的参数值为PrePay时有效。
AddressIPVersion String ipv4

负载均衡实例的IP版本,可以设置为ipv4或者ipv6

Address String 192.XX.XX.6

指定负载均衡实例的私网IP地址,该地址必须包含在交换机的目标网段下。

DeleteProtection String on

是否开启实例删除保护。

ModificationProtectionStatus String ConsoleProtection

负载均衡修改保护状态:

  • NonProtection:不限制修改保护,设置后会清空之前设置的ModificationProtectionReason
  • ConsoleProtection:实例控制台修改保护状态。
ModificationProtectionReason String 托管实例

设置修改保护状态的原因,长度为1~80个字符,必须以字母或中文开头,支持数字、半角句号(.)、下划线(_)和短划线(-)。

说明 仅在ModificationProtectionStatusConsoleProtection时有效。

返回数据

名称 类型 示例值 描述
LoadBalancerId String lb-hddhfjg****

负载均衡实例的ID。

Address String 42.XX.XX.6

分配的负载均衡实例的IP地址。

VpcId String vpc-25dvzy9****

负载均衡实例的所属专有网络的ID。

VSwitchId String vsw-255ecr****

负载均衡实例的所属交换机的ID。

LoadBalancerName String lb-bp1o94dp5i6ea****

负载均衡实例的名称。

AddressIPVersion String ipv4

负载均衡实例的IP地址类型。

NetworkType String classic

负载均衡实例的网络类型,取值:vpcclassic

  • vpc:专有网络实例。
  • classic:经典网络实例。
OrderId Long 201429619788910

预付费实例的订单ID。

RequestId String 365F4154-92F6-4AE4-92F8-7FF34B540710

请求ID。

ResourceGroupId String rg-atstuj3rto****

企业资源组ID。

示例

请求示例

http(s)://[Endpoint]/?Action=CreateLoadBalancer
&RegionId=cn-hangzhou
&<公共请求参数>

正常返回示例

XML格式

<LoadBalancerName>lb-bp1o94dp5i6ea****</LoadBalancerName>
<VpcId>vpc-25dvzy9****</VpcId>
<Address>42.XX.XX.6</Address>
<ResourceGroupId>rg-atstuj3rto****</ResourceGroupId>
<RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
<NetworkType>classic</NetworkType>
<AddressIPVersion>ipv4</AddressIPVersion>
<VSwitchId>vsw-255ecr****</VSwitchId>
<LoadBalancerId>lb-hddhfjg****</LoadBalancerId>
<OrderId>201429619788910</OrderId>

JSON格式

{"LoadBalancerName":"lb-bp1o94dp5i6ea****","VpcId":"vpc-25dvzy9****","Address":"42.XX.XX.6","ResourceGroupId":"rg-atstuj3rto****","RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710","NetworkType":"classic","AddressIPVersion":"ipv4","VSwitchId":"vsw-255ecr****","LoadBalancerId":"lb-hddhfjg****","OrderId":"201429619788910"}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidVSwitchId.NotFound The specified vSwitch instance is invalid. 非法的vswitch实例。

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