AttachLoadBalancers - Auto Scaling - Alibaba Cloud Documentation Center

Menyambungkan load balancer ke grup penskalaan. Auto Scaling mendukung penyambungan load balancer ke grup penskalaan. Load balancer membantu mendistribusikan lalu lintas akses ke instans dalam grup penskalaan, sehingga secara efektif meningkatkan kinerja layanan grup tersebut. Anda dapat memanggil operasi AttachLoadBalancers untuk menyambungkan satu atau beberapa load balancer ke grup penskalaan Anda.

Catatan penggunaan

Sebelum memanggil operasi ini, pastikan persyaratan berikut terpenuhi:

Load balancer dan grup penskalaan berada dalam Akun Alibaba Cloud dan Wilayah yang sama.
Load balancer berada dalam status Running.
Setidaknya satu listener telah dikonfigurasi untuk load balancer, dan fitur pemeriksaan kesehatan telah diaktifkan pada load balancer tersebut.
Jika jenis jaringan load balancer dan grup penskalaan adalah virtual private cloud (VPC), keduanya harus menggunakan VPC yang sama.
Jika jenis jaringan grup penskalaan adalah VPC sedangkan jenis jaringan load balancer adalah jaringan klasik, dan salah satu server backend load balancer menggunakan VPC, maka grup penskalaan dan server backend tersebut harus menggunakan VPC yang sama.
Penyambungan load balancer harus memastikan bahwa jumlah kumulatif load balancer yang disambungkan ke grup penskalaan tetap berada dalam batas kuota maksimum. Untuk informasi mengenai kuota load balancer, lihat Batas.

Debugging

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

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	AttachLoadBalancers	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke AttachLoadBalancers.
ScalingGroupId	String	Ya	asg-bp1avr6ensitts3w****	ID grup penskalaan.
ForceAttach	Boolean	Tidak	false	Menentukan apakah akan menambahkan semua instans dalam grup penskalaan saat ini ke grup server backend dari instans Classic Load Balancer (CLB, sebelumnya dikenal sebagai SLB) yang ditandai untuk disambungkan. Nilai yang valid: true: Jika Anda menetapkan parameter ini ke `true`, operasi penyambungan akan menambahkan instans yang ada dalam grup penskalaan ke grup server backend instans CLB. Catatan Jika sebuah load balancer saat ini sudah disambungkan ke grup penskalaan Anda, dan Anda ingin menambahkan instans dalam grup penskalaan tersebut ke grup server backend load balancer, Anda dapat memanggil operasi ini lagi dan menetapkan parameter permintaan `ForceAttach` ke `true`. false: Jika Anda menetapkan parameter ini ke `false`, operasi penyambungan tidak akan menambahkan instans yang ada dalam grup penskalaan ke grup server backend instans CLB. Nilai default: false.
ClientToken	String	Tidak	123e4567-e89b-12d3-a456-42665544****	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan token ini di 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 Memastikan idempotensi.
Async	Boolean	Tidak	false	Menentukan apakah operasi penyambungan dilakukan secara asinkron. Panggilan asinkron menjaga integritas transaksi operasi, memastikan bahwa hasil eksekusi hanya diterapkan ketika semua operasi berhasil diselesaikan. Kami menyarankan agar Anda menetapkan parameter ini ke true. Nilai yang valid: true: melakukan operasi penyambungan secara asinkron. Dalam hal ini, ID aktivitas penskalaan akan dikembalikan. false: tidak melakukan operasi penyambungan secara asinkron. Nilai default: false.
LoadBalancer.N	String	Tidak	lb-2zeur05gfs****	ID instans CLB ke-N. Nilai N yang valid: 1 hingga 5. Catatan Anda dapat menyambungkan hingga lima load balancer ke satu grup penskalaan dalam satu panggilan.
LoadBalancerConfig.N.LoadBalancerId	String	Tidak	147b46d767c-cn-qingdao-cm5****	ID instans CLB.
LoadBalancerConfig.N.Weight	Integer	Tidak	10	Bobot setiap instans sebagai server backend. Bobot yang lebih tinggi berarti instans tersebut akan menerima proporsi permintaan masuk yang lebih besar. Jika sebuah instans diberi bobot 0, instans tersebut tidak akan menerima permintaan akses apa pun. Nilai yang valid: 0 hingga 100.

Parameter respons

Parameter

Tipe

Contoh

Deskripsi

ScalingActivityId

String

asa-bp140qd7mak8k63f****

ID aktivitas penskalaan.

Parameter ini hanya dikembalikan jika Anda menetapkan Async ke true. Anda dapat memanggil operasi DescribeScalingActivities untuk melacak ID aktivitas penskalaan dan melihat status aktivitas penskalaan tersebut.

RequestId

String

473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

ID permintaan.

Contoh

Contoh permintaan

http(s)://ess.aliyuncs.com/?Action=AttachLoadBalancers
&ScalingGroupId=asg-bp1avr6ensitts3w****
&ForceAttach=false
&ClientToken=123e4567-e89b-12d3-a456-42665544****
&Async=false
&LoadBalancer=["lb-2zeur05gfs****"]
&LoadBalancerConfig=[{"LoadBalancerId":"147b46d767c-cn-qingdao-cm5****","Weight":10}]
&<Common request parameters>

Contoh respons sukses

XML format

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

<AttachLoadBalancersResponse>
    <ScalingActivityId>asa-bp140qd7mak8k63f****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</AttachLoadBalancersResponse>

JSON format

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

{
  "ScalingActivityId" : "asa-bp140qd7mak8k63f****",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Kode kesalahan

Untuk daftar lengkap kode kesalahan, lihat Kode kesalahan layanan.

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 ini.
404	InvalidScalingGroupId.NotFound	The specified scaling group does not exist.	Grup penskalaan yang ditentukan tidak ada dalam Akun Alibaba Cloud.
400	QuotaExceeded.LoadBalancer	LoadBalancer quota exceeded in the scaling group "%s".	Jumlah instans CLB yang dapat disambungkan ke grup penskalaan melebihi batas atas.
404	InvalidLoadBalancerId.NotFound	The load balancer "%s" does not exist.	Instans 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.	Instans CLB dan grup penskalaan tidak berada dalam wilayah yang sama.
400	IncorrectLoadBalancerStatus	The current status of the load balancer "%s" does not support this action.	Operasi ini tidak didukung ketika instans 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 belum diaktifkan pada instans CLB.
400	InvalidLoadBalancerId.VPCMismatch	The specified virtual switch and the instance in the load balancer "%s" are not in the same VPC.	Instans CLB dan grup penskalaan tidak berada dalam VPC yang sama.
400	QuotaExceeded.BackendServer	Backend server quota exceeded in the load balancer "%s".	Jumlah server backend instans CLB melebihi batas atas.
404	InvalidScalingConfigurationId.NotFound	The specified scaling configuration does not exist.	Grup penskalaan tidak memiliki konfigurasi penskalaan yang diaktifkan.