RenewInstance - - Alibaba Cloud Documentation Center

Memperpanjang masa berlaku instans Elastic Compute Service (ECS) berlangganan.

Description

Sebelum memanggil operasi ini, pastikan Anda memahami metode penagihan dan jadwal harga ECS. Untuk informasi selengkapnya, lihat halaman produk Elastic Compute Service.
Anda dapat memanggil operasi ini untuk memperpanjang instans berlangganan dalam periode tertentu atau hingga tanggal kedaluwarsa yang disinkronkan.
Instans berlangganan tidak dapat diperpanjang baik dalam periode tertentu maupun hingga tanggal kedaluwarsa yang disinkronkan secara bersamaan melalui operasi ini. Pasangan parameter terkait periode perpanjangan (Period dan PeriodUnit) serta parameter ExpectedRenewDay bersifat saling eksklusif.
Akun Anda harus memiliki kredit yang mencukupi.

Debugging

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

Request parameter

Parameter	Type	Required	Example	Description
Action	String	Yes	RenewInstance	Operasi yang ingin Anda lakukan. Tetapkan nilainya ke RenewInstance.
ClientToken	String	No	0c593ea1-3bea-11e9-b96b-88e9fe637760	Token client yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menghasilkan nilainya dari sisi client, tetapi harus memastikan nilainya unik di antara permintaan yang berbeda. Nilai ClientToken hanya boleh berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.
InstanceId	String	Yes	i-bp67acfmxazb4p****	ID instans.
Period	Integer	No	1	Periode perpanjangan instans berlangganan. Jika parameter `DedicatedHostId` ditentukan, nilai Period tidak boleh melebihi periode langganan host khusus yang ditentukan. Nilai yang valid: Nilai yang valid saat PeriodUnit diatur ke Month: 1, 2, 3, 4, 5, 6, 7, 8, 9, dan 12. Catatan Pasangan parameter terkait periode perpanjangan (`Period` dan `PeriodUnit`) serta parameter `ExpectedRenewDay` bersifat saling eksklusif.
PeriodUnit	String	No	Month	Unit periode perpanjangan. Nilai yang valid: Month Nilai default: Month.
ExpectedRenewDay	Integer	No	5	Tanggal kedaluwarsa yang disinkronkan. Tetapkan nilainya ke tanggal kedaluwarsa yang telah Anda tentukan. Jika tidak, pemanggilan akan gagal. Jika Anda menetapkan parameter ini, instans Anda akan diperpanjang hingga tanggal kedaluwarsa yang disinkronkan tersebut. Nilai yang valid: 1 hingga 28. Untuk informasi tentang cara menyinkronkan tanggal kedaluwarsa instans, lihat Menyinkronkan tanggal kedaluwarsa instans berlangganan. Catatan Pasangan parameter terkait periode perpanjangan (`Period` dan `PeriodUnit`) serta parameter `ExpectedRenewDay` bersifat saling eksklusif.

Response parameters

Parameter	Type	Example	Description
OrderId	String	1234567890	ID pesanan.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	ID permintaan.

Examples

Contoh permintaan

http(s)://ecs.aliyuncs.com/?Action=RenewInstance
&InstanceId=i-bp67acfmxazb4p****
&Period=1
&PeriodUnit=Month
&ClientToken=0c593ea1-3bea-11e9-b96b-88e9fe637760
&Common request parameters

Contoh respons sukses

XML format

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

<RenewInstanceResponse>
    <OrderId>1234567890</OrderId>
    <RequestId>473469C7-AA6F-4DC5-B3DB-A3DC0DE3****</RequestId>
</RenewInstanceResponse>

JSON format

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

{
  "OrderId" : "1234567890",
  "RequestId" : "473469C7-AA6F-4DC5-B3DB-A3DC0DE3****"
}

Error codes

HttpCode	Error code	Error message	Description
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	Pesan kesalahan yang dikembalikan karena metode penagihan instans yang ditentukan untuk penggunaan jaringan tidak valid.
400	InvalidInstanceType.NotSupported	The specified InstanceType is not Supported.	Pesan kesalahan yang dikembalikan karena tipe instans yang ditentukan tidak valid.
400	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	Pesan kesalahan yang dikembalikan karena metode penagihan instans yang ditentukan tidak ada.
400	InvalidRebootTime.ValueNotSupported	The specified RebootTime is out of the permitted range.	Pesan kesalahan yang dikembalikan karena waktu restart yang ditentukan berada di luar rentang yang diizinkan.
400	IdempotenceParamNotMatch	Request uses a client token in a previous request but is not identical to that request.	Pesan kesalahan yang dikembalikan karena permintaan ini dan permintaan sebelumnya menggunakan token client yang sama tetapi dengan parameter berbeda.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	Pesan kesalahan yang dikembalikan karena parameter ClientToken yang ditentukan tidak valid.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Pesan kesalahan yang dikembalikan karena tipe instans yang ditentukan tidak ada atau karena Anda tidak memiliki otorisasi untuk mengelola instans dengan tipe instans tersebut.
400	InvalidInstanceType.codeUnauthorized	The specified InstanceType is not authorized.	Pesan kesalahan yang dikembalikan karena tipe instans yang ditentukan tidak valid.
400	InvalidInternetChargeType.InstanceNotSupported	The specified instance which is in vpc is not support the parameter InternetChargeType.	Pesan kesalahan yang dikembalikan karena metode penagihan untuk penggunaan jaringan yang ditentukan tidak didukung oleh instans yang berada di virtual private cloud (VPC).
400	InvalidPeriod	The specified period is not valid.	Pesan kesalahan yang dikembalikan karena parameter Period yang ditentukan tidak valid.
400	Upgrade.NotSupported	Upgrade operation is not supported.	Pesan kesalahan yang dikembalikan karena operasi upgrade tidak valid.
400	OperationDenied	Specified instance is in VPC.	Pesan kesalahan yang dikembalikan karena instans berada di VPC.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	Pesan kesalahan yang dikembalikan karena Anda tidak memiliki otorisasi untuk menggunakan tipe instans yang ditentukan.
400	DependencyViolation.InstanceType	Current instancetype cannot be changed to the specified one.	Pesan kesalahan yang dikembalikan karena tipe instans saat ini tidak dapat diubah menjadi tipe yang ditentukan.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	Pesan kesalahan yang dikembalikan karena parameter PeriodUnit yang ditentukan tidak valid.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	Pesan kesalahan yang dikembalikan karena host khusus yang ditentukan tidak ada.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat host khusus berada dalam status saat ini.
400	IncorrectDedicatedHostStatus	The 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.
400	InvalidStatus.Upgrading	The instance is upgrading; please try again later.	Pesan kesalahan yang dikembalikan karena konfigurasi instans yang ditentukan sedang dalam proses upgrade. Coba lagi nanti.
400	InvalidPeriod.ExceededMaximumExpirationDate	The specified renewal period cannot exceed the maximum expiration date. We recommend you try shortening the renewal period at next attempt.	Pesan kesalahan yang dikembalikan karena periode perpanjangan yang ditentukan melebihi nilai maksimum yang diizinkan. Kami menyarankan agar Anda memperpendek periode perpanjangan pada percobaan berikutnya.
400	LastOrderProcessing	The previous order is still processing, please try again later.	Pesan kesalahan yang dikembalikan karena pesanan sedang diproses. Coba lagi nanti.
400	Idempotence.Processing	The previous request is still processing, please try again later.	Pesan kesalahan yang dikembalikan karena permintaan sebelumnya sedang diproses. Coba lagi nanti.
400	OperationDenied	The current user does not support this operation.	Pesan kesalahan yang dikembalikan karena akun Anda tidak mendukung operasi ini.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat instans menggunakan metode penagihan saat ini.
403	Diskcategory.Mismatch	The disk specified to convert to portable is not allowed due to the disk category does not support.	Pesan kesalahan yang dikembalikan karena disk yang ditentukan tidak dapat dikonversi menjadi disk yang dapat dilepas karena batasan kategori disk.
403	IncorrectInstanceStatus	The 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.
403	InstanceSpecModification.NotEffective	The specified instance has been reserved for making a spec modification and not taken effective in the current contract period.	Pesan kesalahan yang dikembalikan karena instans dicadangkan akibat perubahan tipe instans. Perubahan yang dilakukan tidak dapat berlaku selama periode kontrak saat ini.
403	LastTokenProcessing	The last token request is processing.	Pesan kesalahan yang dikembalikan karena permintaan token terakhir sedang diproses. Coba lagi nanti.
403	Instance.UnPaidOrder	The specified instance has unpaid order.	Pesan kesalahan yang dikembalikan karena Anda memiliki pesanan yang belum dibayar untuk instans tersebut.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat instans dikunci karena alasan keamanan.
403	InvalidDisk.NotAllowed	The specified disk is not allowed to be converted to portable.	Pesan kesalahan yang dikembalikan karena disk yang ditentukan tidak dapat dikonversi menjadi disk yang dapat dilepas.
403	InstanceTypeNotSupported	The specified zone does not offer the specified instancetype.	Pesan kesalahan yang dikembalikan karena tipe instans yang ditentukan tidak didukung di zona yang ditentukan.
403	InvalidChargeType.NotSupported	The chargeType of the instance does not support this operation.	Pesan kesalahan yang dikembalikan karena operasi tidak didukung saat instans menggunakan metode penagihan saat ini.
403	OperationDenied.NoStock	The 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 habis di zona yang ditentukan. Coba tipe instans atau zona lain.
403	OperationDenied.NoStock	The resource is out of usage.	Pesan kesalahan yang dikembalikan karena instans tidak berada dalam status Running. Jalankan instans atau periksa apakah operasi yang ditentukan valid.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.	Pesan kesalahan yang dikembalikan karena instans dibuat menggunakan paket Starter dan hanya dapat diperpanjang secara otomatis setiap bulan.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Pesan kesalahan yang dikembalikan karena disk yang ditentukan tidak ada. Periksa apakah ID disk sudah benar.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Pesan kesalahan yang dikembalikan karena parameter InstanceId yang ditentukan tidak ada.
500	InternalError	The request processing has failed due to some unknown error.	Pesan kesalahan yang dikembalikan karena terjadi kesalahan internal. Coba lagi nanti.

Untuk daftar kode kesalahan, kunjungi API Error Center.