All Products
Search
Document Center

Elastic Compute Service:DeleteInstance

Last Updated:Jun 18, 2026

Menghapus atau merilis Instans ECS tertentu.

Deskripsi operasi

Peringatan Setelah instans dirilis, semua sumber daya fisik yang digunakan oleh instans akan diambil kembali. Semua data terkait akan hilang secara permanen dan tidak dapat dipulihkan.
.
  • Snapshot manual cloud disk dipertahankan dan tetap dikenakan biaya. Anda dapat menghapusnya dengan memanggil DeleteSnapshot.

  • Apakah cloud disk yang terpasang pada instans dan snapshot otomatis dirilis bergantung pada pengaturan parameter yang ditentukan saat pembuatannya. Sebelum merilis instans, Anda dapat memanggil DescribeDisks dan ModifyDiskAttribute untuk mengkueri dan mengubah pengaturan parameter terkait:
    • Jika DeleteWithInstance=false, cloud disk dikonversi menjadi cloud disk pay-as-you-go dan dipertahankan. Jika tidak, cloud disk dirilis bersama instans.

    • Jika DeleteAutoSnapshot=false, snapshot otomatis dipertahankan. Jika tidak, snapshot tersebut dirilis bersama instans.

  • Elastic IP address (EIP) tidak dirilis bersama instans. Anda dapat memanggil ReleaseEipAddress untuk merilisnya.
    Penting Untuk instans yang terkunci keamanan, meskipun parameter DeleteWithInstance pada cloud disk diatur ke false, atribut ini akan diabaikan dan cloud disk akan dirilis bersama instans.
    .

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

ecs:DeleteInstance

delete

*Instance

acs:ecs:{#regionId}:{#accountId}:instance/{#instanceId}

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

InstanceId

string

Yes

ID instans

i-bp1g6zv0ce8oghu7****

Force

boolean

No

Apakah akan merilis secara paksa instans yang sedang berjalan (Running).

  • true: Merilis secara paksa instans yang sedang berjalan (Running).

  • false: Merilis instans dengan cara normal. Instans harus berada dalam status Stopped (Stopped).

Nilai default: false.

Peringatan Perilisan paksa setara dengan mematikan daya. Data sementara di memori dan penyimpanan instans akan dihapus dan tidak dapat dipulihkan.
.

false

ForceStop

boolean

No

Apakah akan menggunakan kebijakan shutdown paksa saat merilis instans yang sedang berjalan (Running). Parameter ini hanya berlaku ketika Force=true. Nilai valid:

  • true: Mematikan dan merilis instans secara paksa. Hal ini setara dengan operasi pemadaman daya pada umumnya. Instans langsung memasuki proses pelepasan sumber daya.
    Peringatan Perilisan paksa setara dengan mematikan daya. Data sementara di memori dan penyimpanan instans akan dihapus dan tidak dapat dipulihkan.
  • false: Sebelum instans dirilis, sistem akan mengutamakan proses shutdown standar. Mode ini menyebabkan perilisan instans memakan waktu beberapa menit. Anda dapat mengonfigurasi tindakan pengurasan layanan selama shutdown sistem operasi untuk mengurangi kebisingan pada sistem bisnis Anda.

Nilai default: true.

true

TerminateSubscription

boolean

No

Apakah akan merilis Instansi langganan yang telah kedaluwarsa.

  • true: Merilis instans.

  • false: Tidak merilis instans.

Nilai default: false.

false

DryRun

boolean

No

Apakah akan menjalankan dry run saja. Nilai valid:

  • true: Mengirim permintaan pemeriksaan tanpa merilis instans. Sistem memeriksa apakah parameter yang diperlukan telah ditentukan, format permintaan valid, persyaratan bisnis terpenuhi, dan sumber daya ECS mencukupi. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation akan dikembalikan.

  • false (default): Mengirim permintaan normal. Setelah permintaan lulus pemeriksaan, instans akan langsung dihapus.

false

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

Contoh

Respons sukses

JSONformat

{
  "RequestId": "473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E"
}

Respons error

JSONformat

{
    "RequestId": "928E2273-5715-46B9-A730-238DC996A533"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 DependencyViolation.SLBConfiguring Specified operation is denied as your instance is using by another product.
400 DependencyViolation.RouteEntry Specified instance is used by route entry. The current Virtual Private Cloud (VPC) still contains custom route rules that have not been deleted, and the deletion failed.
400 InvalidParameter The input parameter InstanceId is invalid. The specified InstanceId is invalid. Check whether the InstanceId is correct and exists.
500 InternalError The request processing has failed due to some unknown error.
403 IncorrectInstanceStatus The current status of the resource does not support this operation.
403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. The instance is locked for security reasons.
403 ChargeTypeViolation The operation is not permitted due to charge type of the instance.
403 IncorrectInstanceStatus.Initializing The specified instance status does not support this operation. The instance is being initialized and cannot be released at this time. Try again later.
403 InvalidOperation.DeletionProtection %s The operation is invalid. Disable release protection for the instance first.
403 InvalidOperation.EniLinked %s The current elastic network interface (ENI) of the instance is associated with other ENIs, which causes the operation to be invalid. You must disassociate them before they can be detached from the instance.
403 OperationDenied.SystemInstanceNotSupport The system instance does not support the %s operation because %s.
404 InvalidInstanceId.NotFound The specified InstanceId does not exist. The specified instance ID is invalid.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.