全部产品
存储与CDN 数据库 安全 应用服务 数加·人工智能 数加·大数据基础服务 互联网中间件 视频服务 阿里云办公 培训与认证 物联网
负载均衡

CreateLoadBalancer

更新时间:2017-09-13 18:49:46

描述

创建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"
    9. }
本文导读目录