AttachVServerGroups - Auto Scaling - Alibaba Cloud Documentation Center

Menyambungkan kelompok vServer ke grup penskalaan. Setelah instance Classic Load Balancer (CLB) disambungkan ke grup penskalaan, instans dalam grup tersebut secara otomatis ditambahkan sebagai server backend pada instance CLB. Server-server ini kemudian menangani permintaan yang diteruskan oleh instance CLB, sehingga menyederhanakan pemrosesan traffic masuk. Untuk mengarahkan permintaan akses berbeda ke server backend terpisah atau mendistribusikan permintaan berdasarkan nama domain atau URL, Anda dapat memanggil operasi AttachVServerGroups. Operasi ini memungkinkan penambahan beberapa kelompok vServer, sehingga mempermudah pengelolaan berbagai konfigurasi server backend sesuai preferensi routing Anda.

Catatan penggunaan

Sebelum memanggil operasi ini untuk menyambungkan kelompok vServer ke grup penskalaan, pastikan persyaratan berikut terpenuhi:
- Instance CLB dan grup penskalaan termasuk dalam Akun Alibaba Cloud yang sama.
- Instance CLB dan grup penskalaan berada di Wilayah yang sama.
- Instance CLB berada dalam status Running.
- Instance CLB telah dikonfigurasi dengan setidaknya satu listener, dan fitur pemeriksaan kesehatan diaktifkan.
- Jika jenis jaringan instance CLB dan grup penskalaan adalah virtual private cloud (VPC), keduanya menggunakan VPC yang sama.
- Jika jenis jaringan grup penskalaan adalah VPC dan jenis jaringan instans CLB adalah jaringan klasik, setiap server backend dari instans CLB dalam pengaturan VPC berbagi VPC yang sama dengan grup penskalaan tersebut.
- Kelompok vServer yang akan disambungkan ke grup penskalaan termasuk dalam instance CLB tersebut.
- Operasi penyambungan kelompok vServer tidak menyebabkan jumlah total kelompok vServer melebihi batas kuota yang ditentukan. Untuk informasi tentang kuota kelompok vServer, lihat "Limits".
Saat memanggil operasi ini untuk menyambungkan kelompok vServer, Anda harus menentukan parameter berikut:
- LoadBalancerId: ID instance CLB
- VServerGroupId: ID kelompok vServer
- Port: nomor port kelompok vServer.
  Catatan
  Jika Anda mencoba menyambungkan kelompok vServer yang sama ke grup penskalaan beberapa kali melalui port yang identik, sistem menganggap setiap percobaan sebagai penyambungan kelompok vServer terpisah ke grup penskalaan. Namun, jika dalam satu permintaan Anda menyertakan ID kelompok vServer yang sama bersama dengan nomor port yang sama lebih dari sekali, hanya pasangan pertama yang dianggap valid; pasangan berikutnya akan diabaikan.

Debugging

OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kenyamanan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

Parameter permintaan

Parameter	Jenis	Wajib	Contoh	Deskripsi
Action	String	Ya	AttachVServerGroups	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke AttachVServerGroups.
RegionId	String	Ya	cn-hangzhou	ID wilayah grup penskalaan. Contoh: cn-hangzhou dan cn-shanghai. Untuk informasi tentang wilayah dan zona, lihat Regions and zones.
ScalingGroupId	String	Ya	asg-bp18p2yfxow2dloq****	ID grup penskalaan.
ClientToken	String	Tidak	123e4567-e89b-12d3-a456-42665544****	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan token ini dari sisi client, tetapi harus memastikan bahwa token tersebut unik di antara permintaan yang berbeda. Token hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Ensure idempotence.
ForceAttach	Boolean	Tidak	false	Menentukan apakah akan menambahkan instans Elastic Compute Service (ECS) atau instans elastic container yang sudah ada dalam grup penskalaan ke kelompok vServer baru. true false Nilai default: false.
VServerGroup.N.VServerGroupAttribute.N.VServerGroupId	String	Tidak	rsp-bp1jp1rge****	ID kelompok vServer. Dua N dalam nama parameter masing-masing memiliki arti sebagai berikut: N pertama dalam parameter ini menentukan nomor seri instance CLB. Nilai valid untuk N pertama: 1 hingga 5. N kedua dalam parameter ini menentukan nomor seri kelompok vServer yang termasuk dalam instance CLB tersebut. Nilai valid untuk N kedua: 1 hingga 5.
VServerGroup.N.VServerGroupAttribute.N.Weight	Integer	Tidak	100	Bobot instans ECS atau instans elastic container sebagai server backend dalam kelompok vServer baru. Nilai valid: 0 hingga 100. Dua N dalam nama parameter masing-masing memiliki arti sebagai berikut: N pertama dalam parameter ini menentukan nomor seri instance CLB. Nilai valid untuk N pertama: 1 hingga 5. N kedua dalam parameter ini menentukan nomor seri kelompok vServer yang termasuk dalam instance CLB tersebut. Nilai valid untuk N kedua: 1 hingga 5. Nilai default: 50.
VServerGroup.N.VServerGroupAttribute.N.Port	Integer	Tidak	22	Nomor port yang digunakan oleh Auto Scaling untuk menambahkan instans ECS atau instans elastic container ke kelompok vServer baru. Nilai valid: 1 hingga 65535. Dua N dalam nama parameter masing-masing memiliki arti sebagai berikut: N pertama dalam parameter ini menentukan nomor seri instance CLB. Nilai valid untuk N pertama: 1 hingga 5. N kedua dalam parameter ini menentukan nomor seri kelompok vServer yang termasuk dalam instance CLB tersebut. Nilai valid untuk N kedua: 1 hingga 5.
VServerGroup.N.LoadBalancerId	String	Tidak	lb-bp1u7etiogg38yvwz****	ID instance CLB ke-N tempat kelompok vServer tersebut termasuk. N menentukan nomor seri instance CLB. Nilai valid untuk N: 1 hingga 5.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID permintaan.

Contoh

Permintaan contoh

http(s)://ess.aliyuncs.com/?Action=AttachVServerGroups
&RegionId=cn-hangzhou
&ScalingGroupId=asg-bp18p2yfxow2dloq****
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&ForceAttach=false
&VServerGroup=[{"VServerGroupAttribute":[{"VServerGroupId":"rsp-bp1jp1rge****","Weight":100,"Port":22}],"LoadBalancerId":"lb-bp1u7etiogg38yvwz****"}]
&<Common request parameters>

Respons sukses contoh

XML format

HTTP/1.1 200 OK
Content-Type:application/xml

<AttachVServerGroupsResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AttachVServerGroupsResponse>

JSON format

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Kode kesalahan

Untuk daftar kode kesalahan, lihat Service error codes.

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
403	Forbidden.Unauthorized	A required authorization for the specified action is not supplied.	Auto Scaling tidak memiliki otorisasi untuk memanggil operasi yang ditentukan.
404	InvalidScalingGroupId.NotFound	The specified scaling group does not exist.	Grup penskalaan yang ditentukan tidak ada dalam Akun Alibaba Cloud.
404	InvalidLoadBalancerId.NotFound	The load balancer "%s" does not exist.	Instance CLB yang ditentukan tidak ada dalam Akun Alibaba Cloud.
400	InvalidLoadBalancerId.RegionMismatch	The load balancer "%s" and the specified scaling group are not in the same Region.	Instance CLB dan grup penskalaan tidak berada di wilayah yang sama.
400	IncorrectLoadBalancerStatus	The current status of the load balancer "%s" does not support this action.	Operasi ini tidak didukung saat instance CLB berada dalam status saat ini.
400	IncorrectLoadBalancerHealthCheck	The current health check type of the load balancer "%s" does not support this action.	Fitur pemeriksaan kesehatan tidak diaktifkan untuk instance CLB.
400	InvalidLoadBalancerId.VPCMismatch	The specified virtual switch and the instance in the load balancer "%s" are not in the same VPC.	Instance CLB dan grup penskalaan tidak berada di VPC yang sama.
400	InvalidVServerGroupId.ForLoadBalancer	Invalid VServerGroupId For LoadBalancer "%s".	Kelompok vServer yang ditentukan oleh VServerGroupId tidak termasuk dalam instance CLB yang ditentukan.
400	QuotaExceeded.VServerGroup	VServerGroup quota exceeded in the specified scaling group.	Jumlah maksimum kelompok vServer yang dapat disambungkan ke grup penskalaan telah tercapai.