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	預付費公網執行個體的購買時間長度，取值：如果PricingCycle為month，取值為1~9。如果PricingCycle為year，取值為1~3。说明該參數僅適用於中國站。
InternetChargeType	String	否	paybytraffic	公網類型執行個體的付費方式。取值： 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：隨用隨付。
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****"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。