CreateServerGroup - Server Load Balancer

Membuat server group di suatu wilayah.

Deskripsi operasi

CreateServerGroup adalah operasi asinkron. Setelah permintaan dikirim, sistem mengembalikan ID permintaan dan menjalankan tugas di latar belakang. Anda dapat memanggil ListServerGroups untuk memeriksa status server group.

Jika server group berada dalam status Creating, berarti server group sedang dalam proses pembuatan.
Jika server group berada dalam status Available, berarti server group 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:CreateServerGroup

create

*ServerGroup

acs:alb:{#regionId}:{#accountId}:servergroup/*

alb:ServerGroupProtocol

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ServerGroupName	string	Yes	Nama server group. Nama harus terdiri dari 2 hingga 128 karakter, dan dapat berisi huruf, angka, titik (.), garis bawah (_), serta tanda hubung (-). Nama harus dimulai dengan huruf.	test
ServerGroupType	string	No	Tipe server group. Nilai yang valid: Instance (default): memungkinkan Anda menambahkan server dengan menentukan Ecs, Eni, atau Eci. Ip: memungkinkan Anda menambahkan server dengan menentukan alamat IP. Fc: memungkinkan Anda menambahkan server dengan menentukan fungsi Function Compute.	Instance
VpcId	string	No	ID virtual private cloud (VPC). Anda hanya dapat menambahkan server yang ditempatkan di VPC yang ditentukan ke server group. Catatan Parameter ini berlaku ketika parameter ServerGroupType diatur ke Instance atau Ip.	vpc-bp15zdkdt37pq72zv****
Scheduler	string	No	Algoritma penjadwalan. Nilai yang valid: Wrr (default): Menggunakan algoritma Round-robin berbobot. Server backend dengan bobot lebih tinggi menerima lebih banyak permintaan daripada yang memiliki bobot lebih rendah. Wlc: Menggunakan algoritma jumlah koneksi paling sedikit dengan bobot. Permintaan didistribusikan berdasarkan bobot dan jumlah koneksi ke server backend. Jika dua server backend memiliki bobot yang sama, server backend dengan koneksi lebih sedikit diharapkan menerima lebih banyak permintaan. Sch: Menggunakan algoritma penghashan konsisten. Permintaan dari alamat IP sumber yang sama didistribusikan ke server backend yang sama. Catatan Parameter ini berlaku ketika parameter ServerGroupType diatur ke Instance atau Ip.	Wrr
Protocol	string	No	Protokol backend. Nilai yang valid: HTTP: memungkinkan Anda mengaitkan listener HTTPS, HTTP, atau QUIC dengan server group. Ini adalah nilai default. HTTPS: memungkinkan Anda mengaitkan listener HTTPS dengan server backend. gRPC: memungkinkan Anda mengaitkan listener HTTPS atau QUIC dengan server group. Catatan Anda tidak perlu menentukan protokol backend jika Anda mengatur ServerGroupType ke Fc.	HTTP
ResourceGroupId	string	No	ID kelompok sumber daya.	rg-atstuj3rsop****
HealthCheckConfig	object	Yes	Konfigurasi fitur Pemeriksaan kesehatan.
HealthCheckConnectPort	integer	No	Port backend yang digunakan untuk pemeriksaan kesehatan. Nilai yang valid: 0 hingga 65535 Nilai default adalah 0, yang menunjukkan bahwa port server backend digunakan untuk pemeriksaan kesehatan.	80
HealthCheckEnabled	boolean	Yes	Menentukan apakah fitur pemeriksaan kesehatan diaktifkan. Nilai yang valid: true false Catatan Jika parameter ServerGroupType diatur ke Instance atau Ip, fitur pemeriksaan kesehatan diaktifkan secara default. Jika parameter ServerGroupType diatur ke Fc, fitur pemeriksaan kesehatan dinonaktifkan secara default.	true
HealthCheckHost	string	No	Nama domain yang digunakan untuk pemeriksaan kesehatan. Backend Server Internal IP (default): Gunakan alamat IP internal server backend sebagai nama domain pemeriksaan kesehatan. Custom Domain Name: Masukkan nama domain. Nama domain harus terdiri dari 1 hingga 80 karakter. Nama domain dapat berisi huruf kecil, angka, tanda hubung (-), dan titik (.). Nama domain harus mengandung setidaknya satu titik (.) tetapi tidak boleh dimulai atau diakhiri dengan titik (.). Label domain paling kanan hanya boleh berisi huruf, dan tidak boleh berisi angka atau tanda hubung (-). Nama domain tidak boleh dimulai atau diakhiri dengan tanda hubung (-). Catatan Parameter ini hanya berlaku jika HealthCheckProtocol diatur ke HTTP, HTTPS, atau gRPC.	www.example.com
HealthCheckCodes	array	No	Kode status HTTP yang menunjukkan server backend dalam kondisi sehat.
	string	No	Kode status HTTP yang menunjukkan server backend dalam kondisi sehat. Ketika HealthCheckProtocol diatur ke HTTP atau HTTPS, Anda dapat mengatur HealthCheckCodes ke http_2xx (nilai default), http_3xx, http_4xx, dan http_5xx. Pisahkan beberapa kode status HTTP dengan koma (,). Jika HealthCheckProtocol diatur ke gRPC, nilai yang valid untuk HealthCheckCodes berkisar dari 0 hingga 99. Nilai default adalah 0. Rentang nilai didukung. Anda dapat menentukan maksimal 20 rentang nilai. Pisahkan beberapa rentang nilai dengan koma (,). Catatan Parameter ini hanya berlaku jika HealthCheckProtocol diatur ke HTTP, HTTPS, atau gRPC.	http_2xx
HealthCheckHttpVersion	string	No	Versi protokol HTTP. Nilai yang valid: HTTP1.0 dan HTTP1.1. Nilai default: HTTP1.1. Catatan Parameter ini hanya berlaku jika HealthCheckProtocol diatur ke HTTP atau HTTPS.	HTTP1.1
HealthCheckInterval	integer	No	Interval pelaksanaan pemeriksaan kesehatan. Satuan: detik Nilai yang valid: 1 hingga 50 Nilai default: 2.	2
HealthCheckMethod	string	No	Metode HTTP yang digunakan untuk pemeriksaan kesehatan. Nilai yang valid: GET: Jika panjang respons melebihi 8 KB, respons akan dipotong. Namun, hasil pemeriksaan kesehatan tidak terpengaruh. POST: Secara default, pemeriksaan kesehatan gRPC menggunakan metode POST. HEAD (default): Secara default, HTTP dan HTTPS menggunakan metode HEAD. Catatan Parameter ini hanya berlaku jika HealthCheckProtocol diatur ke HTTP, HTTPS, atau gRPC.	HEAD
HealthCheckPath	string	No	URL yang digunakan untuk pemeriksaan kesehatan. URL harus terdiri dari 1 hingga 80 karakter, dan dapat berisi huruf, angka, serta karakter khusus berikut: `- / . % ? # & =`. URL juga dapat berisi karakter tambahan berikut: `_ ; ~ ! ( ) * [ ] @ $ ^ : ' , +`. URL harus dimulai dengan garis miring (/). Catatan Parameter ini hanya berlaku jika HealthCheckProtocol diatur ke HTTP atau HTTPS.	/test/index.html
HealthCheckProtocol	string	No	Protokol yang digunakan untuk pemeriksaan kesehatan. Nilai yang valid: HTTP: Pemeriksaan kesehatan HTTP mensimulasikan perilaku browser dengan mengirim permintaan HEAD atau GET untuk memeriksa ketersediaan server backend. HTTPS: Pemeriksaan kesehatan HTTPS mensimulasikan perilaku browser dengan mengirim permintaan HEAD atau GET untuk memeriksa ketersediaan server backend. HTTPS menyediakan keamanan lebih tinggi daripada HTTP karena HTTPS mendukung enkripsi data. TCP: Pemeriksaan kesehatan TCP mengirim paket TCP SYN ke server backend untuk memeriksa ketersediaan server backend. gRPC: Pemeriksaan kesehatan gRPC mengirim permintaan POST atau GET ke server backend untuk memeriksa apakah server backend dalam kondisi sehat.	HTTP
HealthCheckTimeout	integer	No	Batas waktu respons pemeriksaan kesehatan. Jika server backend tidak merespons dalam batas waktu yang ditentukan, server backend tersebut dinyatakan tidak sehat. Satuan: detik Nilai yang valid: 1 hingga 300 Nilai default: 5	5
HealthyThreshold	integer	No	Jumlah kali server backend yang tidak sehat harus lulus pemeriksaan kesehatan secara berturut-turut sebelum dinyatakan sehat. Dalam kasus ini, status pemeriksaan kesehatan server backend berubah dari fail menjadi success. Nilai yang valid: 2 hingga 10 Nilai default: 3.	3
UnhealthyThreshold	integer	No	Jumlah kali server backend yang sehat harus gagal pemeriksaan kesehatan secara berturut-turut sebelum dinyatakan tidak sehat. Dalam kasus ini, status pemeriksaan kesehatan server backend berubah dari success menjadi fail. Nilai yang valid: 2 hingga 10 Nilai default: 3	3
StickySessionConfig	object	No	Konfigurasi persistensi sesi. Catatan Parameter ini berlaku ketika parameter ServerGroupType diatur ke Instance atau Ip.
Cookie	string	No	Cookie yang ingin Anda konfigurasikan untuk server. Cookie harus terdiri dari 1 hingga 200 karakter, dan hanya dapat berisi huruf ASCII dan angka. Cookie tidak boleh berisi koma (,), titik koma (;), atau spasi. Cookie tidak boleh dimulai dengan tanda dolar ($). Catatan Parameter ini hanya berlaku ketika StickySessionEnabled diatur ke true dan StickySessionType diatur ke server.	B490B6EBF6F3CD402E515D22BCDA****
CookieTimeout	integer	No	Jumlah waktu maksimum sebelum cookie sesi kedaluwarsa. Satuan: detik Nilai yang valid: 1 hingga 86400 Nilai default: 1000 Catatan Parameter ini hanya berlaku ketika StickySessionEnabled diatur ke true dan StickySessionType diatur ke Insert.	1000
StickySessionEnabled	boolean	No	Menentukan apakah persistensi sesi diaktifkan. Nilai yang valid: true false Catatan Parameter ini berlaku ketika parameter ServerGroupType diatur ke Instance atau Ip.	false
StickySessionType	string	No	Metode yang digunakan untuk menangani cookie. Nilai yang valid: Insert (nilai default): menyisipkan cookie. Saat pertama kali client mengakses ALB, ALB menyisipkan cookie SERVERID ke dalam paket respons HTTP atau HTTPS. Permintaan selanjutnya dari client yang membawa cookie ini akan diteruskan ke server backend yang sama seperti permintaan pertama. Server: menulis ulang cookie. ALB menulis ulang cookie kustom dalam permintaan dari client. Permintaan selanjutnya dari client yang membawa cookie baru ini akan diteruskan ke server backend yang sama seperti permintaan pertama. Catatan Parameter ini berlaku ketika parameter StickySessionEnabled diatur ke true.	Insert
ClientToken	string	No	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan client untuk menghasilkan token, tetapi Anda harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII. Catatan Jika Anda tidak menentukan parameter ini, sistem secara otomatis menggunakan request ID sebagai client token. Request ID mungkin berbeda untuk setiap permintaan.	5A2CAF0E-5718-45B5-9D4D-70B******
DryRun	boolean	No	Menentukan apakah hanya melakukan dry run tanpa menjalankan permintaan sebenarnya. Nilai yang valid: true: hanya melakukan dry run. Sistem memeriksa permintaan terhadap potensi masalah, termasuk nilai parameter yang hilang, sintaksis permintaan yang salah, dan batasan layanan. Jika permintaan gagal dalam dry run, kode kesalahan dikembalikan. Jika permintaan lolos dry run, kode kesalahan `DryRunOperation` dikembalikan. false (default): melakukan dry run dan menjalankan permintaan sebenarnya. Jika permintaan lolos dry run, kode status HTTP 2xx dikembalikan dan operasi dilakukan.	false
Ipv6Enabled	boolean	No	Menentukan apakah Ipv6 diaktifkan.	false
UpstreamKeepaliveEnabled	boolean	No	Menentukan apakah Koneksi TCP persisten diaktifkan.	false
ServiceName	string	No	Parameter ini tersedia hanya jika controller Ingress ALB digunakan. Dalam hal ini, atur parameter ini ke nama `Kubernetes Service` yang dikaitkan dengan server group.	test
UchConfig	object	No	Konfigurasi penghashan konsisten berdasarkan URL.
Type	string	Yes	Tipe parameter.	QueryString
Value	string	Yes	Nilai parameter untuk penghashan konsisten.	abc
ConnectionDrainConfig	object	No	Konfigurasi Pengurasan koneksi. Setelah Pengurasan koneksi diaktifkan, ALB mempertahankan transmisi data untuk periode tertentu setelah server backend dihapus atau dinyatakan tidak sehat. Catatan Instans ALB Basic tidak mendukung Pengurasan koneksi. Instans ALB Standard dan yang diaktifkan WAF mendukung Pengurasan koneksi. Server group tipe instance dan IP mendukung Pengurasan koneksi. Server group tipe Function Compute tidak mendukung Pengurasan koneksi.
ConnectionDrainEnabled	boolean	No	Menentukan apakah Pengurasan koneksi diaktifkan. Nilai yang valid: true false (default)	false
ConnectionDrainTimeout	integer	No	Batas waktu Pengurasan koneksi. Nilai yang valid: 0 hingga 900. Nilai default: 300.	300
SlowStartConfig	object	No	Konfigurasi mulai lambat. Setelah mulai lambat diaktifkan, SLB melakukan Pra-ambil data ke server backend yang baru ditambahkan. Permintaan yang didistribusikan ke server backend meningkat secara bertahap. Catatan Instans SLB Basic tidak mendukung mulai lambat. Instans SLB Standard dan yang diaktifkan WAF mendukung mulai lambat. Server group tipe server dan IP mendukung mulai lambat. Server group tipe Function Compute tidak mendukung mulai lambat. Mulai lambat hanya didukung oleh algoritma penjadwalan Round-robin berbobot.
SlowStartEnabled	boolean	No	Menentukan apakah mulai lambat diaktifkan. Nilai yang valid: true false(default)	false
SlowStartDuration	integer	No	Durasi mulai lambat. Nilai yang valid: 30 hingga 900. Nilai default: 30.	30
Tag	array<object>	No	Tag.
	object	No
Key	string	No	Kunci tag. Panjang kunci tag dapat mencapai 128 karakter, dan tidak boleh dimulai dengan `acs:` atau `aliyun`. Tidak boleh berisi `http://` atau `https://`.	env
Value	string	No	Nilai tag. Panjang nilai tag dapat mencapai 128 karakter, dan tidak boleh dimulai dengan `acs:` atau `aliyun`. Tidak boleh berisi `http://` atau `https://`.	product
CrossZoneEnabled	boolean	No	Menentukan apakah load balancing lintas zona diaktifkan. Nilai yang valid: true (default) false Catatan Instans ALB Basic tidak mendukung server group yang menonaktifkan load balancing lintas zona. Hanya instans ALB Standard dan yang diaktifkan WAF yang mendukung server group dengan load balancing lintas zona. Load balancing lintas zona dapat dinonaktifkan untuk server group tipe server dan IP, tetapi tidak untuk server group tipe Function Compute. Ketika load balancing lintas zona dinonaktifkan, persistensi sesi tidak dapat diaktifkan.	true

Elemen respons

Element	Type	Description	Example
	object	Parameter respons.
JobId	string	ID pekerjaan asinkron.	72dcd26b-f12d-4c27-b3af-18f6aed5****
RequestId	string	ID permintaan.	365F4154-92F6-4AE4-92F8-7FF******
ServerGroupId	string	ID server group.	sgp-8ilqs4axp6******

Contoh

Respons sukses

JSONformat

{
  "JobId": "72dcd26b-f12d-4c27-b3af-18f6aed5****",
  "RequestId": "365F4154-92F6-4AE4-92F8-7FF******",
  "ServerGroupId": "sgp-8ilqs4axp6******"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	QuotaExceeded.ServerGroupsNum	The quota of %s is exceeded, usage %s/%s.
400	Mismatch.LoadBalancerEditionAndSlowStartEnable	The %s and %s are mismatched.
400	Mismatch.ServerGroupSchedulerAndSlowStartEnable	The %s and %s are mismatched.
400	QuotaExceeded.SlowStartDuration	The quota of %s is exceeded, usage %s/%s.
400	UnsupportedFeature.SlowStart	The feature of %s is not supported.
400	Mismatch.LoadBalancerEditionAndConnectionDrain	The %s and %s are mismatched.
400	QuotaExceeded.ConnectionDrainTimeout	The quota of %s is exceeded, usage %s/%s.
400	UnsupportedFeature.ConnectionDrain	The feature of %s is not supported.
400	NotExist.ResourceGroup	ResourceGroup does not exist.
400	OperationDenied.VpcNotSupportIpv6	The operation is not allowed because of VpcNotSupportIpv6.
400	UnsupportedFeature.FcServerGroup	Server groups of type FC are not supported.
404	ResourceNotFound.Vpc	The specified resource %s is not found.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.