StopInstance - Elastic Compute Service - Alibaba Cloud Documentation Center

Menghentikan instans Elastic Compute Service (ECS). Anda dapat menentukan strategi penghentian, mode penghentian, dan mode operasi batch yang berbeda untuk menghentikan instans ECS.

Deskripsi operasi

Ini adalah operasi asinkron. Instans ECS tidak langsung berhenti setelah pemanggilan berhasil. Instans ECS pertama kali memasuki status Stopping. Anda dapat memanggil DescribeInstanceStatus untuk mengkueri status instans. Ketika status yang dikembalikan adalah Stopped, Instans ECS telah berhenti.

Sebelum Anda memulai

Instans ECS yang terkunci karena alasan keamanan tidak dapat dihentikan dengan memanggil operasi ini. Untuk informasi selengkapnya, lihat Dampak kunci keamanan Sumber daya pada pemanggilan API.
Setelah Anda mengaktifkan mode hemat untuk instans yang terhubung ke VPC, Anda dapat menyetel StoppedMode=KeepCharging untuk mengaktifkan mode penghentian standar. Penagihan instans ECS berlanjut setelah dihentikan, dan inventaris Tipe instans serta alamat IP Internet dipertahankan.

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

update

*Instance

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
InstanceId	string	Yes	ID instans.	i-bp67acfmxazb4ph****
ConfirmStop	boolean	No	Parameter ini akan segera dihentikan penggunaannya dan hanya dipertahankan untuk tujuan kompatibilitas. Abaikan parameter ini saat Anda memanggil operasi ini.	true
ForceStop	boolean	No	Apakah akan menghentikan instans secara paksa. Nilai valid: true: Menghentikan instans secara paksa. Ini setara dengan operasi mematikan daya. Semua data cache yang tidak ditulis ke perangkat penyimpanan akan hilang. false: Menghentikan instans secara normal. Nilai default: false.	false
StoppedMode	string	No	Mode penghentian untuk instans ECS pay-as-you-go. Nilai valid: StopCharging: mode hemat. Setelah mode hemat diaktifkan: Penagihan ditangguhkan untuk Sumber daya komputasi (vCPU, memori, dan GPU), biaya lisensi image, dan bandwidth tetap dari alamat IP publik statis. Penagihan berlanjut untuk disk sistem, disk data, dan bandwidth tetap dari Elastic IP Addresses (EIPs). Karena Sumber daya komputasi dilepaskan, instans mungkin gagal dimulai ulang karena inventaris tidak mencukupi. Coba lagi nanti atau ubah Tipe instans. Jika instans dikaitkan dengan EIP sebelum dihentikan, alamat IP tetap tidak berubah setelah instans dimulai ulang. Jika tidak, alamat IP publik statis mungkin berubah, tetapi alamat IP pribadi tetap tidak berubah. Untuk informasi selengkapnya, lihat Mode hemat. Penting Jika instans tidak mendukung mode hemat, tidak ada error yang dikembalikan di sisi API. Penghentian instans menjadi prioritas. Tipe instans yang tidak mendukung mode hemat mencakup instans dengan disk lokal dan instans langganan. KeepCharging: mode penghentian standar. Instans terus ditagih setelah dihentikan. Nilai default: Jika Anda mengaktifkan mode hemat untuk instans yang terhubung ke VPC di Konsol ECS (untuk informasi selengkapnya, lihat Mengaktifkan mode hemat secara default) dan kondisi terpenuhi, nilai default adalah `StopCharging`. Jika tidak, nilai default adalah `KeepCharging`.	KeepCharging
DryRun	boolean	No	Apakah akan menjalankan dry run saja. Nilai valid: true: Hanya menjalankan dry run. Instans tidak dihentikan. Sistem memeriksa apakah parameter wajib telah ditentukan, apakah format permintaan valid, apakah batasan bisnis terpenuhi, dan apakah inventaris ECS mencukupi. Jika pemeriksaan gagal, error yang sesuai akan dikembalikan. Jika pemeriksaan berhasil, kode kesalahan `DryRunOperation` akan dikembalikan. false: Menjalankan dry run dan mengirimkan permintaan. Instans dihentikan setelah pemeriksaan berhasil. Nilai default: false.	true
Hibernate	boolean	No	Catatan Parameter ini berada dalam pratinjau undangan dan tidak tersedia untuk digunakan.	hide

Elemen respons

Element	Type	Description	Example
	object
RequestId	string	ID permintaan.	1C488B66-B819-4D14-8711-C4EAAA13AC01

Contoh

Respons sukses

JSONformat

{
  "RequestId": "1C488B66-B819-4D14-8711-C4EAAA13AC01"
}

Kode kesalahan

HTTP status code	Error code	Error message
400	InvalidParameter.Encrypted.KmsNotEnable	Failed to perform this operation because KMS is not activated.
400	DiskError	IncorrectDiskStatus.
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.
403	InstanceType.ParameterMismatch	The input parameter ConfirmStop must be true when an instance have localstorage.
403	InstanceExpiredOrInArrears	The specified operation is denied as your prepay instance is expired (prepay mode) or in arrears (afterpay mode).
403	InvalidInstanceId.NotSupport	Classic network Instance does not support this operation.
403	InvalidParameter.KMSKeyId.CMKUnauthorized	The CMK needs to be added ECS tag
403	InvalidParameter.KMSKeyId.CMKNotEnabled	The CMK needs to be enabled.
403	InvalidParameter.KMSKeyId.KMSUnauthorized	ECS service have no right to access your KMS.
403	HibernationConfigured.InstanceOperationForbidden	The operation is not permitted due to limit of the hibernation configured instance.
403	HibernationConfigured.NotEnabled	The instance hibernation configured option is not enabled.
403	InvalidOperation.KMSKeyIdNotFound	The specified KMSKeyId not found, %s.
403	InvalidOperation.KMSServiceNotOpen	KMS service is currently not open.
403	OperationDenied.SystemInstanceNotSupport	The system instance does not support the %s operation because %s.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.
503	LimitedOperation.ServiceUnavailable	The service is currently unavailable. Please try again later.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.