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

调用该接口创建实例时,请注意:

  • 实例创建后,会产生费用。
  • 如果不指定实例规格LoadBalancerSpec,则创建性能共享型实例。建议在创建负载均衡实例时,通过规格参数LoadBalancerSpec指定实例的规格。

调试

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

请求参数

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

要执行的操作。

取值:CreateLoadBalancer

RegionId String cn-hangzhou

负载均衡实例的地域。

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

Address String 192.168.0.1

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

AddressIPVersion String ipv4

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

AddressType String internet

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

  • internet:创建公网负载均衡实例后,系统会分配一个公网IP地址,可以转发公网请求。
  • intranet:创建内网负载均衡实例后,系统会分配一个内网IP地址,仅可转发内网请求。
AutoPay Boolean true

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

取值:true|false(默认)

说明 该参数仅适用于中国站。
Bandwidth Integer 10

监听的带宽峰值。

ClientToken String 5A2CFF0E-5718-45B5-9D4D-70B3FF3898

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

DeleteProtection String on

是否开启实例删除保护。

Duration Integer 1

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

  • 如果PricingCyclemonth,取值为1~9
  • 如果PricingCycleyear,取值为1~3
说明 该参数仅适用于中国站。
InternetChargeType String paybytraffic

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

  • paybybandwidth:按带宽计费。
  • paybytraffic:按流量计费(默认值)。
LoadBalancerName String abc

负载均衡实例的名称。

长度为2-128个英文或中文字符,必须以大小字母或中文开头,可包含数字,点号(.),下划线(_)和短横线(-)。

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

LoadBalancerSpec String slb.s2.small

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

  • slb.s1.small
  • slb.s2.small
  • slb.s2.medium
  • slb.s3.small
  • slb.s3.medium
  • slb.s3.large

每个地域支持的规格不同。

目前支持性能保障型实例的地域有:华北 1(青岛)、华北 2(北京)、华东 1(杭州)、华东 2(上海)、华南 1(深圳)、华北 3(张家口)、华北 5 (呼和浩特)、亚太东南 1(新加坡)、英国(伦敦)、欧洲中部 1(法兰克福)、亚太东南 2(悉尼)、亚太东南 3(吉隆坡)、中东东部 1(迪拜)、亚太东南 5(雅加达)、美西 1(硅谷)、亚太南部 1(孟买)、亚太东北 1(东京)、香港和美东 1(弗吉尼亚)。关于每种规格的说明,参见性能保障型实例

说明 若不指定规格,则创建性能共享型实例。
MasterZoneId String cn-hangzhou-b

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

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

PayType String PayOnDemand

实例的计费类型,取值:

  • PayOnDemand:按量付费。
  • PrePay:预付费。
PricingCycle String month

预付费公网实例的计费周期,取值:month|year

说明 仅适用于中国站。
ResourceGroupId String rg-atstuj3rtopt****

企业资源组ID。

SlaveZoneId String cn-hangzhou-d

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

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

VSwitchId String vsw-bp12mw1f8k3jgy*****

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

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

VpcId String vpc-bp1aevy8sofi8mh1*****

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

返回数据

名称 类型 示例值 描述
LoadBalancerId String 139a00604ad-cn-east-hangzhou-01

负载均衡实例的ID。

Address String 42.250.6.36

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

VpcId String vpc-25dvzy9f8

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

VSwitchId String vsw-255ecr***

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

LoadBalancerName String abc

负载均衡实例的名称。

AddressIPVersion String ipv4

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

NetworkType String classic

负载均衡实例网络类型。

OrderId Long 201429619788910

订单ID。

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

请求ID。

ResourceGroupId String rg-atstuj3rtoptyui

企业资源组ID。

示例

请求示例


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

正常返回示例

XML 格式

<CreateLoadBalancerResponse>
    <NetworkType>vpc</NetworkType>
	  <LoadBalancerName>abc</LoadBalancerName>
	  <Address>192.168.0.6</Address>
	  <ResourceGroupId>rg-acfmxazb***</ResourceGroupId>
	  <RequestId>AB197CF0-D9E9-4475-A89D-35DBCCF13BBE</RequestId>
	  <AddressIPVersion>ipv4</AddressIPVersion>
	  <LoadBalancerId>lb-bp1b6c719dfa0***</LoadBalancerId>
	  <VSwitchId>vsw-bp12mw1f8k3jgygk9****</VSwitchId>
	  <VpcId>vpc-bp1aevy8sofi8mh1q***</VpcId>
</CreateLoadBalancerResponse>

JSON 格式

{
	"NetworkType":"vpc",
	"LoadBalancerName":"abc",
	"RequestId":"AB197CF0-D9E9-4475-A89D-35DBCCF13BBE",
	"ResourceGroupId":"rg-acfmxazb4ph****",
	"Address":"192.168.0.6",
	"AddressIPVersion":"ipv4",
	"LoadBalancerId":"lb-bp1b6c719dfa08ex****",
	"VSwitchId":"vsw-bp12mw1f8k3jgygk9****",
	"VpcId":"vpc-bp1aevy8sofi8mh1****"
}

错误码

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