All Products
Search

This Product

    Server Load Balancer:CreateLoadBalancer

    Document Center

    Server Load Balancer:CreateLoadBalancer

    Last Updated:Sep 08, 2026

    Membuat instans SLB.

    Deskripsi operasi

    Catatan

    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 Classic Load Balancer (CLB)

    Anda dapat memanggil DescribeRegions untuk mengkueri ID wilayah.

    cn-hangzhou
    AddressType

    string

    No

    Jenis jaringan instans Classic Load Balancer (CLB). Nilai valid:

    • internet: Setelah instans SLB Internet-facing dibuat, sistem mengalokasikan alamat IP publik ke instans agar instans dapat meneruskan permintaan dari Internet.

    • intranet: Setelah instans Server Load Balancer internal-facing tipe VPC dibuat, sistem mengalokasikan alamat IP jaringan internal ke instans agar instans hanya dapat meneruskan permintaan jaringan internal.

    internet
    InternetChargeType

    string

    No

    Metode pengukuran instans Internet-facing. Nilai valid:

    • paybytraffic (default): pay-by-data-transfer.

    • paybybandwidth: pay-by-bandwidth.

    Catatan

    • Jika PayType diatur ke PayOnDemand dan InstanceChargeType diatur ke PayByCLCU, parameter ini hanya mendukung paybytraffic.

    • Jika Anda mengatur parameter ini ke paybytraffic, Anda tidak perlu mengatur parameter Bandwidth. Meskipun Anda mengatur parameter Bandwidth, nilainya tidak akan berlaku.

    paybytraffic
    Bandwidth

    integer

    No

    Bandwidth maksimum instans. Unit: Mbit/s.

    Nilai 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 RequestId dari permintaan API sebagai ClientToken. RequestId mungkin berbeda untuk setiap permintaan API.

    593B0448-D13E-4C56-AC0D-FDF0FDE0E9A3
    LoadBalancerName

    string

    No

    Nama instans Server Load Balancer.

    Nama harus memiliki panjang 1 hingga 80 karakter dan dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-). Nama harus diawali dengan huruf atau karakter Tionghoa.

    Jika Anda tidak menentukan parameter ini, sistem secara otomatis mengalokasikan nama default ke instans.

    lb-bp1o94dp5i6ea****
    VpcId

    string

    No

    ID VPC tempat instans Server Load Balancer berada.

    vpc-bp1aevy8sofi8mh1****
    VSwitchId

    string

    No

    ID vSwitch tempat instans SLB berada.

    Untuk membuat instans Server Load Balancer tipe VPC, Anda harus menentukan parameter ini. Jika Anda menentukan parameter ini, nilai AddressType secara otomatis diatur ke intranet.

    Catatan

    Pastikan vSwitch yang ditentukan oleh VSwitchId berada di zona yang sama dengan zona utama.

    vsw-bp12mw1f8k3jgy****
    MasterZoneId

    string

    No

    ID zona utama instans Server Load Balancer.

    Anda dapat memanggil DescribeZone untuk mengkueri zona utama dan zona sekunder di suatu wilayah.

    Catatan

    Pastikan zona utama berada di zona yang sama dengan vSwitch yang ditentukan oleh VSwitchId.

    cn-hangzhou-b
    SlaveZoneId

    string

    No

    ID zona sekunder instans Server Load Balancer.

    Anda dapat memanggil DescribeZone untuk mengkueri zona utama dan sekunder di suatu wilayah.

    cn-hangzhou-d
    LoadBalancerSpec

    string

    No

    Spesifikasi instans SLB. Nilai valid:

    • slb.s1.kecil

    • slb.s2.kecil

    • slb.s2.Menengah

    • slb.s3.kecil

    • slb.s3.Menengah

    • slb.s3.Tingkat Tinggi

    Catatan

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

    • Instans Classic Load Balancer (CLB) pay-by-specification tidak lagi tersedia untuk dibeli sejak 00:00:00 (UTC+8) pada 1 Juni 2025. Untuk detail, lihat Pemberitahuan penghentian instans CLB pay-by-specification.

    slb.s1.kecil
    ResourceGroupId

    string

    No

    ID kelompok sumber daya enterprise.

    rg-atstuj3rtopt****
    PayType deprecated

    string

    No

    Metode penagihan instans. Nilai valid:

    • PayOnDemand: pay-as-you-go.

    PayOnDemand
    PricingCycle deprecated

    string

    No

    Siklus penagihan Instansi langganan Internet-facing. Nilai valid:

    • month

    • year

    Catatan

    Parameter ini hanya berlaku untuk situs China (aliyun.com) dan hanya valid untuk Instansi langganan.

    month
    Duration deprecated

    integer

    No

    Durasi langganan Instansi langganan Internet-facing. Nilai valid:

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

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

    Catatan

    Parameter ini hanya berlaku untuk situs China (aliyun.com) dan hanya valid untuk Instansi langganan.

    1
    AutoPay deprecated

    boolean

    No

    Apakah akan membayar secara otomatis untuk Instansi langganan Internet-facing. Nilai valid:

    • true: Pembayaran otomatis diselesaikan secara otomatis. Setelah Anda memanggil operasi ini, instans SLB segera dibuat.

    • false (default): Setelah Anda memanggil operasi ini, pesanan dibuat tetapi pembayaran otomatis tidak diselesaikan. Anda dapat melihat pesanan yang belum dibayar di konsol. Karena pesanan tidak dibayar, instans SLB tidak dibuat.

    Catatan

    Parameter ini hanya berlaku untuk situs China (aliyun.com) dan hanya valid untuk Instansi langganan.

    true
    AddressIPVersion

    string

    No

    Versi IP instans Server Load Balancer. Nilai valid: ipv4 dan ipv6.

    ipv4
    Address

    string

    No

    Alamat IP pribadi instans. Alamat IP harus berada dalam Blok CIDR vSwitch.

    192.168.XX.XX
    Tag

    array<object>

    No

    Tag.

    object

    No

    Tag.

    Key

    string

    No

    Kunci tag instans. Nilai valid N: 1 hingga 20. Kunci tag tidak boleh berupa string kosong.

    Kunci tag dapat memiliki panjang hingga 64 karakter dan tidak boleh diawali dengan aliyun atau acs:. Kunci tag tidak boleh mengandung http:// atau https://.

    test
    Value

    string

    No

    Nilai tag instans. Nilai valid N: 1 hingga 20. Nilai tag dapat berupa string kosong. Nilai tag dapat memiliki panjang hingga 128 karakter dan tidak boleh diawali dengan aliyun atau acs:. Nilai tag tidak boleh mengandung http:// atau https://.

    value
    DeleteProtection

    string

    No

    Apakah akan mengaktifkan perlindungan penghapusan. Nilai valid:

    • on: diaktifkan.

    • off: dinonaktifkan.

    on
    ModificationProtectionStatus

    string

    No

    Mode baca-saja konfigurasi instans Classic Load Balancer (CLB). Nilai valid:

    • NonProtection: Mode baca-saja konfigurasi dinonaktifkan. Nilai ModificationProtectionReason dihapus saat Anda mengatur nilai ini.

    • ConsoleProtection: Mode baca-saja konfigurasi diaktifkan untuk konsol.

    Catatan

    Jika Anda mengatur parameter ini ke ConsoleProtection untuk mengaktifkan mode baca-saja konfigurasi, Anda tidak dapat mengubah konfigurasi instans di konsol Server Load Balancer. Namun, Anda dapat memanggil operasi API untuk mengubah konfigurasi instans.

    ConsoleProtection
    ModificationProtectionReason

    string

    No

    Alasan mengaktifkan mode baca-saja konfigurasi. Alasan harus memiliki panjang 1 hingga 80 karakter dan harus diawali dengan huruf atau karakter Tionghoa. Alasan dapat berisi angka, titik (.), garis bawah (_), dan tanda hubung (-).

    Catatan

    Parameter ini hanya berlaku ketika ModificationProtectionStatus diatur ke ConsoleProtection.

    Managed Instans
    InstanceChargeType

    string

    No

    Metode penagihan instans.

    Nilai valid: PayByCLCU: pay-by-Penggunaan.

    Catatan

    • Parameter ini hanya berlaku ketika PayType diatur ke PayOnDemand (pay-as-you-go).

    • Instans Classic Load Balancer (CLB) pay-by-specification tidak lagi tersedia untuk dibeli sejak 00:00:00 (UTC+8) pada 1 Juni 2025. Untuk detail, lihat Pemberitahuan penghentian instans CLB pay-by-specification.

    PayBySpec

    Elemen respons

    Element

    Type

    Description

    Example

    object

    VpcId

    string

    ID VPC tempat instans Server Load Balancer berada.

    vpc-25dvzy9****
    AddressIPVersion

    string

    Tipe alamat IP instans Server Load Balancer.

    ipv4
    VSwitchId

    string

    ID vSwitch tempat instans Server Load Balancer berada.

    vsw-255ecr****
    RequestId

    string

    ID permintaan.

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

    string

    Nama instans Server Load Balancer.

    lb-bp1o94dp5i6ea****
    LoadBalancerId

    string

    ID instans Server Load Balancer.

    lb-hddhfjg****
    ResourceGroupId

    string

    ID kelompok sumber daya.

    rg-atstuj3rto****
    Address

    string

    Alamat IP yang dialokasikan ke instans SLB.

    42.XX.XX.6
    NetworkType

    string

    Jenis jaringan instans Server Load Balancer. Nilai valid:

    • vpc: VPC.

    • classic: jaringan klasik.

    classic
    OrderId

    integer

    ID pesanan Instansi langganan.

    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. Operasi gagal karena sumber daya tidak mencukupi di zona saat ini.
    400 CloudBoxNotSupportIpv6 The cloudBox instance does not support ipv6. Instans CloudBox tidak mendukung IPv6.
    400 CloudBoxNotSupportInternet The cloudBox instance does not support internet. Instans CloudBox tidak mendukung akses Internet.
    400 OperationFailed.RegionResourceLimit The operation failed because of resource limit of the specified region. Operasi gagal karena sumber daya tidak mencukupi di wilayah yang ditentukan.
    400 Operation.NotAllowed Operation Denied. The charge type of internet prepay instance can only be paybybandwidth. Operasi dibatasi. Operasi ini tidak diizinkan.
    400 OperationFailed.UnpaidBillsExist The account has unpaid bills. Please pay your overdue bill first. Operasi gagal karena akun Anda memiliki tagihan yang belum dibayar. Bayar tagihan tertunda Anda terlebih dahulu.
    400 RegionOrZonesNotSupportIpv6 The specified region or master/slave zones does not support ipv6. Wilayah atau zona primer/zona sekunder yang ditentukan tidak mendukung IPv6.
    400 InvalidParameter.Mismatch AddressType and IpVersion is conflict, IPv6 does not support intranet instance. Jenis jaringan bertentangan dengan versi IP. Instance SLB internal tidak mendukung IPv6.
    400 PAYFOR.CREDIT_PAY_INSUFFICIENT_BALANCE Your account does not have enough balance.
    400 HighRiskOperationDenied The operation is denied because of high risk. Operasi ditolak karena operasi saat ini merupakan operasi berisiko tinggi.
    400 VSwitchAvailableIpNotExist The specified VSwitch has no availabe ip. vSwitch yang ditentukan tidak memiliki alamat IP yang tersedia.
    400 VSwitchNotExist The specified VSwitch does not exist. vSwitch yang ditentukan tidak ada.
    400 InvalidParameter Illegal parameter. The IP address is not in subnet. Vgw ip kosong. Tentukan parameter Vgw ip.
    400 Instance.ShareSlbNotSupportPay95 Illegal parameter. The share instance not support PayBy95 or PayByOld95. Instans Resource yang dibagikan tidak mendukung PayBy95 atau PayByOld95.
    400 Instance.Pay95RateInvalid Illegal parameter. The rate is illegal. Rate yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi.
    400 Instance.Pay95BandwidthIllegal Illegal parameter. The bandwidth is illegal. Bandwidth yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi.
    400 Instance.InternetChargeTypeNotAllowed Illegal parameter. The specified InternetChargeType not allowed. Parameter tidak valid. InternetChargeType yang ditentukan tidak didukung.
    400 OperationFailed.TokenIsProcessing The operation is failed, because the Client Token is processing. Operasi gagal karena permintaan saat ini sedang diproses.
    400 InsufficientBalance Your account does not have enough balance. Saldo akun tidak mencukupi. Isi ulang akun Anda dan coba lagi.
    400 MissingParam.VSwitchId The parameter VSwitchId is required. Parameter VSwitchId tidak disertakan.
    400 InvalidVpcId.NotExist The specified VPC not exist. VPC yang ditentukan tidak ada.
    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. CloudType yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi setelah melakukan koreksi.
    400 OperationFailed.InvalidAccount The account information is incomplete. Operasi gagal karena informasi akun tidak lengkap.
    400 RegionOrZonesNotSupportCEN The specified region or master/slave zones does not support cloudType of hybrid_cen. Wilayah atau zona primer/zona sekunder yang ditentukan tidak mendukung CEN.
    400 MissingParam.LoadBalancerSpec The param LoadBalancerSpec is required. Parameter LoadBalancerSpec tidak disertakan.
    400 InvalidParameter.Bandwidth The param Bandwidth is invalid. Bandwidth yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi.
    400 OperationForbidden.AccountRiskReject The operation failed because of account risk reject. Operasi gagal karena akun saat ini ditandai oleh kontrol risiko.
    400 OperationForbidden.QuotaLimit The operation failed because of quota limit of shared loadbalancers. Operasi gagal karena jumlah Instans sumber daya yang dibagikan telah mencapai batas kuota.
    400 InvalidParam.ModificationProtectionStatus The param ModificationProtectionStatus is invalid. ModificationProtectionStatus yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi setelah Anda melakukan modifikasi.
    400 InvalidParam.ModificationProtectionReason The param ModificationProtectionReason is invalid. ModificationProtectionReason yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi setelah Anda melakukan modifikasi.
    400 ShareSlbHaltSales The share instance has been discontinued. Instans SLB resource yang dibagikan telah habis terjual.
    400 OperationFailed.CashBookInsufficient No payment method is specified for your account, We recommend that you add a payment method or maintain a prepayment balance. Operasi gagal karena akun Anda tidak memiliki metode pembayaran yang ditentukan. Tambahkan metode pembayaran atau pertahankan saldo pembayaran di muka.
    400 OperationFailed.OnlyInnerCommoditySupportToPurchase AliCroup2Cloud user only can buy inner commodity. Operasi gagal karena pengguna cloud enterprise hanya dapat membeli produk internal.
    400 OperationFailed.InvokeLingXiaoFailed Failed to invoke lingxiao service. Operasi gagal karena panggilan ke layanan Lingxiao gagal.
    400 AllocateVpcInstanceFailed Failed to allocate vpc instance. Gagal mengalokasikan Instans yang terhubung ke VPC.
    400 QueryCreditCtrlInfoFailed Failed to query credit ctrl info. Gagal mengkueri informasi pengguna.
    400 QueryCommodityCenterFailed Failed to query commodity center. Gagal mengkueri pusat komoditas.
    400 RegionNotSupportParameter Current region does not support the param of %s. Parameter yang ditentukan tidak didukung di wilayah saat ini.
    400 QueryAccountBookInfoFailed Failed to invoke account book info. Gagal memanggil informasi ledger.
    400 RateAccountFailed Failed to rate account for pricing. Gagal memanggil layanan penetapan harga.
    400 TradeWaitDistributorAudit The trade needs distributor to audit. Transaksi ini sedang menunggu peninjauan oleh reseller.
    400 OperationFailed.InvokeProxyFailed Failed to invoke proxy. Operasi gagal karena panggilan ke layanan manajemen gagal.
    400 QueryAccountCompleteProgressFailed Failed to query account progress. Gagal mengkueri progres akun.
    400 QueryVoucherInfoFailed Failed to query voucher info. Gagal mengkueri informasi kredensial.
    400 InvalidVSwitchId.NotFound The specified vSwitch instance is invalid. Instans vSwitch tidak valid.
    400 IllegalParam.SpecType The param of SpecType is illegal. SpecType yang ditentukan tidak valid. Periksa batasan parameter dan coba lagi.
    400 MissingParam.SpecType The param of SpecType is missing. Parameter SpecType tidak disertakan.
    400 UnsupportedRegion The feature is not supported in current region. Fitur hosting resource tidak didukung di wilayah saat ini.
    400 PayInsufficientBalance Your account balance is insufficient. Saldo akun Anda tidak mencukupi.
    400 IllegalParam.InstanceChargeType The parameter InstanceChargeType is illegal.
    400 SystemBusy The system is busy. Sistem sedang sibuk.
    400 PRODUCT.NOT_AVAILABLE_IZ The Instance zone id doesn t support ID zona instans yang ditentukan tidak didukung.
    400 PRICE.INQUIRY_FAILED The instance pricing inquiry is failed. Gagal mengkueri harga instans.
    400 AssociateIpFail The instance associating ip is failed.
    400 SDK.ServerUnreachable Service is unreachable. Layanan sementara tidak tersedia. Coba lagi nanti.
    400 OverQuota The Total is over the quota Jumlah instans melebihi kuota.
    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. Tidak ada alamat IP yang tersedia di subnet.
    400 BeforePayRuleBatchValidateError The pre-payment rule center instance rule validation failed. Please check if the instance limit has been reached. Verifikasi aturan instans di pusat aturan gagal sebelum pembayaran. Periksa apakah batas instans telah tercapai.
    400 TradeSyncCreateSubError Subscription transfer failed. Konversi langganan gagal. Coba lagi nanti.
    400 QueryOrderError Failed to query the order. Please try again later. Gagal mengkueri pesanan. Coba lagi nanti.
    400 CreateOrderTimeout Order creation timed out. Please try again later. Pembuatan pesanan habis waktu. Coba lagi nanti.
    400 MultiGrayKeyResourceInconsist The identifier for the gray resource is set incorrectly. Pengidentifikasi untuk Sumber daya rilis canary dikonfigurasi secara tidak benar.
    400 InsufficientAvailableQuota Your account available balance is less than 0. Please recharge before attempting to make a purchase. Saldo akun Anda kurang dari 0. Isi ulang akun Anda dan coba lagi.
    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. Risiko terdeteksi pada metode pembayaran Anda. Selesaikan verifikasi menggunakan tautan di email atau Pesan internal. Buat pesanan baru setelah verifikasi selesai.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.