负载均衡
负载均衡
传统型负载均衡CLB
请输入
- 文档首页
负载均衡API参考CLB实例CreateLoadBalancer - 创建负载均衡
复制全文
下载 pdfCreateLoadBalancer - 创建负载均衡
文档反馈
问问助手调用 CreateLoadBalancer 接口，创建一个CLB实例。
使用说明
调试
API Explorer
您可以通过 API Explorer 在线发起调用，无需关注签名生成过程，快速获取调用结果。
请求参数
Action String 必选 示例值：CreateLoadBalancer
要执行的操作，取值：CreateLoadBalancer。
Version String 必选 示例值：2020-04-01
API的版本信息，当前版本为 2020-04-01。
ExclusiveClusterId String 可选 示例值：ec-bp1o94dp5i6ea****
CLB实例所属独占集群的ID。
- 您可以调用DescribeExclusiveClusters接口，查询独占集群的ID。
- 仅创建独占集群类型的CLB实例时，传入本参数。
说明
独占集群功能正在邀测中，暂仅支持完成企业认证的账号申请试用，如需试用，请联系客户经理。
RegionId String 必选 示例值：cn-shanghai
请求的Region。
ZoneType String 可选 示例值：active-standby
CLB实例的可用区类型。
- single：单可用区。
- active-standby：主备可用区。
- 不填时，若指定地域为单可用区部署，则默认为“single”；若指定地域为多可用区部署，则默认为“active-standby”。
说明
负载均衡支持单可用区部署的功能正在邀测中，如需试用，请联系客户经理。
MasterZoneId String 可选 示例值：cn-shanghai-a
- 取值不能与SlaveZoneId参数取值相同。
- 不填则默认分配子网所在可用区为主可用区。
SlaveZoneId String 可选 示例值：cn-beijing-b
CLB实例的备可用区ID。
- 如果传入该参数，则参数MasterZoneId必须传入，且取值不能与MasterZoneId参数相同。
- 不填则情况如下：
- 若指定地域为单可用区部署，则本参数为空，创建单可用区CLB实例。
- 若指定地域为多可用区部署，且ZoneType配置为“single”，则本参数为空，创建单可用区CLB实例。
- 若指定地域为多可用区部署，且ZoneType配置为“active-standby”，则根据指定地域支持的可用区随机分配备可用区。
LoadBalancerName String 可选 示例值：clb-test
CLB实例的名称。
- 必须以字母、数字或中文开头，可包含字母、数字、中文及以下特殊字符：点（.）、下划线（_）和中划线（-）。
- 长度限制为1 ～ 128个字符。
- 不填则默认为实例ID。
Description String 可选 示例值：This is a LB.
CLB实例的描述。
- 必须以字母、数字或中文开头，可包含字母、数字、中文及以下特殊字符：英文逗号（,）、点（.）、下划线（_）、空格（ ）、等号（=）、中划线（-）、中文逗号（，）、中文句号（。）。
- 长度限制为0 ～ 255个字符。
- 不填则默认值为空字符串
LoadBalancerBillingType Integer 可选 示例值：2
CLB实例计费方式。取值如下：
- 1：包年包月
- 2（默认值）：按量计费-按规格计费
- 3：按量计费-按使用量计费
说明
按使用量计费正在邀测中，如需试用，请联系客户经理。
PeriodUnit String 可选 示例值：Month
购买包年包月CLB实例的时长单位。
仅LoadBalancerBillingType取1时，本参数有效。取值如下：
- Month (默认值)：月
- Year：年
Period Integer 可选 示例值：1
购买包年包月CLB实例的时长。默认为“1”。
- 当PeriodUnit配置为Month时，取值范围为1～9，12，24和36。
- 当PeriodUnit配置为Year时，取值范围为1～3。
LoadBalancerSpec String 可选 示例值：small_1
- small_1：小型I
- small_2：小型II
- medium_1：中型I
- medium_2：中型II
- large_1：大型I
- large_2：大型II
说明
参数LoadBalancerBillingType传入3时，该参数无需传入，默认为clb_lcu（表示单实例默认最大提供100万并发连接、10万新建连接、10Gbps出入带宽和10万QPS）。
Type String 必选 示例值：private
CLB实例的类型。取值如下：
- public：公网类型。创建一个公网类型CLB实例，系统会分配一个公网IP地址，用于转发公网请求。
- private：私网类型。创建一个私网类型CLB实例，您需要为其绑定公网IP后，才能转发公网请求。
AddressIpVersion String 可选 示例值：ipv4
CLB实例的IP地址类型。取值如下：
- ipv4（默认值）：表示该CLB为IPv4类型，仅支持转发IPv4请求。
- DualStack：表示该CLB为双栈类型，支持转发IPv4和IPv6请求。仅参数Type取private时，才可传入DualStack。
VpcId String 可选 示例值：vpc-bp1aevy8sofi8mh1****
CLB实例所属的VPC ID。
- 您可以调用 DescribeVpcs接口，查询VPC的ID。
- 不传默认为子网所属的VPC ID。
SubnetId String 必选 示例值：subnet-bp12mw1f8k3jgy****
CLB实例所属VPC内的子网ID。
- CLB实例的私网IP地址将从该子网网段中分配。
- 您可以调用 DescribeSubnets 接口，查询子网ID。
EniAddress String 可选 示例值：192.XX.XX.06
CLB实例的私网IPv4地址。
- 从子网中指定一个空闲的IPv4地址。
- 不填则自动从子网中分配一个空闲的IPv4地址。
EniAddressNum Integer 可选 示例值：2
CLB实例的私网IPv4地址数量。从子网自动分配指定数量的空闲的IPv4地址。
- 仅参数Type取private且EniAddress未传入时，本参数有效。
- 取值范围：1～5，默认为1。
- 本参数正在邀测中，暂仅支持完成 企业认证 的账号申请试用，如需试用，请联系客户经理。
EniIpv6Address String 可选 示例值：2408:4005:XX:XX:200
CLB实例的私网IPv6地址。
- 参数AddressIpVersion取DualStack时，本参数有效。
- 从子网中指定一个空闲的私网IPv6地址。
- 不填自动从子网中分配一个空闲的私网IPv6地址。
EipBillingConfig.ISP String 可选 示例值：BGP
公网IP线路类型。
仅参数Type取public，本参数有效。取值如下：
- BGP（默认值）：BGP多线
- ChinaMobile：中国移动静态单线
- ChinaTelecom：中国电信静态单线
- ChinaUnicom：中国联通静态单线
- SingleLine_BGP：BGP单线
- Static_BGP：静态BGP
说明
除BGP（多线）外，其他线路类型均在邀测中，如需试用，请联系客户经理。
EipBillingConfig.EipBillingType Integer 可选 示例值：2
公网IP的计费方式。
仅参数Type取public，本参数有效。
- 参数LoadBalancerBillingType取1时，本参数必填且为1，表示包年包月。
- 参数LoadBalancerBillingType取2或3时：
- 2：按量计费-按带宽上限计费。
- 3：按量计费-按实际流量计费。
- 不填则默认为2。
EipBillingConfig.Bandwidth Integer 可选 示例值：10
公网IP的带宽上限，默认值为1，单位为Mbps。
- 参数EipBillingConfig.EipBillingType取值为2时，带宽取值范围为1～500。
- 参数EipBillingConfig.EipBillingType取值为3时，带宽取值范围为1～200。
EipBillingConfig.BandwidthPackageId String 可选 示例值：bwp-2zeo05qre24nhrqpy****
公网IP待加入的共享带宽包ID。
- 仅当参数EipBillingConfig.EipBillingType配置为2或3时，本参数有效。
- 您可以调用 DescribeBandwidthPackages 接口，查询共享带宽包ID。
EipBillingConfig.SecurityProtectionTypes.N String 可选 示例值：AntiDDoS_Enhanced
公网IP的安全防护类型。
仅当参数EipBillingConfig.EipBillingType配置为2或3时，本参数有效。取值如下：
- AntiDDoS_Enhanced：增强防护类型，该类型的公网IP可以加入到DDoS原生防护（企业版）实例。
- 不填则表示公网IP为基础防护类型。
参数 - N：表示安全防护类型的序列，当前仅支持取1。
说明
公网IP的增强防护功能正在邀测中，如需试用，请联系客户经理。
EipBillingConfig.SecurityProtectionInstanceId Integer 可选 示例值：20
DDoS原生防护（企业版）实例的ID。
- 参数EipBillingConfig.SecurityProtectionTypes.N取AntiDDoS_Enhanced时，本参数有效且必填。
- 您可以调用 DescInstanceList 接口，查询DDos原生防护（企业版）实例的ID。
ModificationProtectionStatus String 可选 示例值：ConsoleProtection
CLB实例是否开启控制台上修改保护。开启后，禁止通过控制台修改实例或删除实例。取值如下：
- NonProtection：不开启。
- ConsoleProtection：开启。
- 不填默认为空，表示不开启。
ModificationProtectionReason String 可选 示例值：托管实例
设置控制台修改保护的原因。
仅参数ModificationProtectionStatus取ConsoleProtection时，本参数有效。
- 必须以字母、数字或中文开头，可包含字母、数字、中文及以下特殊字符：半角句号（.）、下划线（_）和中划线（-）。
- 长度限制为1 ～ 80个字符。
ProjectName String 可选 示例值：default
CLB实例所属项目的名称。不填则默认加入default项目。
Tags.N.Key String 可选 示例值：key1
用户标签的标签键。
- 参数 - N：表示标签键的序号，取值范围：1～20。
- 多个标签键之间用&分隔。
- 不能以 volc:或sys:开头，包括任意大小写形式。
- 长度取值范围为1~128字符，允许输入各国语言文字、数字、空格（ ）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。
- 若标签键开头或结尾存在空格，系统会自动为其去除。
说明
同一资源的标签键不允许重复。
Tags.N.Value String 可选 示例值：value1
用户标签的标签值。
- 参数 - N：表示标签值的序号，取值范围：1～20。
- 多个标签值之间用&分隔。
- 长度取值范围为0～256字符，不填默认为空。
- 允许输入各国语言文字、数字、空格（ ）、下划线（_）、点号（.）、半角冒号（:）、斜杠（/）、等号（=）、加号（+）、中划线（-）和@（@）。
- 大小写敏感。
- 若标签值开头或结尾存在空格，系统会自动为其去除。
说明
若传入该参数，则必须先传入Tags.N.Key。
BypassSecurityGroupEnabled String 可选 示例值：off
CLB实例是否开启“放通后端安全组”功能。
- on：开启。开启之后，后端服务器组（仅服务器类型）中的云服务器的安全组不再校验CLB的流量，默认放通。
- off（默认）：未开启。
说明
本功能正在邀测中，如需试用，请联系客户经理。
TimestampRemoveEnabled String 可选 示例值：off
是否开启清除TCP/HTTP/HTTPS报文的timestamp（即时间戳）的功能。
- on：开启。
- off（默认）：不开启。
说明
本功能正在邀测中，如需试用，请联系客户经理。
ClientToken String 可选 示例值：123e4567-e89b-12d3-a456-42665544****
客户端Token，用于保证请求的幂等性。
- 该参数值由客户端自动生成，确保不同请求的取值唯一，避免当调用API超时或服务器内部错误时，客户端多次重试导致重复性操作。
- 取值仅支持ASCII字符，最大不超过64个字符。
- 未指定该参数值时，不进行幂等校验。
返回参数
LoadBalancerId String 示例值：clb-bp1o94dp5i6ea****
CLB实例ID。
RequestId String 示例值：20210811152539010225146063030****
请求ID。
OrderId String 示例值：Order705261343570982****
订单ID。
说明
仅在参数LoadBalancerBillingType配置为1时，返回该参数。
请求示例
返回示例
错误码
最近更新时间：2026.10.26 18:34:43
这个页面对您有帮助吗？
有用
有用
无用
无用