全部产品
Search

搜索本产品

    Server Load Balancer：CreateLoadBalancer

    文档中心

    Server Load Balancer：CreateLoadBalancer

    更新时间：Dec 14, 2025

    Membuat instance Classic Load Balancer (CLB).

    Deskripsi operasi

    Catatan

    • Sebelum membuat instans CLB, panggil operasi DescribeAvailableResource untuk mengecek resource yang tersedia di wilayah tempat Anda ingin membuat instans CLB.

    • Anda akan dikenai biaya penggunaan segera setelah instans CLB dibuat.

    • Instans CLB pay-as-you-go hanya mendukung metode pengukuran sumber daya berbasis LCU. Mulai 01 Juni 2025 pukul 00.00.00 (UTC+8), instans CLB berbasis spesifikasi tidak lagi tersedia untuk pembelian. Untuk detail selengkapnya, lihat Akhir penjualan untuk instance CLB bayar sesuai spesifikasi.

    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 DescribeRegions untuk menanyakan daftar wilayah terbaru.

    cn-hangzhou
    AddressType

    string

    No

    Jenis jaringan instans CLB. Nilai yang valid:

    • internet: Setelah instans CLB akses Internet dibuat, sistem mengalokasikan alamat IP publik ke instans tersebut. Instans CLB dapat meneruskan permintaan melalui Internet.

    • intranet: Setelah instans CLB akses internal dibuat, sistem mengalokasikan alamat IP pribadi ke instans tersebut. Instans CLB hanya dapat meneruskan permintaan dalam VPC.

    internet
    InternetChargeType

    string

    No

    Metode pengukuran transfer data Internet untuk instans CLB akses Internet. Nilai yang valid:

    • paybytraffic (default): bayar-berdasarkan-transfer-data

    • paybybandwidth: bayar-per-bandwidth

    Catatan

    • Jika Anda mengatur PayType ke PayOnDemand dan InstanceChargeType ke PayByCLCU, satu-satunya nilai yang valid untuk InternetChargeType adalah paybytraffic.

    • Jika Anda mengatur InternetChargeType ke paybytraffic, Anda tidak perlu mengonfigurasi parameter Bandwidth. Nilai Bandwidth tidak berlaku meskipun Anda menentukannya.

    paybytraffic
    Bandwidth

    integer

    No

    Bandwidth maksimum instans. Satuan: Mbit/s.

    Nilai yang valid: 1 hingga 5000.

    Catatan

    Parameter ini hanya berlaku ketika AddressType diatur ke internet dan InternetChargeType diatur ke paybybandwidth.

    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 request ID sebagai client token. Request ID 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 dimulai dengan huruf.

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis menetapkan nama untuk 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 secara default diatur ke intranet.

    Catatan

    vSwitch harus berada di zona primer.

    vsw-bp12mw1f8k3jgy****
    MasterZoneId

    string

    No

    ID zona primer tempat instans CLB berada.

    Anda dapat memanggil operasi DescribeZones untuk menanyakan zona primer dan 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 DescribeZones untuk menanyakan zona primer dan sekunder di wilayah tempat Anda ingin membuat instans CLB.

    cn-hangzhou-d
    LoadBalancerSpec

    string

    No

    Spesifikasi instans CLB. Nilai yang valid:

    • slb.s1.small

    • slb.s2.small

    • slb.s2.medium

    • slb.s3.small

    • slb.s3.medium

    • slb.s3.large

    Catatan

    • Jika InstanceChargeType diatur ke PayByCLCU, parameter ini tidak berlaku dan Anda tidak perlu menentukan parameter ini.

    • Mulai 01 Juni 2025 pukul 00:00:00 (UTC+8), instans CLB berbasis spesifikasi tidak lagi tersedia untuk pembelian. Untuk detail selengkapnya, lihat Akhir penjualan untuk instance CLB bayar sesuai spesifikasi.

    slb.s1.small
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-atstuj3rtopt****
    PayType deprecated

    string

    No

    Metode penagihan instans CLB. Nilai yang valid:

    PayOnDemand: pay-as-you-go.

    PayOnDemand
    PricingCycle deprecated

    string

    No

    Siklus penagihan instans CLB akses Internet berlangganan. Nilai yang valid:

    • month

    • year

    Catatan

    Parameter ini hanya didukung oleh instans berlangganan yang dibuat di situs Alibaba Cloud China.

    month
    Duration deprecated

    integer

    No

    Durasi langganan instans CLB akses Internet. Nilai yang valid:

    • Jika PricingCycle diatur ke month, nilai yang valid adalah 1 hingga 9.

    • Jika PricingCycle diatur ke year, nilai yang valid adalah 1 hingga 5.

    Catatan

    Parameter ini hanya didukung oleh instans berlangganan yang dibuat di situs Alibaba Cloud China.

    1
    AutoPay deprecated

    boolean

    No

    Menentukan apakah biaya langganan instans CLB akses Internet dibayar secara otomatis. Nilai yang 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 sampai Anda menyelesaikan pembayaran.

    Catatan

    Parameter ini hanya berlaku untuk instans CLB berlangganan yang dibuat di situs Alibaba Cloud China.

    true
    AddressIPVersion

    string

    No

    Versi IP instans CLB. Nilai yang valid: ipv4 dan ipv6.

    ipv4
    Address

    string

    No

    Alamat IP pribadi instans CLB. Alamat IP pribadi harus termasuk dalam Blok CIDR tujuan vSwitch.

    192.168.XX.XX
    Tag

    array<object>

    No

    Tag.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag bastion host. Nilai N yang valid: 1 hingga 20. Kunci tag tidak boleh berupa string kosong.

    Panjang kunci tag maksimal 64 karakter, dan tidak boleh mengandung http:// atau https://. Kunci tag tidak boleh dimulai dengan aliyun atau acs:.

    test
    Value

    string

    No

    Nilai tag. Nilai N yang valid: 1 hingga 20. Nilai tag boleh berupa string kosong.

    Panjang nilai tag maksimal 128 karakter dan tidak boleh dimulai dengan acs: atau aliyun. Nilai tag tidak boleh mengandung http:// atau https://.

    value
    DeleteProtection

    string

    No

    Menentukan apakah perlindungan penghapusan diaktifkan untuk instans CLB. Nilai yang valid:

    • on

    • off

    on
    ModificationProtectionStatus

    string

    No

    Menentukan apakah mode baca-saja konfigurasi diaktifkan. Nilai yang 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 mengatur parameter ini ke ConsoleProtection, Anda tidak dapat mengubah konfigurasi instans di Konsol CLB. Namun, Anda tetap 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. Alasan harus dimulai dengan huruf dan dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-).

    Catatan

    Parameter ini hanya berlaku ketika ModificationProtectionStatus diatur ke ConsoleProtection.

    Managed instance
    InstanceChargeType

    string

    No

    Metode pengukuran sumber daya untuk instans CLB. Nilai yang valid:

    • PayByCLCU: bayar-berdasarkan-transfer-data

    Catatan

    Mulai 01 Juni 2025 pukul 00:00:00 (UTC+8), instans CLB berbasis spesifikasi tidak lagi tersedia untuk pembelian. Untuk detail selengkapnya, lihat Akhir penjualan untuk instance CLB bayar sesuai spesifikasi.

    PayBySpec

    Elemen respons

    Element

    Type

    Description

    Example

    object

    VpcId

    string

    ID VPC tempat instans CLB berada.

    vpc-25dvzy9****
    AddressIPVersion

    string

    Versi IP yang digunakan oleh instans CLB.

    ipv4
    VSwitchId

    string

    ID vSwitch tempat instans CLB berada.

    vsw-255ecr****
    RequestId

    string

    ID permintaan.

    365F4154-92F6-4AE4-92F8-7FF34B540710
    LoadBalancerName

    string

    Nama instans CLB.

    lb-bp1o94dp5i6ea****
    LoadBalancerId

    string

    ID instans CLB.

    lb-hddhfjg****
    ResourceGroupId

    string

    ID kelompok sumber daya tempat instans CLB berada.

    rg-atstuj3rto****
    Address

    string

    Alamat IP yang dialokasikan ke instans CLB.

    42.XX.XX.6
    NetworkType

    string

    Jenis jaringan instans CLB. Nilai yang valid:

    • vpc: VPC

    • Classic: jaringan klasik

    classic
    OrderId

    integer

    ID pesanan instans CLB berlanggunan.

    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

    Description
    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. Your account balance is insufficient. Top up your account and try again.
    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. The current specified vswitch instance is illegal.
    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. System 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 Total amount has reach the limit. Reduce the quantity and try again.
    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. No subnet IP address is 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. 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.