Server Load Balancer:CreateLoadBalancer-Server Load Balancer-Alibaba Cloud - Server Load Balancer

Membuat instans Classic Load Balancer (CLB).

Deskripsi operasi

Catatan

Before you create a CLB instance, call the operation to query the resources available for purchase in the region where you want to create the CLB instance.
After a CLB instance is created, you are charged for using the CLB instance.
Pay-as-you-go CLB instances only support the pay-by-LCU instance resource metering method. As of 00:00:00 (UTC+8) on June 1, 2025, pay-by-specification CLB instances are no longer available for purchase. For more details, see .

Coba sekarang

Coba API ini di OpenAPI Explorer tanpa perlu penandatanganan manual. Panggilan yang berhasil akan secara otomatis menghasilkan contoh kode SDK sesuai dengan parameter Anda. Unduh kode tersebut dengan kredensial bawaan yang aman untuk penggunaan lokal.

Test

RAM authorization

Tabel berikut menjelaskan otorisasi yang diperlukan untuk memanggil API ini. Anda dapat menentukannya dalam kebijakan Resource Access Management (RAM). Kolom pada tabel dijelaskan sebagai berikut:

Action: Aksi yang dapat digunakan dalam elemen Action pada pernyataan kebijakan izin RAM untuk memberikan izin guna melakukan operasi tersebut.
API: API yang dapat Anda panggil untuk melakukan aksi tersebut.
Access level: Tingkat akses yang telah ditentukan untuk setiap API. Nilai yang valid: create, list, get, update, dan delete.
Resource type: Jenis resource yang mendukung otorisasi untuk melakukan aksi tersebut. Ini menunjukkan apakah aksi tersebut mendukung izin tingkat resource. Resource yang ditentukan harus kompatibel dengan aksi tersebut. Jika tidak, kebijakan tersebut tidak akan berlaku.
- Untuk API dengan izin tingkat resource, jenis resource yang diperlukan ditandai dengan tanda bintang (*). Tentukan Nama Sumber Daya Alibaba Cloud (ARN) yang sesuai dalam elemen Resource pada kebijakan.
- Untuk API tanpa izin tingkat resource, ditampilkan sebagai All Resources. Gunakan tanda bintang (*) dalam elemen Resource pada kebijakan.
Condition key: Kunci kondisi yang didefinisikan oleh layanan. Kunci ini memungkinkan kontrol granular, berlaku baik hanya untuk aksi maupun untuk aksi yang terkait dengan resource tertentu. Selain kunci kondisi spesifik layanan, Alibaba Cloud menyediakan serangkaian common condition keys yang berlaku di semua layanan yang didukung RAM.
Dependent action: Aksi dependen yang diperlukan untuk menjalankan aksi tersebut. Untuk menyelesaikan aksi tersebut, pengguna RAM atau role RAM harus memiliki izin untuk melakukan semua aksi dependen.

Action

Access level

Resource type

Condition key

Dependent action

slb:CreateLoadBalancer

create

*LoadBalancer

acs:slb:{#regionId}:{#accountId}:loadbalancer/*

slb:AddressType

None

Parameter permintaan

Parameter	Type	Required	Description	Example
RegionId	string	Yes	ID Wilayah instans CLB. Anda dapat memanggil operasi untuk mengkueri daftar Wilayah terbaru.	cn-hangzhou
AddressType	string	No	Jenis jaringan instans CLB. Nilai valid: internet: Setelah instans CLB yang menghadap Internet dibuat, sistem mengalokasikan alamat IP publik ke instans tersebut. Instans CLB dapat meneruskan permintaan melalui Internet. intranet: Setelah instans CLB yang menghadap internal dibuat, sistem mengalokasikan alamat IP privat ke instans CLB. Instans CLB hanya dapat meneruskan permintaan dalam VPC.	internet
InternetChargeType	string	No	Metode pengukuran transfer data Internet untuk instans CLB yang menghadap Internet. Nilai valid: paybytraffic (default): bayar-per-transfer-data paybybandwidth: bayar-per-bandwidth Catatan Jika Anda menetapkan PayType ke PayOnDemand dan InstanceChargeType ke PayByCLCU, satu-satunya nilai valid untuk InternetChargeType adalah paybytraffic. Jika Anda menetapkan InternetChargeType ke paybytraffic, Anda tidak perlu mengonfigurasi parameter Bandwidth. Nilai Bandwidth tidak berlaku meskipun Anda menentukannya.	paybytraffic
Bandwidth	integer	No	Bandwidth maksimum instans. Unit: Mbit/s. Nilai valid: 1 hingga 5000. Catatan Hanya ketika AddressType ditetapkan ke internet dan InternetChargeType ditetapkan ke paybybandwidth, parameter ini berlaku.	10
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Catatan Jika Anda tidak menentukan parameter ini, sistem menggunakan ID permintaan sebagai token klien. ID permintaan mungkin berbeda untuk setiap permintaan.	593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3
LoadBalancerName	string	No	Nama instans CLB. Nama harus terdiri dari 1 hingga 80 karakter, dan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-). Nama harus diawali dengan huruf. Jika Anda tidak menentukan parameter ini, sistem secara otomatis menetapkan nama ke instans CLB.	lb-bp1o94dp5i6ea****
VpcId	string	No	ID virtual private cloud (VPC) tempat instans CLB berada.	vpc-bp1aevy8sofi8mh1****
VSwitchId	string	No	ID vSwitch tempat instans CLB berada. Jika Anda ingin men-deploy instans CLB di VPC, parameter ini wajib diisi. Jika parameter ini ditentukan, AddessType ditetapkan ke intranet secara default. Catatan vSwitch harus berada di zona primer.	vsw-bp12mw1f8k3jgy****
MasterZoneId	string	No	ID zona primer tempat instans CLB berada. Anda dapat memanggil operasi untuk mengkueri zona primer dan zona sekunder di Wilayah tempat Anda ingin membuat instans CLB. Catatan Zona primer harus merupakan zona tempat vSwitch berada.	cn-hangzhou-b
SlaveZoneId	string	No	ID zona sekunder tempat instans CLB berada. Anda dapat memanggil operasi untuk mengkueri zona primer dan sekunder di Wilayah tempat Anda ingin membuat instans CLB.	cn-hangzhou-d
LoadBalancerSpec	string	No	Spesifikasi instans CLB. Nilai valid: slb.s1.kecil slb.s2.kecil slb.s2.Menengah slb.s3.kecil slb.s3.Menengah slb.s3.Tingkat Tinggi Catatan Jika InstanceChargeType ditetapkan ke PayByCLCU, parameter ini tidak valid dan Anda tidak perlu menentukan parameter ini. Mulai pukul 00:00:00 (UTC+8) pada 1 Juni 2025, instans CLB bayar-per-spesifikasi tidak lagi tersedia untuk dibeli. Untuk detail lebih lanjut, lihat .	slb.s1.small
ResourceGroupId	string	No	ID kelompok sumber daya.	rg-atstuj3rtopt****
PayType `deprecated`	string	No	Metode penagihan instans CLB. Nilai valid: PayOnDemand: bayar-sesuai-pemakaian.	PayOnDemand
PricingCycle `deprecated`	string	No	Siklus penagihan instans CLB langganan yang menghadap Internet. Nilai valid: month year Catatan Parameter ini hanya didukung oleh instans langganan yang dibuat di situs Alibaba Cloud China.	month
Duration `deprecated`	integer	No	Durasi langganan instans CLB yang menghadap Internet. Nilai valid: Jika PricingCycle ditetapkan ke month, nilai valid adalah 1 hingga 9. Jika PricingCycle ditetapkan ke year, nilai valid adalah 1 hingga 5. Catatan Parameter ini hanya didukung oleh instans langganan yang dibuat di situs Alibaba Cloud China.	1
AutoPay `deprecated`	boolean	No	Apakah akan membayar biaya langganan instans CLB yang menghadap Internet secara otomatis. Nilai valid: true: ya. Instans CLB dibuat setelah Anda memanggil operasi API. false (default): Setelah Anda memanggil operasi, pesanan dibuat tetapi pembayaran belum diselesaikan. Anda dapat melihat Pesanan tertunda di Konsol. Instans CLB tidak akan dibuat hingga Anda menyelesaikan pembayaran. Catatan Parameter ini hanya berlaku untuk instans CLB langganan yang dibuat di situs Alibaba Cloud China.	true
AddressIPVersion	string	No	Versi IP instans CLB. Nilai valid: ipv4 dan ipv6.	ipv4
Address	string	No	Alamat IP privat instans CLB. Alamat IP privat harus termasuk dalam Blok CIDR tujuan vSwitch.	192.168.XX.XX
Tag	array<object>	No	Tag.
	object	No	The tags.
Key	string	No	The tag key of the bastion host. Valid values of N: 1 to 20. The tag key cannot be an empty string. The tag key can be at most 64 characters in length, and cannot contain `http://` or `https://`. It must not start with `aliyun` or `acs:`.	test
Value	string	No	The tag value. Valid values of N: 1 to 20. The tag value can be an empty string. The tag value can be up to 128 characters in length and cannot start with `acs:` or `aliyun`. The tag value cannot contain `http://` or `https://`.	value
DeleteProtection	string	No	Apakah akan mengaktifkan perlindungan penghapusan untuk instans CLB. Nilai valid: on off.	on
ModificationProtectionStatus	string	No	Apakah akan mengaktifkan mode baca-saja konfigurasi. Nilai valid: NonProtection: menonaktifkan mode baca-saja konfigurasi. Setelah Anda menonaktifkan mode baca-saja konfigurasi, nilai ModificationProtectionReason dihapus. ConsoleProtection: mengaktifkan mode baca-saja konfigurasi. Catatan Jika Anda menetapkan parameter ini ke ConsoleProtection, Anda tidak dapat mengubah konfigurasi instans di Konsol CLB. Namun, Anda dapat mengubah konfigurasi instans dengan memanggil operasi API.	ConsoleProtection
ModificationProtectionReason	string	No	Alasan mengaktifkan mode baca-saja konfigurasi. Alasan harus terdiri dari 1 hingga 80 karakter. Harus diawali dengan huruf dan dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-). Catatan Parameter ini hanya berlaku ketika ModificationProtectionStatus ditetapkan ke ConsoleProtection.	Managed instance
InstanceChargeType	string	No	Metode pengukuran Sumber daya untuk instans CLB. Nilai valid: PayByCLCU: bayar-per-transfer-data Catatan Mulai pukul 00:00:00 (UTC+8) pada 1 Juni 2025, instans CLB bayar-per-spesifikasi tidak lagi tersedia untuk dibeli. Untuk detail lebih lanjut, lihat .	PayBySpec

Elemen respons

Element	Type	Description	Example
	object
VpcId	string	The ID of the VPC to which the CLB instance belongs.	vpc-25dvzy9****
AddressIPVersion	string	The IP version that is used by the CLB instance.	ipv4
VSwitchId	string	The ID of the vSwitch to which the CLB instance belongs.	vsw-255ecr****
RequestId	string	The request ID.	365F4154-92F6-4AE4-92F8-7FF34B540710
LoadBalancerName	string	The CLB instance name.	lb-bp1o94dp5i6ea****
LoadBalancerId	string	The CLB instance ID.	lb-hddhfjg****
ResourceGroupId	string	The ID of the resource group to which the CLB instance belongs.	rg-atstuj3rto****
Address	string	The IP address that is allocated to the CLB instance.	42.XX.XX.6
NetworkType	string	The network type of the CLB instance. Valid values: vpc: VPC Classic: classic network	classic
OrderId	integer	The order ID of the subscription CLB instance.	20212961978****

Contoh

Respons sukses

JSONformat

{
  "VpcId": "vpc-25dvzy9****",
  "AddressIPVersion": "ipv4",
  "VSwitchId": "vsw-255ecr****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF34B540710",
  "LoadBalancerName": "lb-bp1o94dp5i6ea****",
  "LoadBalancerId": "lb-hddhfjg****",
  "ResourceGroupId": "rg-atstuj3rto****",
  "Address": "42.XX.XX.6",
  "NetworkType": "classic",
  "OrderId": 0
}

Kode kesalahan

HTTP status code	Error code	Error message
400	OperationFailed.ZoneResourceLimit	The operation failed because of resource limit of the specified zone.
400	CloudBoxNotSupportIpv6	The cloudBox instance does not support ipv6.
400	CloudBoxNotSupportInternet	The cloudBox instance does not support internet.
400	OperationFailed.RegionResourceLimit	The operation failed because of resource limit of the specified region.
400	Operation.NotAllowed	Operation Denied. The charge type of internet prepay instance can only be paybybandwidth.
400	OperationFailed.UnpaidBillsExist	The account has unpaid bills. Please pay your overdue bill first.
400	RegionOrZonesNotSupportIpv6	The specified region or master/slave zones does not support ipv6.
400	InvalidParameter.Mismatch	AddressType and IpVersion is conflict, IPv6 does not support intranet instance.
400	PAYFOR.CREDIT_PAY_INSUFFICIENT_BALANCE	Your account does not have enough balance.
400	HighRiskOperationDenied	The operation is denied because of high risk.
400	VSwitchAvailableIpNotExist	The specified VSwitch has no availabe ip.
400	VSwitchNotExist	The specified VSwitch does not exist.
400	InvalidParameter	Illegal parameter. The IP address is not in subnet.
400	Instance.ShareSlbNotSupportPay95	Illegal parameter. The share instance not support PayBy95 or PayByOld95.
400	Instance.Pay95RateInvalid	Illegal parameter. The rate is illegal.
400	Instance.Pay95BandwidthIllegal	Illegal parameter. The bandwidth is illegal.
400	Instance.InternetChargeTypeNotAllowed	Illegal parameter. The specified InternetChargeType not allowed.
400	OperationFailed.TokenIsProcessing	The operation is failed, because the Client Token is processing.
400	InsufficientBalance	Your account does not have enough balance.
400	MissingParam.VSwitchId	The parameter VSwitchId is required.
400	InvalidVpcId.NotExist	The specified VPC not exist.
400	PAY.MAYI_WITHHOLDING_AGREEMENT_ILLEGAL	Your account did not sign a withholding agreement or no coupons in Alipay.
400	InvalidParameter.CloudType	The specified CloudType is invalid.
400	OperationFailed.InvalidAccount	The account information is incomplete.
400	RegionOrZonesNotSupportCEN	The specified region or master/slave zones does not support cloudType of hybrid_cen.
400	MissingParam.LoadBalancerSpec	The param LoadBalancerSpec is required.
400	InvalidParameter.Bandwidth	The param Bandwidth is invalid.
400	OperationForbidden.AccountRiskReject	The operation failed because of account risk reject.
400	OperationForbidden.QuotaLimit	The operation failed because of quota limit of shared loadbalancers.
400	InvalidParam.ModificationProtectionStatus	The param ModificationProtectionStatus is invalid.
400	InvalidParam.ModificationProtectionReason	The param ModificationProtectionReason is invalid.
400	ShareSlbHaltSales	The share instance has been discontinued.
400	OperationFailed.CashBookInsufficient	No payment method is specified for your account, We recommend that you add a payment method or maintain a prepayment balance.
400	OperationFailed.OnlyInnerCommoditySupportToPurchase	AliCroup2Cloud user only can buy inner commodity.
400	OperationFailed.InvokeLingXiaoFailed	Failed to invoke lingxiao service.
400	AllocateVpcInstanceFailed	Failed to allocate vpc instance.
400	QueryCreditCtrlInfoFailed	Failed to query credit ctrl info.
400	QueryCommodityCenterFailed	Failed to query commodity center.
400	RegionNotSupportParameter	Current region does not support the param of %s.
400	QueryAccountBookInfoFailed	Failed to invoke account book info.
400	RateAccountFailed	Failed to rate account for pricing.
400	TradeWaitDistributorAudit	The trade needs distributor to audit.
400	OperationFailed.InvokeProxyFailed	Failed to invoke proxy.
400	QueryAccountCompleteProgressFailed	Failed to query account progress.
400	QueryVoucherInfoFailed	Failed to query voucher info.
400	InvalidVSwitchId.NotFound	The specified vSwitch instance is invalid.
400	IllegalParam.SpecType	The param of SpecType is illegal.
400	MissingParam.SpecType	The param of SpecType is missing.
400	UnsupportedRegion	The feature is not supported in current region.
400	PayInsufficientBalance	Your account balance is insufficient.
400	IllegalParam.InstanceChargeType	The parameter InstanceChargeType is illegal.
400	SystemBusy	The system is busy.
400	PRODUCT.NOT_AVAILABLE_IZ	The Instance zone id doesn t support
400	PRICE.INQUIRY_FAILED	The instance pricing inquiry is failed.
400	AssociateIpFail	The instance associating ip is failed.
400	SDK.ServerUnreachable	Service is unreachable.
400	OverQuota	The Total is over the quota
400	InvalidParam.TagValue	%s.
400	InvalidParam.TagKey	%s.
400	SizeLimitExceeded.Tag	%s.
400	MissingParam.TagKey	The param MissingParam.TagKey is missing.
400	SubnetIpExhaust	No subnet IP addresses are available.
400	BeforePayRuleBatchValidateError	The pre-payment rule center instance rule validation failed. Please check if the instance limit has been reached.
400	TradeSyncCreateSubError	Subscription transfer failed.
400	QueryOrderError	Failed to query the order. Please try again later.
400	CreateOrderTimeout	Order creation timed out. Please try again later.
400	MultiGrayKeyResourceInconsist	The identifier for the gray resource is set incorrectly.
400	InsufficientAvailableQuota	Your account available balance is less than 0. Please recharge before attempting to make a purchase.
400	Forbidden.AliGroupForbiddenRegion	Thre region is forbidden for aligroup user.
403	SecurityRisk.AuthVerification	We have detected a security risk with your payment method. Please proceed with verification via the link in your email or console message and re-submit your order after verification.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.