All Products
Search

This Product

    Auto Scaling:RemoveInstances

    Document Center

    Auto Scaling:RemoveInstances

    Last Updated:Sep 10, 2026

    Menghapus satu atau beberapa Instans ECS dari grup penskalaan.

    Deskripsi operasi

    Deskripsi operasi

    • Sebelum memanggil operasi ini, pastikan kondisi berikut terpenuhi:

      • Grup penskalaan berada dalam status Active.

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

    Jika tidak ada aktivitas penskalaan yang sedang dieksekusi di grup penskalaan, operasi ini dapat melewati periode cooldown (DefaultCooldown) dan dieksekusi segera.

    • Jika Instans ECS dibuat secara otomatis oleh Penyesuaian Skala Otomatis, atau ditambahkan secara manual tetapi telah dipercayakan ke grup penskalaan, Instans ECS akan masuk ke mode Ekonomis atau dirilis saat dihapus dari grup penskalaan.

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

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

    Tanggapan yang berhasil hanya menunjukkan bahwa Penyesuaian Skala Otomatis menerima permintaan. Aktivitas penskalaan dapat dieksekusi, tetapi tanggapan yang berhasil tidak menjamin bahwa aktivitas penskalaan akan berhasil. 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 diambil pada Instans ECS yang dihapus. Nilai valid:

    • recycle: Instans ECS masuk ke mode Ekonomis.

      Catatan

      Nilai ini hanya berlaku jika ScalingPolicy diatur ke recycle.

    • release: Instans ECS dirilis.

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

      • Jika ScalingPolicy diatur ke recycle dan RemovePolicy diatur ke recycle, Instans ECS masuk ke mode Ekonomis.

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

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

      • Jika 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 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 Anda 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 Pending), Instans valid berhasil dihapus, dan 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, error akan dikembalikan.

    Nilai default: false.

    false
    InstanceId

    array

    Yes

    ID Instans ECS yang akan dihapus.

    i-28wt4****

    string

    No

    ID Instans ECS yang akan dihapus. Nilai valid N: 1 hingga 20.

    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 timeout untuk menunggu Instans ECS dihentikan selama proses scale-in. Unit: seconds. Nilai valid: 30 hingga 240.

    Catatan

    • Secara default, nilai parameter ini diwarisi dari grup penskalaan. Anda juga dapat mengatur ulang nilai ini saat memanggil RemoveInstances.

    • Parameter ini hanya berlaku pada proses scale-in di mana RemovePolicy diatur ke release.

    • Jika parameter ini ditentukan, sistem menunggu hingga periode StopInstanceTimeout agar Instans berhenti. Setelah periode timeout berlalu, proses scale-in berlanjut terlepas dari apakah Instans telah berhenti.

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

    60
    LifecycleHookContext

    object

    No

    Informasi konteks kait siklus hidup.

    DisableLifecycleHook

    boolean

    No

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

    • true: Dinonaktifkan.

    • false: Tidak dinonaktifkan.

    false
    IgnoredLifecycleHookIds

    array

    No

    Daftar ID kait siklus hidup yang akan dinonaktifkan untuk aktivitas penskalaan.

    string

    No

    Daftar ID kait 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

    object

    IgnoredInstance

    array<object>

    object

    InstanceId

    string

    Code

    string

    Message

    string

    Contoh

    Respons sukses

    JSONformat

    {
  "ScalingActivityId": "asa-bp175o6f6ego3r2j****",
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****",
  "IgnoredInstances": {
    "IgnoredInstance": [
      {
        "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.