StartInstance - Elastic Compute Service - Alibaba Cloud Documentation Center

Menjalankan Instans ECS. Anda dapat menjalankan instans dengan menentukan ID instans dan secara opsional menyetel parameter seperti InitLocalDisk.

Deskripsi operasi

Ini adalah operasi asinkron. Instans tidak langsung berjalan setelah panggilan berhasil. Instans pertama kali memasuki status Starting. Panggil DescribeInstanceStatus untuk mengkueri status instans. Ketika status yang dikembalikan adalah Running, instans telah berjalan.

Sebelum Anda memulai

Instans yang terkunci karena alasan keamanan tidak dapat dijalankan dengan memanggil operasi ini. Untuk informasi selengkapnya, lihat Situs Tiongkok (Dampak kunci keamanan sumber daya pada panggilan API).
Instans ECS harus berada dalam status Stopped (Stopped).
Instans dalam mode hemat mungkin gagal berjalan karena sumber daya tidak mencukupi.

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:StartInstance

update

*Instance.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans yang ingin Anda jalankan.	i-bp67acfmxazb4p****
InitLocalDisk	boolean	No	Apakah akan memulihkan instans ke status kesehatan awalnya ketika local disk mengalami kegagalan. Parameter ini berlaku untuk instans yang menggunakan local disk, seperti instans dalam keluarga instans d1, i1, atau i2. Nilai valid: true: Memulihkan instans ke status kesehatan awalnya. Peringatan Semua data yang tersimpan di local disk instans akan hilang. false: Tidak melakukan aksi apa pun dan mempertahankan status saat ini. Nilai default: false.	true
DryRun	boolean	No	Apakah akan menjalankan dry run saja, tanpa menjalankan permintaan aktual. Nilai valid: true: Hanya menjalankan dry run. Instans tidak dijalankan. Sistem memeriksa apakah parameter permintaan valid, apakah pengguna Resource Access Management (RAM) memiliki otorisasi yang diperlukan, dan apakah parameter yang diperlukan telah ditentukan. Jika pemeriksaan gagal, kode kesalahan yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan DryRunOperation akan dikembalikan. false: Mengirim permintaan normal. Jika pemeriksaan berhasil, kode status HTTP 2XX akan dikembalikan dan instans dijalankan. Nilai default: false.	true

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"
}

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	LackResource	There's no enough resource on the specified capacity reservation.
400	InvalidDedicatedHost.NotEnoughResource	The specified dedicated host has not enough resource due to host affinity.
400	InvalidInstance.NotFoundSystemDisk	The specified instance does not have system disk.
400	Invalid.PrivatePoolOptions.NoStock	The PrivatePool has been used up.	Kapasitas private pool yang ditentukan (jaminan elastisitas atau Pemesanan sumber daya) telah sepenuhnya digunakan.
500	InstanceNotReady	The specified instance is not ready for use.
500	InternalError	The request processing has failed due to an internal error and you may retry later or contact support with the request ID.
403	InvalidParameter.KMSKeyId.NotFound	The specified KMSKeyId does not exist. Please verify that the key ID is correct and that the key resides in the current region.
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.	Instans tempat disk tersambung terkunci karena alasan keamanan.
403	InsufficientBalance	Your account does not have enough balance.
403	DiskError	IncorrectDiskStatus.
403	InstanceExpired	The postPaid instance has been expired.Please ensure your account have enough balance.	Instansi langganan telah kedaluwarsa. Perpanjang instans sebelum melakukan operasi ini.
403	InstanceNotReady	The specified instance is not ready for use.
403	DiskInArrears	The specified operation is denied as your disk has expired.
403	OperationDenied.SpotPriceLowerThanPublicPrice	The spot instance price is lower than public price.	Harga penawaran untuk spot instans tidak boleh lebih rendah dari harga yang diterbitkan.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK needs to be added ECS tag.	Tag ECS harus ditambahkan ke customer master key (CMK).
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	The ECS service is not authorized to access your KMS key. Please grant the ECS service permission to use the key and try again.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	Jumlah instans yang akan dibuat dengan tipe instans yang dipilih di wilayah saat ini melebihi kuota, atau kuota total vCPU di semua tipe instans telah terlampaui. Anda dapat pergi ke Konsol ECS atau Pusat Kuota untuk meminta peningkatan kuota.
403	OperationDenied.HostRepairing	The specified operation is denied as the host of ECS instance is being repaired.	Mesin fisik tempat Instans ECS berada sedang dalam pemeliharaan. Operasi yang ditentukan tidak diizinkan.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.	Kategori disk yang ditentukan tidak ada di zona atau kluster yang ditentukan, atau zona yang ditentukan tidak cocok dengan kluster.
403	OperationDenied.KMSKeyUnauthorized	The operation is denied due to missing KMS key authorization. Please check the KMS key permissions and ensure the key is properly authorized for this operation.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Instans yang ditentukan tidak ada. Periksa apakah ID instans sudah benar.
404	InvalidCapacityReservationId.NotFound	The specified capacity reservation does not exist.
503	ServiceUnavailable	The request has failed due to a temporary failure of the server.	Permintaan backend habis waktu. Coba lagi nanti.
503	LimitedOperation.ServiceUnavailable	The service is currently unavailable. Please try again later.	Layanan saat ini tidak tersedia. Coba lagi nanti.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.