CreateLoadBalancer

描述


创建LoadBalancer，根据参数生成负载均衡实例，分配服务地址和LoadBalancerId。AddressType指定分配的服务地址是公网IP还是内网IP。
创建实例需要通过实名认证。没有通过实名认证的可以前往 www.aliyun.com中的用户中心—>会员信息中进行实名认证。
注意：如果不指定实例规格参数（LoadBalancerSpec），则默认生成最小规格实例（slb.s1.small规格）。因此建议在创建负载均衡实例时，指定规格参数（LoadBalancerSpec）来创建指定规格的实例。

请求参数


                                                                                                                                                                                                                                                                                                                                                                                                                                                                                  

名称	类型	是否必须	描述
Action	String	是	操作接口名，系统规定参数。 取值：CreateLoadBalancer。
RegionId	String	是	负载均衡实例的所属地域。 取值：从DescribeRegions的返回值中选取。
LoadBalancerSpec	String	否	负载均衡实例的规格。 取值：slb.s1.small/slb.s2.small/ slb.s2.medium/slb.s3.small/ slb.s3.medium/slb.s3.large/ 默认值：slb.s1.small 每个地域支持的规格不同，目前开放的美东1地域只支持前两个规格代码；在未开放性能保障型实例售卖的地域，传值不生效。
ResourceGroupId	String	否	企业资源组ID。
LoadBalancerName	String	否	负载均衡实例的显示名称。 取值：用户自定义字符串。长度限制为1-80个字符，允许包含字母、数字、‘-’、‘/’、‘.’、‘_’这些字符。 默认值：无。 不指定该参数时，默认由系统分配一个实例名称。
AddressType	String	否	Address类型。 取值：internet | intranet 默认值：internet。
VSwitchId	String	视情况而定	负载均衡 VPC实例的VSwitchId。该参数用户提供，用户需要先创建VPC和VSwitch才能获得VSwitchId。
InternetChargeType	String	否	公网类型实例付费方式。 取值：paybybandwidth | paybytraffic 默认值：paybytraffic。
Bandwidth	Integer	否	按固定带宽计费方式的公网类型实例的带宽峰值。针对按固定带宽计费方式的公网类型实例，需要将当前设定值通过Listener上的Bandwidth参数进行分配后才能生效；针对按使用流量计费方式的公网类型实例的带宽峰值，请直接通过Listener上Bandwidth参数进行设定，此时本参数会被忽略。 取值：1-1000（单位为Mbps） 默认值：1   注：私网实例系统会统一按流量计费设置。
ClientToken	String	否	用于保证请求的幂等性。由客户端生成该参数值，要保证在不同请求间唯一，最大不值过64个ASCII字符。 注：该参数命名规则限制同LoadBalancerName 取值限制。 具体参见附录：如何保证幂等性。
MasterZoneId	String	否	该创建实例的主可用区ID，通过DescribeZone接口可查到相应Region下的主备可用区信息。
SlaveZoneId	String	否	该创建实例的备可用区ID，通过DescribeZone接口可查到相应Region下的主备可用区信息。

返回参数


                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    

名称	类型	描述
<公共参数>		详见 <公共返回参数>。
LoadBalancerId	String	负载均衡实例的唯一标识。
Address	String	系统分配的服务地址。用户可以选择该服务地址是否对外公开，来分别创建公网和内网的负载均衡服务。
VpcId	String	负载均衡实例的VPC唯一标识。
VSwitchId	String	负载均衡实例的VPC所属VSwitch标识。
MasterZoneId	String	该实例的主可用区。
SlaveZoneId	String	该实例的备可用区。
LoadBalancerName	String	负载均衡实例别名。
LoadBalancerSpec	String	负载均衡的实例规格，若是不带规格的性能共享型实例，则该返参为空。

示例



请求示例

1.     https://slb.aliyuncs.com/
2.     &Action=CreateLoadBalancer
3.     &RegionId=cn-east-hangzhou-01
4.     &LoadBalancerName=abc
5.     &AddressType=internet
6.     &InternetChargeType=paybytraffic
7.     &<公共请求参数>

返回示例

• 
  XML格式
  1.       <?xml version="1.0" encoding="UTF-8"?>
  2.       <CreateLoadBalancerResponse>
  3.           <RequestId>365F4154-92F6-4AE4-92F8-7FF34B540710</RequestId>
  4.           <LoadBalancerId>139a00604ad-cn-east-hangzhou-01</LoadBalancerId>
  5.           <Address>42.250.6.36</Address>
  6.           <NetworkType>classic<NetworkType>
  7.           <MasterZoneId>cn-hangzhou-b<MasterZoneId>
  8.           <SlaveZoneId>cn-hangzhou-d<SlaveZoneId>
  9.           <LoadBalancerName>abc</LoadBalancerName>
  10.       </CreateLoadBalancerResponse>
• 
  JSON格式
  1.       {
  2.       "RequestId":"365F4154-92F6-4AE4-92F8-7FF34B540710",
  3.       "LoadBalancerId":"139a00604ad-cn-east-hangzhou-01",
  4.       "Address":"42.250.6.36",
  5.       "NetworkType":"classic"
  6.       "MasterZoneId":"cn-hangzhou-b",
  7.       "SlaveZoneId":"cn-hangzhou-d",
  8.       "LoadBalancerName":"abc"
  10.       }