All Products
Search
Document Center

Elastic Compute Service:DeleteInstances

Last Updated:Jun 18, 2026

Menghapus atau merilis beberapa Instans pay-as-you-go atau Instansi langganan yang telah kedaluwarsa secara Batch. Anda dapat menggunakan parameter untuk menentukan apakah akan merilis atau mengonversi cloud disk menjadi disk pay-as-you-go dan mempertahankannya.

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 memanggil DeleteSnapshot untuk menghapusnya.

  • Apakah cloud disk dan snapshot Otomatis yang terpasang pada Instans dirilis atau tidak 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 akan dikonversi menjadi cloud disk pay-as-you-go dan dipertahankan. Jika tidak, cloud disk akan dirilis bersama Instans.

    • Jika DeleteAutoSnapshot=false, snapshot Otomatis akan dipertahankan. Jika tidak, snapshot Otomatis akan 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:DeleteInstances

delete

*Instance

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

None None

Parameter permintaan

Parameter

Type

Required

Description

Example

DryRun

boolean

No

Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual.

  • true: Mengirim permintaan pemeriksaan tanpa mengkueri status sumber daya. Item pemeriksaan mencakup apakah Pasangan Kunci Akses Anda valid, apakah otorisasi Pengguna RAM diberikan, dan apakah parameter yang diperlukan telah ditentukan. Jika pemeriksaan gagal, kode kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DRYRUN.SUCCESS akan dikembalikan.

  • false: Mengirim permintaan normal. Setelah pemeriksaan berhasil, kode status HTTP 2xx akan dikembalikan dan status sumber daya akan dikueri secara langsung.

Nilai default: false.

false

Force

boolean

No

Apakah akan merilis Instans secara paksa yang berada dalam status Running (Running).

  • true: Merilis Instance ECS secara paksa yang berada dalam status Running (Running).

  • false: Merilis Instance ECS hanya ketika berada dalam status Stopped (Stopped).

Nilai default: false.

Peringatan Pelepasan paksa setara dengan mematikan Instance ECS. Semua data dalam memori dan data sementara di penyimpanan akan dihapus dan tidak dapat dipulihkan.
.

false

ForceStop

boolean

No

Apakah akan mematikan Instans secara paksa sebelum pelepasan ketika Instans berada dalam status Running (Running). Parameter ini hanya berlaku ketika Force=true. Nilai valid:

  • true: Mematikan dan merilis Instans secara paksa. Hal ini setara dengan operasi mematikan daya. Instans langsung memasuki proses pelepasan sumber daya.
    Peringatan Pelepasan paksa setara dengan mematikan Instans. Semua data dalam memori dan data sementara di penyimpanan akan dihapus dan tidak dapat dipulihkan.
  • false: Melakukan shutdown standar sebelum merilis Instans. Mode ini menyebabkan proses pelepasan 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

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. Nilai ClientToken hanya dapat berisi karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.

123e4567-e89b-12d3-a456-426655440000

RegionId

string

Yes

ID wilayah instans. Anda dapat memanggil DescribeRegions untuk mengkueri daftar wilayah terbaru.

cn-hangzhou

InstanceId

array

Yes

Array ID instans. Panjang array: 1 hingga 100.

i-bp1g6zv0ce8oghu7****

string

No

ID instans

i-bp1g6zv0ce8oghu7****

Elemen respons

Element

Type

Description

Example

object

RequestId

string

ID permintaan.

7B7813C6-57BF-41XX-B12B-F172F65A6046

Contoh

Respons sukses

JSONformat

{
  "RequestId": "7B7813C6-57BF-41XX-B12B-F172F65A6046"
}

Kode kesalahan

HTTP status code

Error code

Error message

Description

400 InvalidParameter.CrossRegionNotSupport Instances of multiple regions not support.
400 DRYRUN.SUCCESS This request is a dryrun request with successful result. 您设置了预检此次请求,并且检查通过。
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. 当前专有网络 VPC 还存在未删除的自定义路由规则,删除失败。
500 InvalidParameter Invalid parameters. 参数无效,可能由于参数格式错误或缺少必填参数所导致
500 InternalError The request processing has failed due to some unknown error.
403 InvalidParameter.TooManyInstanceIds Instance ids cannot be more than 100. InstanceIds列表长度超过100。
403 InvalidInstanceIds.ValueNotSupported The specified instanceIds is not valid.
403 InvalidOperation.DeletionProtection The operation is not allowed due to deletion protection. 实例开启了释放保护,因此不能进行此操作
403 ChargeTypeViolation %s 付费类型冲突,该付费类型的资源不支持此操作。
403 IncorrectInstanceStatus.Initializing %s 指定的实例状态不支持此操作。
403 InvalidOperation.EniLinked %s 实例的当前弹性网卡关联了其他弹性网卡,导致操作无效。需要解除关联后才能从实例分离。
403 IncorrectInstanceStatus %s 当前实例的状态不支持此操作。
403 InstanceLockedForSecurity The specified operation is denied as your instance is locked for security reasons. 实例被安全锁定。
403 OperationDenied.SystemInstanceNotSupport The system instance does not support the %s operation because %s.
404 InvalidInstanceIds.NotFound The specified InstanceIds does not exist. 指定的 InstanceId 不存在。请检查 InstanceId 参数值是否正确。您可以调用 DescribeInstances 查询指定实例的状态。
404 InvalidInstanceId.NotFound %s

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.