All Products
Search
Document Center

:StartInstance

Last Updated:May 22, 2026

Menjalankan instans Elastic Compute Service (ECS). Setelah operasi dipanggil, instans memasuki status Starting.

Catatan penggunaan

Saat memanggil operasi ini, perhatikan hal-hal berikut:

  • Instans ECS yang ingin dijalankan harus berada dalam status Stopped (Stopped).
  • Jika OperationLocks dalam respons berisi "LockReason" : "security" saat Anda mengkueri informasi instans tersebut, instans tersebut terkunci karena alasan keamanan dan tidak dapat dijalankan.

Debugging

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

Parameter permintaan

ParameterTipeWajibContohDeskripsi
ActionStringYaStartInstance

Operasi yang ingin Anda lakukan. Tetapkan nilainya ke StartInstance.

InstanceIdStringYai-bp67acfmxazb4p****

ID instans yang ingin Anda jalankan.

InitLocalDiskBooleanTidaktrue

Menentukan apakah akan memulihkan instans ke kondisi awal yang sehat. Parameter ini berlaku untuk instans yang dilengkapi disk lokal, seperti instans d1, i1, dan i2. Jika disk lokal pada instans d1, i1, atau i2 mengalami kegagalan, Anda dapat menggunakan parameter ini untuk menentukan apakah akan memulihkan instans ke kondisi awal yang sehat saat dijalankan. Nilai yang valid:

  • true: memulihkan instans ke kondisi awal yang sehat saat dijalankan. Setelah dipulihkan, data yang tersimpan di disk lokal instans akan hilang.
  • false: tidak melakukan operasi dan mempertahankan instans dalam kondisi saat ini.

Nilai default: false.

DryRunBooleanTidaktrue

Menentukan apakah akan menjalankan dry run. Nilai yang valid:

  • true: menjalankan dry run. Sistem memeriksa Pasangan Kunci Akses Anda, izin Pengguna RAM, dan parameter yang diperlukan. Jika permintaan gagal dalam dry run, pesan kesalahan akan dikembalikan. Jika permintaan lolos dry run, kode kesalahan DryRunOperation akan dikembalikan.
  • false: menjalankan dry run dan mengirim permintaan. Jika permintaan lolos dry run, kode status HTTP 2XX dikembalikan dan operasi dilakukan.

Nilai default: false.

Parameter respons

ParameterTipeContohDeskripsi
RequestIdString473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

ID permintaan.

Contoh

Contoh permintaan

http(s)://ecs.aliyuncs.com/?Action=StartInstance
&InstanceId=i-bp67acfmxazb4p****
&InitLocalDisk=true
&Common request parameters

Contoh respons sukses

XML format

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

<StartInstanceResponse>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E</RequestId>
</StartInstanceResponse>

JSON format

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

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

Kode kesalahan

Kode status HTTPKode kesalahanPesan kesalahanDeskripsi
403InvalidParameter.KMSKeyId.NotFoundThe specified KMSKeyId does not exist.Pesan kesalahan yang dikembalikan karena parameter KMSKeyId yang ditentukan tidak ada.
403IncorrectInstanceStatusThe current status of the resource does not support this operation.Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat resource berada dalam status saat ini.
403InstanceLockedForSecurityThe specified operation is denied as your instance is locked for security reasons.Pesan kesalahan yang dikembalikan karena instans terkunci karena alasan keamanan.
403InsufficientBalanceYour account does not have enough balance.Pesan kesalahan yang dikembalikan karena saldo akun Anda tidak mencukupi. Tambahkan dana ke akun Anda dan coba lagi.
403DiskErrorIncorrectDiskStatus.Pesan kesalahan yang dikembalikan karena status disk yang ditentukan tidak valid.
403InstanceExpiredThe postPaid instance has been expired. Please ensure your account have enough balance.Pesan kesalahan yang dikembalikan karena instans pay-as-you-go telah kedaluwarsa. Saat instans pay-as-you-go dihentikan karena Pembayaran tertunda, instans memasuki status Expired. Pastikan saldo akun Anda mencukupi.
403InstanceNotReadyThe specified instance is not ready for use.Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat resource berada dalam status saat ini. Coba lagi nanti.
403DiskInArrearsThe specified operation is denied as your disk has expired.Pesan kesalahan yang dikembalikan karena disk telah kedaluwarsa akibat Pembayaran tertunda.
403OperationDenied.NoStockThe requested resource is sold out in the specified zone; try other types of resources or other regions and zones.Pesan kesalahan yang dikembalikan karena resource yang diminta tidak tersedia di zona yang ditentukan. Coba tipe instans atau zona lain. Anda dapat memanggil operasi DescribeZones untuk mengkueri resource yang tersedia di zona.
403OperationDenied.SpotPriceLowerThanPublicPriceThe spot instance price is lower than public price.Pesan kesalahan yang dikembalikan karena harga maksimum per jam yang ditentukan pengguna untuk instans preemptible lebih rendah daripada harga pasar saat ini.
403IncorrectInstanceStatus%sPesan kesalahan yang dikembalikan karena operasi tidak didukung saat instans berada dalam status saat ini.
403InvalidParameter.KMSKeyId.CMKNotEnabledThe CMK needs to be enabled.Pesan kesalahan yang dikembalikan karena kunci master pelanggan (CMK) tidak diaktifkan saat ID kunci KMS ditentukan untuk disk. Anda dapat memanggil operasi DescribeKey dari KMS untuk mengkueri informasi CMK yang ditentukan.
403InvalidParameter.KMSKeyId.KMSUnauthorizedECS service have no right to access your KMS.Pesan kesalahan yang dikembalikan karena ECS tidak memiliki otorisasi untuk mengakses resource KMS Anda.
403QuotaExceed.ElasticQuotaNo additional quota is available for the specified ECS instance type.Pesan kesalahan yang dikembalikan karena jumlah maksimum instans dari tipe instans yang ditentukan di wilayah tersebut telah tercapai. Anda dapat mencoba wilayah atau tipe instans lain, atau mengurangi jumlah instans yang ingin Anda beli. Alternatifnya, Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.
403QuotaExceed.ElasticQuotaThe number of the specified ECS instances has exceeded the quota of the specified instance type.Pesan kesalahan yang dikembalikan karena jumlah maksimum instans dari tipe instans yang ditentukan di wilayah tersebut telah tercapai. Anda dapat mencoba wilayah atau tipe instans lain, atau mengurangi jumlah instans yang ingin Anda beli. Alternatifnya, Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.
403QuotaExceed.ElasticQuotaThe number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.Pesan kesalahan yang dikembalikan karena jumlah maksimum vCPU untuk semua tipe instans telah tercapai di zona tersebut. Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.
403QuotaExceed.ElasticQuotaThe number of the specified ECS instances has exceeded the quota of the specified instance type, or the number of vCPUs assigned to the ECS instances has exceeded the quota in the zone.Pesan kesalahan yang dikembalikan karena jumlah maksimum instans dari tipe instans yang ditentukan di wilayah tersebut telah tercapai atau karena jumlah maksimum vCPU untuk semua tipe instans telah tercapai. Anda dapat membuka Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.
403OperationDenied.HostRepairingThe specified operation is denied as the host of ECS instance is being repaired.Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat mesin fisik yang menjadi host instans ECS sedang dalam perbaikan.
404InvalidInstanceId.NotFoundThe specified InstanceId does not exist.Pesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak ada.
500InternalErrorThe request processing has failed due to some unknown error.Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.
500InternalErrorThe request processing has failed due to some unknown error, exception or failure.Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.
503ServiceUnavailableThe request has failed due to a temporary failure of the server.Pesan kesalahan yang dikembalikan karena permintaan gagal akibat kegagalan sementara pada server backend.

Untuk daftar kode kesalahan, lihat Kode kesalahan layanan.