All Products
Search
Document Center

Auto Scaling:DetachInstances

Last Updated:Sep 10, 2026

Menghapus satu atau beberapa Instance ECS dari grup penskalaan.

Deskripsi operasi

Deskripsi operasi

  • Sebelum memanggil operasi ini, pastikan kondisi berikut terpenuhi:

    • Grup penskalaan berada dalam status Enabled.

    • Tidak ada aktivitas penskalaan yang sedang berlangsung di grup penskalaan.

      Catatan

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

  • Perhatikan hal-hal berikut:

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

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

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

    • Jumlah Instance ECS, instans kontainer elastis, atau instans terkelola di grup penskalaan dikurangi jumlah instans yang dihapus tidak boleh kurang dari jumlah instans minimum (MinSize) di grup penskalaan. Jika tidak, error 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

Tidak ada otorisasi untuk operasi ini. Jika Anda mengalami masalah saat menjalankan operasi ini, hubungi dukungan teknis.

Parameter permintaan

Parameter

Type

Required

Description

Example

ScalingGroupId

string

Yes

ID grup penskalaan.

asg-bp1igpak5ft1flyp****

DecreaseDesiredCapacity

boolean

No

Apakah akan mengubah jumlah instans yang diharapkan. Nilai valid:

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

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

Nilai default: true.

true

IgnoreInvalidInstance

boolean

No

Apakah akan mengabaikan instans tidak valid saat menghapus batch instans dari grup penskalaan. Nilai valid:

  • true: Instans tidak valid diabaikan saat batch instans dihapus dari grup penskalaan.

    Jika batch instans berisi instans tidak valid (misalnya, instans dengan status instans Pending) dan instans valid berhasil dihapus, status eksekusi aktivitas penskalaan ditampilkan sebagai Warning. Anda dapat melihat instans tidak valid di detail aktivitas penskalaan.

  • false: Instans tidak valid tidak diabaikan saat batch instans dihapus dari grup penskalaan.

    Jika batch instans berisi instans tidak valid (misalnya, instans dengan status instans Pending), error akan dikembalikan.

Nilai default: false.

false

DetachOption

string

No

Apakah akan menghentikan penggunaan Instance ECS atau instans kontainer elastis sebagai server backend dari instance SLB yang terkait (yaitu, menghapus Instance ECS atau instans kontainer elastis dari grup server default dan grup server virtual instance SLB), dan apakah akan menghapus Instance ECS atau instans kontainer elastis dari daftar putih akses instance ApsaraDB RDS yang terkait.

both: Menghapus Instance ECS atau instans kontainer elastis dari grup server default dan grup server virtual instance SLB, serta menghapus Instance ECS atau instans kontainer elastis dari daftar putih akses instance ApsaraDB RDS.

Catatan

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

both

InstanceId

array

Yes

ID Instance ECS, instans kontainer elastis, atau instans terkelola yang akan dihapus.

i-bp109k5j3dum1ce6****

string

No

ID Instance ECS, instans kontainer elastis, atau instans terkelola yang akan dihapus. Nilai valid N: 1 hingga 20.

Contoh:

  • ID Instance ECS yang akan dihapus adalah i-bp109k5j3dum1ce6****.

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

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

Catatan

Hanya satu tipe instans yang dapat dihapus dalam satu permintaan.

i-bp109k5j3dum1ce6****

LifecycleHook

boolean

No

Apakah akan memicu kait siklus hidup scale-in saat Instance ECS atau instans kontainer elastis dihapus dari grup penskalaan. Nilai valid:

  • true: Memicu kait siklus hidup.

  • false: Tidak memicu kait siklus hidup.

Catatan

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

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 lebih lanjut, 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.