All Products
Search

This Product

    Server Load Balancer:CreateLoadBalancer

    Document Center

    Server Load Balancer:CreateLoadBalancer

    Last Updated:Dec 19, 2025

    Membuat instance Application Load Balancer (ALB) di suatu wilayah.

    Deskripsi operasi

    CreateLoadBalancer adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID permintaan dan menjalankan tugas tersebut di latar belakang. Anda dapat memanggil operasi GetLoadBalancerAttribute untuk mengecek status instance ALB.

    • Jika instance ALB berada dalam status Provisioning, artinya instance tersebut sedang dalam proses pembuatan.

    • Jika instance ALB berada dalam status Active, artinya instance tersebut telah berhasil dibuat.

    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

    alb:CreateLoadBalancer

    create

    *LoadBalancer

    acs:alb:{#regionId}:{#accountId}:loadbalancer/*
    • alb:AddressType
    		 None

    Parameter permintaan

    Parameter

    Type

    Required

    Description

    Example
    ClientToken

    string

    No

    Token klien yang digunakan untuk memastikan idempotensi permintaan.

    Anda dapat menggunakan klien untuk menghasilkan nilai ini, tetapi harus memastikan nilainya unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII.

    Catatan

    Jika Anda tidak menentukan parameter ini, sistem akan menggunakan nilai RequestId sebagai nilai ClientToken. Nilai parameter RequestId mungkin berbeda untuk setiap permintaan API.

    5A2CFF0E-5718-45B5-9D4D-70B3FF3898
    DryRun

    boolean

    No

    Menentukan apakah akan melakukan dry run. Nilai default: false. Nilai yang valid:

    • true: melakukan dry run. Sistem memeriksa parameter yang diperlukan, format permintaan, dan batas layanan. Jika permintaan gagal dalam dry run, pesan kesalahan akan dikembalikan. Jika permintaan lolos dry run, kode kesalahan DryRunOperation akan dikembalikan.

    • false: tidak melakukan dry run dan langsung mengirim permintaan. Jika permintaan lolos dry run, kode status HTTP 2xx dikembalikan dan operasi dilakukan.

    false
    VpcId

    string

    Yes

    ID virtual private cloud (VPC) tempat Anda ingin membuat instans ALB.

    vpc-bp1b49rqrybk45nio****
    AddressType

    string

    Yes

    Tipe alamat instans ALB. Nilai yang valid:

    • Internet: Instans ALB menggunakan Alamat IP publik. Nama domain instans ALB di-resolve ke Alamat IP publik tersebut. Dalam hal ini, instans ALB dapat diakses melalui Internet.

    • Intranet: Instans ALB menggunakan Alamat IP pribadi. Nama domain instans ALB di-resolve ke Alamat IP pribadi tersebut. Dalam hal ini, instans ALB hanya dapat diakses melalui VPC tempat instans ALB ditempatkan.

    Internet
    LoadBalancerName

    string

    No

    Nama instans ALB.

    Nama harus terdiri dari 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik (.), garis bawah (_), serta tanda hubung (-). Nama harus dimulai dengan huruf.

    alb1
    DeletionProtectionEnabled

    boolean

    No

    Menentukan apakah perlindungan penghapusan diaktifkan. Nilai default: false. Nilai yang valid:

    • true: mengaktifkan perlindungan penghapusan.

    • false: menonaktifkan perlindungan penghapusan.

    false
    ModificationProtectionConfig

    object

    No

    Pengaturan mode baca-saja konfigurasi.

    Reason

    string

    No

    Alasan mengaktifkan mode baca-saja konfigurasi.

    Alasan harus terdiri dari 2 hingga 128 karakter, dapat berisi huruf, angka, titik (.), garis bawah (_), dan tanda hubung (-), serta harus dimulai dengan huruf.

    Catatan

    Parameter ini hanya berlaku ketika Status diatur ke ConsoleProtection.

    test
    Status

    string

    No

    Menentukan apakah mode baca-saja konfigurasi diaktifkan. Nilai yang valid:

    • NonProtection: Menonaktifkan mode baca-saja konfigurasi. Dalam hal ini, nilai parameter Reason yang Anda tentukan tidak berlaku. Jika Anda menentukan Reason, nilai parameter tersebut akan dihapus.

    • ConsoleProtection: Mengaktifkan mode baca-saja konfigurasi. Dalam hal ini, nilai parameter Reason yang Anda tentukan berlaku.****

    Catatan

    Jika parameter diatur ke ConsoleProtection, mode baca-saja konfigurasi diaktifkan. Anda tidak dapat mengubah konfigurasi instans ALB di Konsol ALB. Namun, Anda tetap dapat memanggil operasi API untuk mengubah konfigurasi instans ALB.

    ConsoleProtection
    ZoneMappings

    array<object>

    Yes

    Pemetaan antara zona dan vSwitch. Anda dapat menentukan maksimal 10 zona. Jika wilayah yang dipilih mendukung dua zona atau lebih, pilih minimal dua zona untuk memastikan ketersediaan tinggi layanan Anda.

    object

    No

    Pemetaan antara zona dan vSwitch. Anda dapat menentukan maksimal 10 zona. Jika wilayah yang dipilih mendukung dua zona atau lebih, pilih minimal dua zona untuk memastikan ketersediaan tinggi layanan Anda.

    VSwitchId

    string

    Yes

    vSwitch di zona tersebut. Anda hanya dapat menentukan satu vSwitch (subnet) di setiap zona. Anda dapat menentukan maksimal 10 zona. Jika wilayah mendukung dua zona atau lebih, tentukan minimal dua zona.

    vsw-sersdf****
    ZoneId

    string

    Yes

    ID zona kluster. Anda dapat menentukan maksimal 10 zona. Jika wilayah mendukung dua zona atau lebih, tentukan minimal dua zona. Anda dapat memanggil operasi DescribeZones untuk menanyakan daftar zona terbaru.

    cn-hangzhou-a
    AllocationId

    string

    No

    ID EIP yang akan dikaitkan dengan instans ALB yang menghadap Internet.

    eip-bp1aedxso6u80u0qf****
    EipType

    string

    No

    Tipe EIP. Nilai yang valid:

    • Common: EIP.

    • Anycast: EIP Anycast.

    Catatan

    Untuk informasi selengkapnya tentang wilayah tempat ALB mendukung EIP Anycast, lihat Batasan.

    Common
    IntranetAddress

    string

    No

    Alamat IPv4 pribadi.

    192.168.10.1
    AddressAllocatedMode

    string

    No

    Mode alokasi alamat IP untuk instans ALB. Nilai yang valid:

    • Fixed (default): alamat IP tetap ditetapkan untuk instans ALB di setiap zona.

    • Dynamic: alamat IP dialokasikan secara dinamis untuk instans ALB di setiap zona.

    Catatan

    Mulai pukul 00.00.00 pada 25 Februari 2025 (UTC+8), saat Anda memanggil operasi ini untuk membuat instans ALB, instans tersebut secara otomatis menjadi versi peningkatan terlepas dari mode yang Anda tentukan. Instans ALB versi peningkatan tidak lagi membedakan mode IP. Sebagai gantinya, instans tersebut secara global melakukan auto-scale alamat IP untuk menyediakan layanan load balancing. Instans ALB yang Anda buat sebelum tanggal dan waktu tersebut tidak terpengaruh.

    Dynamic
    ResourceGroupId

    string

    No

    ID kelompok sumber daya.

    rg-atstuj3rtop****
    LoadBalancerEdition

    string

    Yes

    Edisi instans ALB. Fitur dan aturan penagihan berbeda-beda tergantung edisi instans ALB. Nilai yang valid:

    • Basic: dasar.

    • Standard: standar.

    • StandardWithWaf: dengan WAF.

    Standard
    LoadBalancerBillingConfig

    object

    Yes

    Metode penagihan instans ALB.

    PayType

    string

    Yes

    Metode penagihan instans.

    Tetapkan nilai ke PostPay, yang menunjukkan metode penagihan bayar sesuai pemakaian.

    PostPay
    BandwidthPackageId

    string

    No

    ID instans Bandwidth Internet Bersama yang dikaitkan dengan instans ALB yang menghadap Internet.

    cbwp-bp1vevu8h3ieh****
    AddressIpVersion

    string

    No

    Versi protokol. Nilai yang valid:

    • IPv4: IPv4.

    • DualStack: dual stack.

    IPv4
    Tag

    array<object>

    No

    Tag.

    object

    No

    Key

    string

    No

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

    env
    Value

    string

    No

    Nilai tag dapat memiliki panjang hingga 128 karakter, dan tidak boleh diawali dengan acs: atau aliyun. Tidak boleh mengandung http:// atau https://.

    product

    Elemen respons

    Element

    Type

    Description

    Example

    object

    Operasi untuk membuat instans ALB.

    LoadBalancerId

    string

    ID instans ALB.

    alb-o9ulmq5hgn68jk****
    RequestId

    string

    ID permintaan.

    CEF72CEB-54B6-4AE8-B225-F876FF7BA984

    Contoh

    Respons sukses

    JSONformat

    {
  "LoadBalancerId": "alb-o9ulmq5hgn68jk****",
  "RequestId": "CEF72CEB-54B6-4AE8-B225-F876FF7BA984"
}

    Kode kesalahan

    HTTP status code

    Error code

    Error message

    Description
    400 ResourceNotEnough.VSwitchIp The specified resource %s is not enough. The specified resource %s is not enough.
    400 QuotaExceeded.LoadBalancersNum The quota of %s is exceeded, usage %s/%s. The quota of %s is exceeded, usage %s/%s.
    400 Mismatch.ZoneIdAndVSwitchId The %s and %s are mismatched. The %s and %s are mismatched.
    400 DuplicatedParam.ZoneId The param of ZoneId is duplicated.
    400 OperationDenyed.ServiceLinkedRoleNotExist The service linked role AliyunServiceRoleForAlb does not exist.
    404 ResourceNotFound.VSwitch The specified resource %s is not found. The specified resource %s is not found.

    Lihat Error Codes untuk daftar lengkap.

    Catatan rilis

    Lihat Release Notes untuk daftar lengkap.