All Products
Search
Document Center

Auto Scaling:DetachInstances

Last Updated:Jun 12, 2026

Jika grup penskalaan dalam status Enabled dan tidak ada aktivitas penskalaan yang sedang dijalankan dalam grup penskalaan, Anda dapat memanggil operasi DetachInstances untuk menghapus satu atau beberapa instans ECS, instans kontainer elastis, atau instans terkelola dari grup penskalaan.

Deskripsi operasi

  • Sebelum Anda memanggil operasi ini, pastikan kondisi berikut terpenuhi:

    • Grup penskalaan dalam status Enabled.

    • Grup penskalaan tidak memiliki aktivitas penskalaan yang sedang berlangsung.

    Catatan

    Jika grup penskalaan tidak memiliki aktivitas penskalaan yang sedang berlangsung, operasi ini dapat melewati waktu pendinginan dan langsung memicu aktivitas penskalaan.

  • Perhatikan hal-hal berikut:

    • Setelah instans ECS, instans kontainer elastis, atau instans terkelola dihapus dari grup penskalaan, instans tersebut tetap ada secara independen. Anda dapat memanggil operasi AttachInstances untuk menambahkan instans ke grup penskalaan lain.

    • Memanggil operasi ini untuk menghapus instans ECS, instans kontainer elastis, atau instans terkelola tidak menghentikan atau melepaskan instans tersebut.

    • Setelah operasi dipanggil, ini hanya menunjukkan bahwa Auto Scaling telah menerima permintaan. Aktivitas penskalaan dapat dipicu, tetapi keberhasilan aktivitas penskalaan tidak dijamin. Anda dapat memeriksa status aktivitas penskalaan dengan menggunakan ScalingActivityId yang dikembalikan.

    • Jumlah instans ECS, instans kontainer elastis, atau instans terkelola dalam grup penskalaan dikurangi jumlah instans yang dihapus tidak boleh kurang dari jumlah minimum instans (MinSize) dalam grup penskalaan. Jika tidak, kesalahan akan dikembalikan.

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

ess:DetachInstances

update

*ScalingGroup

acs:ess:{#regionId}:{#accountId}:scalinggroup/{#ScalingGroupId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

ScalingGroupId

string

Yes

ID grup penskalaan.

asg-bp1igpak5ft1flyp****

DecreaseDesiredCapacity

boolean

No

Menentukan apakah akan mengubah jumlah instans yang diharapkan. Nilai valid:

  • true: Setelah instans ECS, instans kontainer elastis, atau instans terkelola dihapus dari grup penskalaan, jumlah instans yang diharapkan berkurang sesuai jumlah yang dihapus.

  • false: Setelah instans ECS, instans kontainer elastis, atau instans terkelola dihapus dari grup penskalaan, jumlah instans yang diharapkan tetap tidak berubah.

Nilai default: true.

true

DetachOption

string

No

Menentukan apakah akan berhenti menggunakan instans ECS atau instans kontainer elastis sebagai server backend dari instans penyeimbangan beban terkait dengan menghapusnya dari grup server default dan grup server virtual, serta apakah akan menghapus instans ECS atau instans kontainer elastis dari daftar putih akses instans ApsaraDB RDS terkait.

both: Menghapus instans ECS atau instans kontainer elastis dari grup server default dan grup layanan virtual instans penyeimbangan beban, dan menghapusnya dari daftar putih akses instans ApsaraDB RDS.

Catatan

Pengaturan untuk parameter ini tidak didukung saat instans terkelola dihapus dari grup penskalaan.

both

InstanceIds

array

Yes

ID instans ECS, instans kontainer elastis, atau instans terkelola yang ingin Anda hapus.

string

No

ID instans dari instans ECS, instans kontainer elastis, atau instans terkelola yang ingin Anda hapus.

Contoh:

  • ID instans dari instans ECS yang akan dihapus: i-bp109k5j3dum1ce6****.

  • ID instans dari instans kontainer elastis yang akan dihapus: eci-bp17gw49eu09yiwm****.

  • ID instans dari instans terkelola yang akan dihapus: mi-d23fsd******.

Catatan

Setiap permintaan hanya mendukung penghapusan satu jenis instans.

i-bp109k5j3dum1ce6****

LifecycleHook

boolean

No

Menentukan apakah akan memicu hook siklus hidup scale-in saat instans ECS atau instans kontainer elastis dihapus dari grup penskalaan. Nilai valid:

  • true: Hook siklus hidup dipicu.

  • false: Hook siklus hidup tidak dipicu.

Catatan

Parameter ini tidak didukung saat instans terkelola dihapus dari grup penskalaan.

Nilai default: false.

false

IgnoreInvalidInstance

boolean

No

Menentukan apakah akan mengabaikan instans yang tidak valid saat menghapus sekumpulan instans dari grup penskalaan. Nilai valid:

  • true: Instans yang tidak valid diabaikan. Jika terdapat instans yang tidak valid dan instans yang valid berhasil dihapus, status aktivitas penskalaan diatur ke Warning. Anda dapat melihat instans yang tidak valid di detail aktivitas penskalaan.

  • false: Instans yang tidak valid tidak diabaikan. Jika ada instans yang tidak valid dalam kumpulan tersebut, permintaan mengembalikan kesalahan.

Nilai default: false.

false

ClientToken

string

No

Token klien yang digunakan untuk memastikan idempotensi permintaan.

Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara permintaan yang berbeda. Token hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

123e4567-e89b-12d3-a456-42665544****

Elemen respons

Element

Type

Description

Example

object

ScalingActivityId

string

ID aktivitas penskalaan.

asa-bp1gbswjhjrw8tko****

RequestId

string

ID permintaan.

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

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code

Error code

Error message

Description

500 InternalError The request processing has failed due to some unknown error, exception or failure.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.