All Products
Search
Document Center

Edge Security Acceleration:CreateLoadBalancer

Last Updated:Jul 07, 2026

Membuat instans load balancer yang mendukung kebijakan perutean kustom, persistensi sesi, konfigurasi pemantauan, dan fitur lanjutan lainnya.

Deskripsi operasi

Membuat layanan penyeimbangan beban berdasarkan kebutuhan bisnis Anda. Anda dapat mengonfigurasi pengaturan seperti perutean adaptif, polling berbobot, pencocokan aturan, dan pemeriksaan kesehatan untuk mengelola dan mengoptimalkan trafik secara efektif.

Hanya paket Enterprise yang mendukung layanan penyeimbangan beban. Untuk menggunakan fitur ini, hubungi tim penjualan Alibaba Cloud untuk mengajukan paket Enterprise.

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

esa:CreateLoadBalancer

create

*Site

acs:esa:{#regionId}:{#accountId}:site/{#SiteId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

Name

string

Yes

Nama load balancer. Nama harus dalam format nama domain yang valid dan harus berupa subdomain dari situs.

lb.example.com

Enabled

boolean

No

Apakah akan mengaktifkan load balancer. Nilai valid:

  • true: Diaktifkan.

  • false: Tidak diaktifkan.

Valid values:

  • true :

    Diaktifkan.

  • false :

    Tidak diaktifkan.

true

SiteId

integer

Yes

ID situs. Anda dapat memanggil operasi ListSites untuk mendapatkan ID situs.

123456789****

AdaptiveRouting

object

No

Konfigurasi back-to-origin kolam alamat lintas asal.

true

FailoverAcrossPools

boolean

No

Apakah akan mengaktifkan failover kolam alamat lintas asal. Nilai valid:

  • true: Diaktifkan.

  • false: Tidak diaktifkan.

true

OriginLevelRetry

boolean

No

Apakah akan mencoba ulang ke alamat IP berikutnya ketika back-to-origin gagal dan server asal adalah nama domain yang resolves ke beberapa alamat IP.

false

DefaultPools

array

Yes

Daftar ID kolam alamat default.

123

integer

No

ID kolam alamat default. Nilainya adalah bilangan bulat.

95223818027****

FallbackPool

integer

Yes

ID kolam alamat fallback. Trafik diarahkan ke kolam ini ketika semua kolam lain tidak tersedia.

123

RandomSteering

object

No

Konfigurasi round-robin berbobot yang mengontrol bobot distribusi trafik di berbagai kolam alamat.

123

DefaultWeight

integer

No

Bobot round-robin default yang diterapkan pada semua kolam alamat yang tidak memiliki bobot yang ditentukan secara individual. Nilai valid: bilangan bulat dari 0 hingga 100.

50

PoolWeights

object

No

Konfigurasi bobot untuk setiap pool server backend. Kuncinya adalah ID pool dan nilainya adalah koefisien bobot. Koefisien bobot mewakili proporsi relatif distribusi trafik.

integer

No

Bobot satu kolam alamat asal. Nilai valid: 0 hingga 100. Nilai 0 menunjukkan bahwa tidak ada trafik yang dirutekan ke kolam alamat asal ini.

50

Rules

array<object>

No

Informasi aturan.

{ "ENAM": [ 12345678**** ], "WNAM": [ 23456789****, 23456789**** ] }

array<object>

No

Struktur aturan.

RuleName

string

No

Nama aturan. Parameter ini tidak diperlukan saat menambahkan konfigurasi global.

rule_1

Rule

string

No

Konten aturan yang menggunakan ekspresi kondisional untuk mencocokkan permintaan pengguna. Parameter ini tidak diperlukan saat menambahkan konfigurasi global. Dua skenario didukung:

  • Mencocokkan semua permintaan masuk: Atur nilai ke true.

  • Mencocokkan permintaan tertentu: Atur nilai ke ekspresi kustom, seperti (http.host eq "video.example.com").

(http.request.method eq "GET" and http.request.version eq "HTTP/1.0") or (ip.geoip.country eq "CN") or (http.host eq "www.example.com")

RuleEnable

string

No

Sakelar aturan. Parameter ini tidak diperlukan saat menambahkan konfigurasi global. Nilai valid:

  • on: Diaktifkan.

  • off: Dinonaktifkan.

on

FixedResponse

object

No

Konten tanggapan tetap yang dikembalikan setelah aturan dicocokkan.

{"content_type": "application/json", "location": "www.example.com", "message_body": "Testing Hello", "status_code": 0}

ContentType

string

No

Bidang Content-Type di header HTTP.

application/octet-stream

Location

string

No

Bidang location di tanggapan HTTP.

http://www.example.com/index.html

MessageBody

string

No

Nilai badan respons.

Hello World!

StatusCode

integer

No

Kode status tanggapan.

200

Overrides

any

No

Konfigurasi load balancing yang menimpa bidang terkait dalam konfigurasi load balancer ketika aturan dicocokkan. Bidang yang ditentukan menimpa bidang terkait dalam konfigurasi load balancer.

{ "adaptive_routing": { "failover_across_pools": true }, "sub_region_pools": { "AL,AT": [ 92298024898****, 92304347804**** ], "BG,BY": [ 92298024898**** ] }, "default_pools": [ 92298024898****, 92304347804**** ], "fallback_pool": 92298024898****, "location_strategy": { "mode": "resolver_ip", "prefer_ecs": "always" }, "random_steering": { "default_weight": 0.3, "pool_weights": { "92298024898****": 0.7, "92304347804****": 0.8 } }, "region_pools": { "CN,SEAS": [ 92298024898****, 92304347804**** ], "SAF,SAS": [ 92304347804**** ] }, "session_affinity": "ip", "steering_policy": "geo", "ttl": 30 }

Sequence

integer

No

Urutan eksekusi aturan. Parameter ini opsional. Jika tidak ditentukan, aturan dieksekusi sesuai urutan daftar. Jika ditentukan, nilainya harus berupa bilangan bulat positif. Nilai yang lebih besar menunjukkan prioritas yang lebih tinggi.

1

Terminates

boolean

No

Apakah akan menghentikan eksekusi aturan berikutnya. Nilai valid:

  • true: Hentikan eksekusi aturan berikutnya.

  • false: Lanjutkan eksekusi aturan berikutnya. Ini adalah nilai default.

true

SessionAffinity

string

No

Mode persistensi sesi. Nilai valid:

  • off: dinonaktifkan.

  • ip: Persistensi sesi berbasis IP.

  • cookie: Persistensi sesi berbasis cookie.

  • http_header: Persistensi sesi berbasis header HTTP.

ip

SteeringPolicy

string

Yes

Kebijakan load balancing. Nilai valid:

  • geo: Perutean berbasis geo.

  • random: Round-robin berbobot.

  • order: Mode utama/cadangan.

order

Description

string

No

Deskripsi load balancer untuk tujuan manajemen dan identifikasi.

Load Balancer Description

Ttl

integer

No

Nilai TTL, yang menentukan pengatur waktu Catatan DNS. Nilai default: 30 detik. Nilai valid: 10 hingga 600.

300

Monitor

object

Yes

Konfigurasi monitor untuk pemeriksaan kesehatan.

order

Type

string

No

Jenis protokol monitor yang digunakan untuk pemeriksaan kesehatan. Nilai off menunjukkan bahwa pemeriksaan kesehatan dinonaktifkan. Nilai valid:

  • TCP

  • UDP

  • SMTP

  • HTTPS

  • HTTP

  • ICMP Ping

  • off

HTTP

Method

string

No

Metode permintaan monitor, seperti GET. Ini adalah metode HTTP yang digunakan untuk pemeriksaan kesehatan.

GET

Port

integer

No

Port server asal.

1921

Path

string

No

Jalur pemeriksaan monitor, seperti /healthcheck. Ini adalah URI permintaan.

/health

Interval

integer

No

Interval pemantauan dalam detik, seperti 60. Ini menentukan frekuensi pemeriksaan.

60

Timeout

integer

No

Periode pengatur waktu pemeriksaan kesehatan. Unit: detik. Nilai valid: 1 hingga 10.

5

ExpectedCodes

string

No

Kode status yang diharapkan, seperti 200,202. Ini adalah kode tanggapan HTTP yang menunjukkan keberhasilan.

200

FollowRedirects

boolean

No

Apakah akan mengikuti pengalihan. Nilai valid:

  • true: Ikuti pengalihan.

  • false: Jangan ikuti pengalihan.

true

ConsecutiveUp

integer

No

Jumlah probe berhasil berturut-turut yang diperlukan untuk menganggap pemeriksaan berhasil, seperti 3.

3

ConsecutiveDown

integer

No

Jumlah probe gagal berturut-turut yang diperlukan untuk menganggap pemeriksaan gagal, seperti 5.

5

Header

any

No

Informasi header yang disertakan dalam permintaan probe. Ini adalah Header HTTP.

{ "host": [ "example1.com", "example2.com" ] }

MonitoringRegion

string

No

Wilayah tempat node probe berada. Nilai default: Global. Nilai valid:

  • Global: seluruh dunia.

  • ChineseMainland: daratan Tiongkok.

  • OutsideChineseMainland: seluruh dunia (kecuali daratan Tiongkok).

Valid values:

  • OutsideChineseMainland :

    Seluruh dunia (kecuali daratan Tiongkok)

  • ChineseMainland :

    Daratan Tiongkok.

  • Global :

    Seluruh dunia.

Global

SubRegionPools

any

No

Kolam alamat yang dipetakan ke wilayah sekunder. Jika beberapa wilayah sekunder berbagi kumpulan kolam alamat yang sama, Anda dapat menggabungkan nama wilayah sekunder dengan koma sebagai kunci.

{"AL,MO": [92298024898****],"CN-SH,CN-SX,CN-SC":[92304347804****,92843536908****]}

RegionPools

any

No

Kolam alamat yang dipetakan ke wilayah utama.

{ "ENAM": [ 12345678**** ], "WNAM": [ 23456789****, 23456789**** ] }

Elemen respons

Element

Type

Description

Example

object

Skema Respons.

RequestId

string

ID permintaan.

EEEBE525-F576-1196-8DAF-2D70CA3F4D2F

Id

integer

ID load balancer.

99867648760****

Contoh

Respons sukses

JSONformat

{
  "RequestId": "EEEBE525-F576-1196-8DAF-2D70CA3F4D2F\n",
  "Id": 0
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidParameter The specified parameter is invalid. Validasi format parameter input gagal.
400 LoadBalancerQuotaCheckFailed Load balancer enable quota check failed. Paket saat ini tidak mendukung fitur load balancing. Untuk menggunakan fitur ini, lakukan Peningkatan paket Anda.
400 LoadBalancerNumberExceedQuotaLimit The number of load balancers you have added has reached the limit of the plan quota. Please delete the unused load balancers or upgrade the plan and try again. Jumlah instans load balancing yang Anda tambahkan telah mencapai batas kuota paket Anda. Hapus instans load balancing yang tidak digunakan atau lakukan Peningkatan paket Anda, lalu coba lagi.
400 LoadBalancerRuleQuotaCheckFailed Your current plan does not support configuring load balancer custom rules, or the load balancer rules you have added exceed the plan quota limit. Please upgrade the plan or delete the rules that are no longer in use and try again. Paket saat ini tidak mendukung aturan load balancing kustom, atau jumlah aturan load balancing yang Anda tambahkan melebihi batas kuota paket. Lakukan Peningkatan paket Anda atau hapus aturan yang tidak digunakan dan coba lagi.
400 LoadBalancerPolicyCheckFailed Your current plan does not support the load balancer scheduling policy. Upgrade the plan and try again. Paket saat ini tidak mendukung kebijakan penjadwalan load balancing ini. Lakukan Peningkatan paket Anda dan coba lagi.
400 LoadBalancerHealthDetectionQuotaCheckFailed Your current plan does not allow you to configure the load balancer's health detection. Upgrade the plan and try again. Paket Anda saat ini tidak mengizinkan konfigurasi pemeriksaan kesehatan untuk load balancing. Tingkatkan paket Anda dan coba lagi.
400 LoadBalancerHealthDetectionIntervalCheckFailed The configured load balancer health detection interval exceeds the quota range allowed by the plan. Please revise the interval within the range or upgrade the plan and try again. Interval waktu deteksi pemeriksaan kesehatan yang dikonfigurasi untuk load balancing melebihi kuota yang diizinkan oleh paket Anda. Sesuaikan interval ke nilai dalam rentang yang diizinkan atau lakukan Peningkatan paket Anda, lalu coba lagi.
400 InternalException Failed to call the service. Try again later or contact technical support. Pemanggilan layanan gagal. Coba lagi nanti atau hubungi layanan pelanggan untuk detail lebih lanjut.
400 Instance.NotOnline Your plan is unavailable due to an overdue payment. Complete the payment first. Instans paket Anda saat ini tidak aktif karena pembayaran tertunda. Selesaikan perpanjangan untuk terus menggunakan layanan.
400 MonitorExpectedBodyInvalid Invalid response body. Specify a response body that does not exceed 102,400 characters in length in your custom rule. Nilai tanggapan yang diharapkan dari monitor tidak valid. Panjangnya tidak boleh melebihi 102400 karakter. Verifikasi nilai tanggapan dan coba lagi.
400 MonitorExpectedCodesInvalid Invalid expected status code for the probe.Make sure that you specify no more than 10 status codes in the probe settings, and each status code must be 3 to 4 characters in length.Examples: 200, 301, 3xx, 8000, and 88xx. Kode tanggapan yang diharapkan dari monitor tidak valid. Jumlah kode tanggapan tidak boleh melebihi 10, dan setiap kode tanggapan harus memiliki panjang antara 3 hingga 4 karakter. Contoh: 200, 301, 3xx, 8000, 88xx.
400 MonitorHeaderInvalid Invalid request header for the probe. You can add up to 10 request headers, each with 1 to 9 values. The combined length of all headers and values cannot exceed 6,000 characters. You cannot configure the User-Agent header. Header permintaan yang dibawa oleh monitor tidak valid. Pastikan jumlah header permintaan tidak melebihi 10, panjang nilai setiap header permintaan antara 1 hingga 10, dan header permintaan User-Agent tidak digunakan (dicadangkan untuk skenario internal). Selain itu, total panjang semua header permintaan dan nilainya tidak boleh melebihi 6000 karakter. Periksa dan perbaiki konfigurasi header permintaan, lalu coba lagi.
400 MonitorMethodNotSupport Invalid HTTP method for the probe request. Valid values are GET and HEAD. Metode permintaan monitor tidak didukung. Hanya metode berikut yang didukung: GET dan HEAD.
400 MonitorPathNotSupport Invalid probe URL path.If you set the probe protocol to HTTP or HTTPS, make sure you specify a probe URL path that does not exceed 1,024 characters in length. Health Check Path tidak didukung. Ketika tipe pemantauan adalah HTTP atau HTTPS, Health Check Path tidak boleh kosong dan panjang path tidak boleh melebihi 1024 karakter. Periksa path dan coba lagi.
400 MonitorPortNotSupport Invalid probe port. Specify a valid port from 1 to 65535 for the probe request. Then, try again. Port pemantauan monitor tidak didukung. Range port yang valid adalah 1 hingga 65535. Pastikan port berada dalam range yang valid dan coba lagi.
400 MonitorRetriesInvalid Invalid number of probe retries. Specify an integer from 0 to 5. Then, try again. Parameter jumlah percobaan ulang monitor tidak didukung. Range valid untuk jumlah percobaan ulang adalah 0 hingga 5. Pastikan jumlah percobaan ulang berada dalam range ini.
400 MonitorTimeoutInvalid Invalid timeout for the probe. Valid values are 1 to 10. Nilai timeout monitor melebihi range yang valid. Range yang didukung adalah 1 hingga 10.
400 MonitorTypeNotSupport Invalid protocol. Valid values are off, HTTP, HTTPS, TCP, UDP, ICMP Ping, and SMTP. Tipe monitor tidak didukung. Hanya tipe berikut yang didukung: off, HTTP, HTTPS, TCP, UDP, ICMP Ping, dan SMTP.
400 OriginPoolNotExist The specified origin pool does not exist or does not belong to your account or website. Check and try again. Kolam alamat asal yang ditentukan tidak ada, atau kolam alamat tersebut bukan milik pengguna dan situs saat ini. Verifikasi informasi dan coba lagi.
400 LoadBalancerNameConflict The load balancer name or the hostname for the origin pool already exists. Try again with a unique name. Nama load balancing atau nama Catatan kolam IPAM asal sudah ada. Gunakan nama yang unik dan coba lagi.
400 LockFailed The system is handling requests you previously submitted. Try again later. Permintaan lain sedang diproses. Coba lagi nanti.
400 SourceCircleExist The host record of the resource to be operated on is already the source station of another resource, or the source station of the current resource has been added as a host record. To avoid loopback, modify the host record or source station and retry. Catatan host Sumber daya yang ingin Anda operasikan sudah dikonfigurasi sebagai server asal Sumber daya lain, atau server asal Sumber daya saat ini sudah ditambahkan sebagai Catatan host. Untuk menghindari loop perutean, ubah Catatan host atau server asal dan coba lagi.
400 LoadBalancer.NameInvalid The name of the Server Load Balancer instance is a valid domain name or belongs to the site. Check that it is correct and try again. Nama instans load balancing adalah nama domain yang valid atau milik situs. Verifikasi nama dan coba lagi.
400 CompileRuleError Rule compilation failed, please check the rule information passed in to ensure that the rule is written according to the syntax described in the document. Kompilasi aturan gagal. Periksa konfigurasi aturan yang Anda tentukan. Lihat format konfigurasi aturan yang dijelaskan dalam referensi API.
400 InstanceNotExist The instance does not exist. Check whether the specified instance ID is correct or whether the instance belongs to your account. Instans tidak ada. Periksa apakah ID instans yang diberikan benar atau apakah instans tersebut milik akun Anda.
403 QuotaExceeded The quota is exceeded. Batas kuota harian telah terlampaui. Kuota pengiriman untuk hari ini telah habis digunakan. Anda dapat mengkueri jumlah tersisa yang tersedia untuk hari ini melalui API kuota.
404 SiteNotFound The website does not exist or does not belong to you. Situs tidak ada atau bukan milik Anda.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.