All Products
Search

This Product

    Auto Scaling:RemoveInstances

    Document Center

    Auto Scaling:RemoveInstances

    Last Updated:Jun 12, 2026

    Jika grup penskalaan berada dalam status aktif dan tidak ada aktivitas penskalaan yang sedang dijalankan di dalam grup penskalaan, Anda dapat memanggil operasi RemoveInstances untuk menghapus satu atau beberapa instans yang tidak lagi diperlukan dari grup penskalaan.

    Deskripsi operasi

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

      • Grup penskalaan berada dalam status aktif (Active).

      • Tidak ada aktivitas penskalaan yang sedang dijalankan di dalam grup penskalaan.

    Catatan

    Jika tidak ada aktivitas penskalaan yang sedang dijalankan di dalam grup penskalaan, operasi ini dapat melewati waktu pendinginan (DefaultCooldown) dan langsung dijalankan.

    • Jika Instans ECS dibuat secara otomatis oleh Penyesuaian Skala Otomatis, atau ditambahkan secara manual tetapi dikelola oleh grup penskalaan, Instans ECS akan memasuki mode ekonomis atau dirilis saat dihapus dari grup penskalaan.

    • Jika Instans ECS ditambahkan secara manual dan tidak dikelola oleh grup penskalaan, Instans ECS tidak akan dihentikan atau dirilis saat dihapus dari grup penskalaan.

    • Jika jumlah instans saat ini (TotalCapacity) di dalam grup penskalaan dikurangi jumlah instans yang ditentukan dalam operasi ini kurang dari jumlah instans minimum (MinSize) di dalam grup penskalaan, pemanggilan akan gagal.

    Tanggapan yang berhasil hanya menunjukkan bahwa Penyesuaian Skala Otomatis telah menerima permintaan dan aktivitas penskalaan dapat dijalankan. Hal ini tidak berarti bahwa aktivitas penskalaan akan berhasil dijalankan. Anda dapat memeriksa status eksekusi aktivitas penskalaan berdasarkan ScalingActivityId yang 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-bp18p2yfxow2dloq****
    RemovePolicy

    string

    No

    Aksi yang akan dilakukan pada Instans ECS yang dihapus. Nilai valid:

    • recycle: Instans ECS memasuki mode ekonomis.

      Catatan

      Nilai ini hanya berlaku jika ScalingPolicy diatur ke recycle.

    • release: Instans ECS dirilis.

    Parameter ScalingPolicy dari CreateScalingGroup menentukan mode reklamasi grup penskalaan, tetapi aksi spesifik yang dilakukan saat Instans ECS dihapus ditentukan oleh parameter RemovePolicy dari RemoveInstances. Contoh:

    • ScalingPolicy diatur ke recycle dan RemovePolicy diatur ke recycle: Instans ECS memasuki mode ekonomis.

    • ScalingPolicy diatur ke recycle dan RemovePolicy diatur ke release: Instans ECS dirilis.

    • ScalingPolicy diatur ke release dan RemovePolicy diatur ke recycle: Instans ECS dirilis.

    • ScalingPolicy diatur ke release dan RemovePolicy diatur ke release: Instans ECS dirilis.

    Nilai default: release.

    release
    DecreaseDesiredCapacity

    boolean

    No

    Apakah akan memodifikasi jumlah instans yang diharapkan. Nilai valid:

    • true: Setelah Instans ECS dihapus dari grup penskalaan, jumlah instans yang diharapkan akan dikurangi sesuai jumlah yang dihapus.

    • false: Setelah Instans ECS 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 terdapat instans tidak valid dan instans valid berhasil dihapus, status 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 terdapat instans tidak valid dalam Batch, permintaan akan mengembalikan error.

    Nilai default: false.

    false
    InstanceIds

    array

    Yes

    ID Instans ECS yang akan dihapus.

    string

    No

    ID Instans ECS yang akan dihapus.

    i-28wt4****
    RegionId

    string

    No

    ID wilayah grup penskalaan.

    cn-qingdao
    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 panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.

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

    integer

    No

    Periode waktu tunggu hingga Instans ECS berhenti selama proses scale-in. Unit: detik. Nilai valid: 30 hingga 240.

    Catatan

    • Nilai default parameter ini diwarisi dari grup penskalaan. Anda juga dapat menetapkan nilai baru saat memanggil RemoveInstances.

    • Parameter ini hanya berlaku selama proses scale-in ketika RemovePolicy diatur ke release.

    • Jika parameter ini ditentukan, sistem akan menunggu hingga periode StopInstanceTimeout agar Instans ECS berhenti. Setelah waktu tunggu berakhir, proses scale-in akan berlanjut terlepas dari apakah Instans ECS telah berhenti atau belum.

    • Jika parameter ini tidak ditentukan, sistem akan menunggu hingga Instans ECS berhenti sebelum melanjutkan proses scale-in. Jika Instans ECS gagal berhenti, proses scale-in akan di-rollback dan scale-in gagal.

    60
    LifecycleHookContext

    object

    No

    Informasi konteks hook siklus hidup.

    DisableLifecycleHook

    boolean

    No

    Apakah akan menonaktifkan semua hook siklus hidup untuk aktivitas penskalaan. Nilai valid:

    • true: Dinonaktifkan.

    • false: Tidak dinonaktifkan.

    false
    IgnoredLifecycleHookIds

    array

    No

    ID hook siklus hidup yang akan dinonaktifkan untuk aktivitas penskalaan.

    string

    No

    ID hook siklus hidup yang akan dinonaktifkan untuk aktivitas penskalaan.

    ash-bp14zolna43z266bq***
    LifecycleHookResult

    string

    No

    Elemen respons

    Element

    Type

    Description

    Example

    object

    ScalingActivityId

    string

    ID aktivitas penskalaan.

    asa-bp175o6f6ego3r2j****
    RequestId

    string

    ID permintaan.

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

    array<object>

    object

    InstanceId

    string

    Code

    string

    Message

    string

    Contoh

    Respons sukses

    JSONformat

    {
  "ScalingActivityId": "asa-bp175o6f6ego3r2j****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "IgnoredInstances": [
    {
      "InstanceId": "",
      "Code": "",
      "Message": ""
    }
  ]
}

    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.