DetachInstances - Auto Scaling - Alibaba Cloud Documentation Center

Menghapus instance dari grup penskalaan. Jika grup penskalaan Anda berada dalam status Enabled dan tidak memiliki aktivitas penskalaan yang sedang berlangsung, Anda dapat memanggil operasi DetachInstances untuk menghapus satu atau beberapa Instance Elastic Compute Service (ECS), instance kontainer elastis, atau instance pihak ketiga yang dikelola Alibaba Cloud dari grup penskalaan tersebut.

Catatan penggunaan

Sebelum memanggil operasi DetachInstances, pastikan kondisi berikut terpenuhi:
- Grup penskalaan yang ditentukan telah diaktifkan.
- Grup penskalaan yang ditentukan tidak memiliki aktivitas penskalaan yang sedang berlangsung.
  Catatan
  Jika grup penskalaan yang ditentukan tidak memiliki aktivitas penskalaan yang sedang berlangsung, operasi ini dapat melewati periode cooldown grup penskalaan dan segera memicu aktivitas penskalaan.
Saat memanggil operasi ini, perhatikan hal-hal berikut:
- Setelah Anda menghapus Instance ECS, instance kontainer elastis, atau instance pihak ketiga yang dikelola Alibaba Cloud dari grup penskalaan yang ditentukan, instance tersebut dapat berjalan secara independen. Anda juga dapat memanggil operasi AttachInstances untuk menambahkan instance tersebut ke grup penskalaan lain.
- Setelah Anda memanggil operasi ini untuk menghapus Instance ECS, instance kontainer elastis, atau instance pihak ketiga yang dikelola Alibaba Cloud dari grup penskalaan yang ditentukan, instance tersebut tidak dihentikan atau dirilis.
- Pemanggilan yang berhasil hanya menunjukkan bahwa Auto Scaling telah menerima permintaan, tetapi tidak menjamin keberhasilan aktivitas penskalaan. Anda dapat memperoleh status aktivitas penskalaan berdasarkan nilai kembali ScalingActivityId.
- Setelah Anda menghapus jumlah tertentu Instance ECS, instance kontainer elastis, atau instance pihak ketiga yang dikelola Alibaba Cloud dari grup penskalaan yang ditentukan, jumlah instance yang tersisa harus sama dengan atau lebih besar dari jumlah minimum instance yang harus ada dalam grup penskalaan. Jika tidak, operasi akan gagal dan kesalahan akan dilaporkan.

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 ini untuk berbagai SDK.

Parameter permintaan

Parameter	Tipe	Wajib	Contoh	Deskripsi
Action	String	Ya	DetachInstances	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke DetachInstances.
ScalingGroupId	String	Ya	asg-bp1igpak5ft1flyp****	ID grup penskalaan.
DecreaseDesiredCapacity	Boolean	Tidak	true	Menentukan apakah akan memodifikasi jumlah instans yang diharapkan dalam grup penskalaan. Nilai yang valid: true: Setelah Anda memanggil operasi ini untuk menghapus jumlah tertentu Instance ECS, instance kontainer elastis, atau instance pihak ketiga yang dikelola Alibaba Cloud dari grup penskalaan yang ditentukan, jumlah instans yang diharapkan berkurang. false: Setelah Anda memanggil operasi ini untuk menghapus jumlah tertentu Instance ECS, instance kontainer elastis, atau instance pihak ketiga yang dikelola Alibaba Cloud dari grup penskalaan yang ditentukan, jumlah instans yang diharapkan tetap tidak berubah. Nilai default: true.
IgnoreInvalidInstance	Boolean	Tidak	false	Menentukan apakah akan mengabaikan instans yang tidak valid saat sejumlah instans dihapus dari grup penskalaan. Nilai yang valid: true: mengabaikan instans yang tidak valid. Jika kumpulan instans mencakup instans yang tidak valid, seperti instans dalam status `Adding`, dan instans yang valid berhasil dihapus dari grup penskalaan, aktivitas penskalaan terkait akan masuk ke status `Warning`. Anda dapat membuka halaman detail aktivitas penskalaan untuk melihat instans yang tidak valid tersebut. false: tidak mengabaikan instans yang tidak valid. Jika kumpulan instans mencakup instans yang tidak valid, seperti instans dalam status `Adding`, kesalahan akan dilaporkan. Nilai default: false.
DetachOption	String	Tidak	both	Menentukan apakah akan menghapus Instance ECS atau instance kontainer elastis dari kelompok server default dan kelompok vServer pada Instance Server Load Balancer (SLB) yang terhubung, serta apakah akan menghapus alamat IP pribadi mereka dari daftar putih alamat IP pada Instance ApsaraDB RDS yang terhubung. Jika Anda menetapkan parameter ini ke both, instans akan dihapus dari kelompok server default dan kelompok vServer pada Instance SLB yang terhubung, serta alamat IP mereka akan dihapus dari daftar putih alamat IP pada Instance ApsaraDB RDS yang terhubung. Catatan Parameter ini tidak tersedia jika Anda memanggil operasi ini untuk menghapus sejumlah instance pihak ketiga yang dikelola Alibaba Cloud dari grup penskalaan.
InstanceId.N	String	Tidak	i-bp109k5j3dum1ce6****	ID Instance ECS N, instance kontainer elastis N, atau instance pihak ketiga yang dikelola Alibaba Cloud N yang ingin Anda hapus dari grup penskalaan. Nilai N yang valid: 1 hingga 20. Contoh: Contoh ID Instance ECS: `i-bp109k5j3dum1ce6**`. Contoh ID instance kontainer elastis: `eci-bp17gw49eu09yiwm`. Contoh ID instans terkelola: `mi-d23fsd**`. Catatan** Anda hanya dapat memanggil operasi ini untuk menghapus instans dengan tipe yang sama dalam satu kali panggilan.
LifecycleHook	Boolean	Tidak	false	Menentukan apakah akan memicu kait siklus hidup saat Anda memanggil operasi ini. Nilai yang valid: true false Catatan Parameter ini tidak tersedia jika Anda memanggil operasi ini untuk menghapus sejumlah instance pihak ketiga yang dikelola Alibaba Cloud dari grup penskalaan. Nilai default: false.
ClientToken	String	Tidak	123e4567-e89b-12d3-a456-42665544****	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi Anda 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.

Parameter respons

Parameter	Tipe	Contoh	Deskripsi
ScalingActivityId	String	asa-bp1gbswjhjrw8tko****	ID aktivitas penskalaan.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID permintaan.

Contoh

Contoh permintaan

http(s)://ess.aliyuncs.com/?Action=DetachInstances
&ScalingGroupId=asg-bp1igpak5ft1flyp****
&DecreaseDesiredCapacity=true
&IgnoreInvalidInstance=false
&DetachOption=both
&InstanceId=["i-bp109k5j3dum1ce6****"]
&LifecycleHook=false
&<Common request parameters>

Contoh respons sukses

XML format

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

<DetachInstancesResponse>
    <ScalingActivityId>asa-bp1gbswjhjrw8tko****</ScalingActivityId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</DetachInstancesResponse>

JSON format

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

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

Kode kesalahan

Untuk daftar kode kesalahan, lihat Service error codes.

Kode status HTTP	Kode kesalahan	Pesan kesalahan	Deskripsi
400	IncorrectScalingGroupStatus	The current status of the specified scaling group does not support this action.	Grup penskalaan yang ditentukan belum diaktifkan.
400	ScalingActivityInProgress	You cannot delete a scaling group or launch a new scaling activity while there is a scaling activity in progress for the specified scaling group.	Grup penskalaan yang ditentukan memiliki aktivitas penskalaan yang sedang berlangsung.
400	IncorrectLoadBalancerStatus	The current status of the specified load balancer does not support this action.	Instance SLB yang ditentukan tidak dalam status Active.
400	IncorrectDBInstanceStatus	The current status of DB instance "XXX" does not support this action.	Instance ApsaraDB RDS yang ditentukan tidak dalam status Running.
400	IncorrectCapacity.MinSize	To remove the instances, the total capacity will be lesser than the MinSize.	Jumlah Instance ECS atau instance kontainer elastis dalam grup penskalaan kurang dari nilai MinSize jika jumlah instans yang ditentukan dihapus.
403	Forbidden.Unauthorized	A required authorization for the specified action is not supplied.	Anda 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.
404	InvalidInstanceId.NotFound	Instance "XXX" does not exist.	Instance ECS atau instance kontainer elastis yang ditentukan tidak ada dalam Akun Alibaba Cloud.