StartInstance - Elastic Compute Service - Alibaba Cloud Documentation Center

Memulai sebuah instans ECS. Anda dapat memulai instans dengan menentukan ID instans dan secara opsional mengatur parameter seperti InitLocalDisk.

Deskripsi operasi

Ini adalah operasi asinkron. Instans tidak langsung dimulai setelah pemanggilan berhasil. Instans pertama-tama memasuki status Starting. Panggil DescribeInstanceStatus untuk mengkueri status instans. Ketika status yang dikembalikan adalah Running, instans telah dimulai.

Sebelum Anda mulai

Instans yang terkunci karena alasan keamanan tidak dapat dimulai dengan memanggil operasi ini. Untuk informasi lebih lanjut, lihat Dampak kunci keamanan sumber daya pada panggilan API.
Instans ECS harus berada dalam status Stopped (Stopped).
Instans dalam mode hemat mungkin gagal dimulai karena persediaan 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 dari instans yang ingin Anda mulai.	i-bp67acfmxazb4p****
InitLocalDisk	boolean	No	Apakah akan memulihkan instans ke kondisi kesehatan awal ketika disk lokal mengalami kegagalan. Parameter ini berlaku untuk keluarga instans yang menggunakan disk lokal, seperti keluarga instans d1, i1, dan i2. Nilai valid: true: Memulihkan instans ke kondisi kesehatan awal. Peringatan Semua data yang disimpan pada disk lokal 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 dimulai. 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 dimulai. 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 habis 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.
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 terkunci karena alasan keamanan. Hubungi dukungan teknis 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 yang ditentukan telah kedaluwarsa.
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.	ECS tidak memiliki izin untuk mengenkripsi atau mendekripsi CMK Anda.
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.	Layanan ECS tidak memiliki izin untuk mengakses KMS Anda.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	Penggunaan ECS melebihi kuota. Masuk ke Konsol Manajemen Alibaba Cloud dan ajukan permintaan untuk meningkatkan kuota.
403	OperationDenied.HostRepairing	The specified operation is denied as the host of ECS instance is being repaired.	Operasi yang ditentukan tidak diizinkan karena mesin fisik yang menampung Instans ECS sedang dalam pemeliharaan.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.	Tipe instans saat ini tidak tersedia.
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.	ID instans yang ditentukan tidak valid.
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 mengalami waktu habis pengatur waktu. Coba lagi.
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.