All Products
Search

This Product

    :StopInstance

    Document Center

    :StopInstance

    Last Updated:May 22, 2026

    Menghentikan instans Elastic Compute Service (ECS) yang berstatus Running. Setelah operasi dipanggil, status instans berubah menjadi Stopping, lalu Stopped.

    Description

    • Jika Anda memanggil operasi DescribeInstances untuk mengkueri detail instans dan OperationLocks dalam respons berisi "LockReason": "security", instans tersebut dikunci karena alasan keamanan dan tidak dapat dihentikan. Untuk informasi selengkapnya, lihat Perilaku API saat instans dikunci karena alasan keamanan.

    • Jika mode hemat diaktifkan, Anda dapat mengatur StoppedMode ke KeepCharging untuk beralih ke mode standar. Dalam mode standar, meskipun instans dihentikan, Anda tetap dikenai biaya dan sumber daya tipe instans serta Alamat IP publiknya dipertahankan.

    Debugging

    OpenAPI Explorer secara otomatis menghitung nilai signature. Untuk kemudahan Anda, kami menyarankan agar Anda memanggil operasi ini di OpenAPI Explorer. OpenAPI Explorer secara dinamis menghasilkan contoh kode operasi untuk berbagai SDK.

    Request parameters

    Parameter

    Type

    Required

    Example

    Description

    Action

    String

    Yes

    StopInstance

    Operasi yang ingin Anda lakukan. Tetapkan nilainya ke StopInstance.

    InstanceId

    String

    Yes

    i-bp67acfmxazb4ph****

    ID instans.

    ConfirmStop

    Boolean

    No

    true

    Parameter ini akan dihapus di masa mendatang dan hanya dipertahankan untuk menjaga kompatibilitas. Kami menyarankan agar Anda mengabaikan parameter ini.

    ForceStop

    Boolean

    No

    false

    Menentukan apakah instans akan dihentikan secara paksa. Nilai yang valid:

    • true: menghentikan instans secara paksa.

    • false: menghentikan instans secara normal.

    Nilai default: false.

    StoppedMode

    String

    No

    KeepCharging

    Mode penghentian untuk instans pay-as-you-go. Nilai yang valid:

    • StopCharging: mode hemat. Untuk informasi tentang cara kerja StopCharging, lihat bagian "Prasyarat" dalam mode hemat.

    • KeepCharging: mode standar. Setelah instans dihentikan dalam mode standar, Anda tetap dikenai biaya.

    Nilai default: Jika prasyarat untuk mengaktifkan mode hemat terpenuhi dan Anda telah mengaktifkan mode ini di Konsol ECS, nilai default-nya adalah StopCharging. Untuk informasi selengkapnya, lihat bagian "Aktifkan mode hemat" dalam mode hemat. Jika tidak, nilai default-nya adalah KeepCharging.

    DryRun

    Boolean

    No

    true

    Menentukan apakah permintaan akan diperiksa validitasnya tanpa benar-benar dieksekusi. Nilai default: false. Nilai yang valid:

    • true: Validitas permintaan diperiksa, tetapi permintaan tidak dieksekusi. Item pemeriksaan mencakup parameter yang diperlukan, batasan layanan, ketersediaan resource ECS, dan format permintaan. Jika pemeriksaan gagal, kode kesalahan yang sesuai dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation dikembalikan.

    • false: Validitas permintaan diperiksa, dan permintaan dieksekusi jika pemeriksaan berhasil.

    Nilai default: false.

    Hibernate

    Boolean

    No

    hide

    Catatan

    Parameter ini saat ini berada dalam pratinjau undangan dan belum tersedia untuk pengguna umum.

    Response parameters

    Parameter

    Type

    Example

    Description

    RequestId

    String

    1C488B66-B819-4D14-8711-C4EAAA13AC01

    ID permintaan.

    Examples

    Contoh permintaan

    https://ecs.aliyuncs.com/?Action=StopInstance
&InstanceId=i-bp67acfmxazb4ph****
&ForceStop=false
&StoppedMode=KeepCharging
&<Common request parameters>

    Contoh respons sukses

    XML format

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

<StopInstanceResponse>
    <RequestId>1C488B66-B819-4D14-8711-C4EAAA13AC01</RequestId>
</StopInstanceResponse>

    JSON format

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

{
  "RequestId" : "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

    Error codes

    Kode status HTTP

    Kode kesalahan

    Pesan kesalahan

    Description

    403

    IncorrectInstanceStatus

    Status resource saat ini tidak mendukung operasi ini.

    Pesan kesalahan dikembalikan karena operasi tidak didukung saat resource berada dalam status saat ini.

    403

    InstanceLockedForSecurity

    Operasi yang ditentukan ditolak karena instans Anda dikunci karena alasan keamanan.

    Pesan kesalahan dikembalikan karena operasi tidak didukung saat instans dikunci karena alasan keamanan.

    403

    DiskError

    IncorrectDiskStatus

    Pesan kesalahan dikembalikan karena status disk yang ditentukan tidak valid.

    403

    InstanceType.ParameterMismatch

    Parameter input ConfirmStop harus bernilai true ketika instans memiliki localstorage.

    Pesan kesalahan dikembalikan karena parameter ConfirmStop diatur ke false untuk instans yang menggunakan local storage.

    403

    InstanceExpiredOrInArrears

    Operasi yang ditentukan ditolak karena instans prepay Anda telah kedaluwarsa (mode prepay) atau menunggak (mode afterpay).

    Pesan kesalahan dikembalikan karena instans langganan telah kedaluwarsa. Perpanjang instans tersebut dan coba lagi nanti.

    403

    InvalidInstanceId.NotSupport

    Instans jaringan klasik tidak mendukung operasi ini.

    Pesan kesalahan dikembalikan karena operasi tidak didukung oleh instans yang berada di jaringan klasik.

    403

    InvalidInstanceId.NotSupport

    Instans prepay tidak mendukung operasi ini.

    Pesan kesalahan dikembalikan karena operasi tidak didukung oleh instans langganan.

    403

    InvalidInstanceId.NotSupport

    Instans disk lokal tidak mendukung operasi ini.

    Pesan kesalahan dikembalikan karena operasi tidak didukung oleh instans yang menggunakan disk lokal.

    403

    InvalidInstanceId.NotSupport

    Instans Spot tidak mendukung operasi ini.

    Pesan kesalahan dikembalikan karena operasi tidak didukung oleh instans preemptible.

    403

    IncorrectInstanceStatus

    %s

    Pesan kesalahan dikembalikan karena operasi tidak didukung saat instans berada dalam status saat ini.

    403

    InvalidParameter.KMSKeyId.CMKNotEnabled

    CMK perlu diaktifkan.

    Pesan kesalahan dikembalikan karena customer master key (CMK) yang ditentukan oleh parameter KMSKeyId tidak diaktifkan. Anda dapat memanggil operasi DescribeKey dari KMS untuk mengkueri informasi tentang CMK yang ditentukan.

    403

    InvalidParameter.KMSKeyId.KMSUnauthorized

    Layanan ECS tidak memiliki hak akses ke KMS Anda.

    Pesan kesalahan dikembalikan karena ECS tidak memiliki otorisasi untuk mengakses resource KMS Anda.

    404

    InvalidInstanceId.NotFound

    InstanceId yang ditentukan tidak ada.

    Pesan kesalahan dikembalikan karena parameter InstanceId yang ditentukan tidak valid.

    500

    InternalError

    Pemrosesan permintaan gagal karena kesalahan yang tidak diketahui.

    Pesan kesalahan dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.

    500

    InternalError

    Pemrosesan permintaan gagal karena kesalahan, pengecualian, atau kegagalan yang tidak diketahui.

    Pesan kesalahan dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.

    Untuk daftar kode kesalahan, kunjungi API Error Center.