RenewInstance - Elastic Compute Service - Alibaba Cloud Documentation Center

Memperpanjang instans Elastic Compute Service (ECS) berlangganan. Anda dapat menentukan periode perpanjangan atau memperpanjang instans hingga tanggal kedaluwarsa yang seragam.

Deskripsi operasi

Sebelum menggunakan operasi ini, pastikan Anda sepenuhnya memahami metode penagihan dan harga Elastic Compute Service (ECS).

Pastikan saldo akun atau batas kredit Anda mencukupi.
Hanya Instans langganan yang didukung. Memanggil operasi ini untuk Instans bayar sesuai pemakaian akan mengembalikan error.
Anda harus menentukan parameter periode perpanjangan (Period dan PeriodUnit) atau parameter tanggal kedaluwarsa seragam (ExpectedRenewDay), tetapi tidak keduanya.

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

update

*Instans.

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

None

Parameter permintaan

Parameter	Type	Required	Description	Example
ClientToken	string	No	Token klien yang digunakan untuk memastikan idempotensi permintaan. Anda dapat menggunakan klien untuk menghasilkan token, tetapi pastikan token tersebut unik di antara berbagai permintaan. Nilai ClientToken hanya dapat berisi karakter ASCII dan panjangnya tidak boleh melebihi 64 karakter. Untuk informasi lebih lanjut, lihat Cara memastikan idempotensi.	0c593ea1-3bea-11e9-b96b-88e9fe637760
InstanceId	string	Yes	ID instans yang ingin Anda perpanjang.	i-bp67acfmxazb4p****
Period	integer	No	Periode perpanjangan untuk Instans langganan. Jika Anda menentukan DedicatedHostId, nilai Period tidak boleh melebihi sisa periode berlangganan host khusus. Nilai valid: Jika PeriodUnit diatur ke Month, nilai valid Period: 1, 2, 3, 4, 5, 6, 7, 8, 9, dan 12. Catatan Anda harus menentukan parameter periode perpanjangan (Period dan PeriodUnit) atau parameter tanggal kedaluwarsa seragam (ExpectedRenewDay), tetapi tidak keduanya.	1
PeriodUnit	string	No	Unit periode perpanjangan. Parameter ini menentukan unit dari Period. Nilai valid: Month. Nilai default: Month.	Month
ExpectedRenewDay	integer	No	Tanggal untuk memperpanjang instans ke tanggal kedaluwarsa seragam. Nilai valid: 1 hingga 28. Untuk menggunakan parameter ini, Anda harus terlebih dahulu mengatur tanggal kedaluwarsa seragam untuk Instance ECS. Nilai parameter ini harus cocok dengan tanggal kedaluwarsa seragam yang telah Anda atur. Jika tidak, panggilan akan gagal. Catatan Anda harus menentukan parameter periode perpanjangan (Period dan PeriodUnit) atau parameter tanggal kedaluwarsa seragam (ExpectedRenewDay), tetapi tidak keduanya.	5

Elemen respons

Element	Type	Description	Example
	object
OrderId	string	ID pesanan.	1234567890
RequestId	string	ID permintaan.	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

Contoh

Respons sukses

JSONformat

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

Kode kesalahan

HTTP status code	Error code	Error message	Description
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not valid.	Metode penagihan jaringan yang ditentukan tidak valid.
400	InvalidInstanceType.NotSupported	The specified InstanceType is not Supported.
400	InvalidParameter	The specified parameter "InternetMaxBandwidthOut" is not valid.
400	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	Metode penagihan instans yang ditentukan tidak ada.
400	InvalidRebootTime.Malformed	The specified RebootTime is not valid.
400	InvalidRebootTime.ValueNotSupported	The specified RebootTime is out of the permitted range.	Pengatur waktu restart yang ditentukan tidak valid.
400	IdempotenceParamNotMatch	Request uses a client token in a previous request but is not identical to that request.	Parameter permintaan tidak cocok dengan parameter pada permintaan yang memiliki ClientToken yang sama.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	ClientToken yang ditentukan tidak valid.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	Tipe instans yang ditentukan tidak valid karena berada di luar rentang yang tersedia.
400	InvalidInstanceType.codeUnauthorized	The specified InstanceType is not authorized.	InstanceType yang ditentukan tidak valid.
400	InvalidInternetChargeType.InstanceNotSupported	The specified instance which is in vpc is not support the parameter InternetChargeType.	InternetChargeType yang ditentukan tidak didukung untuk instans ini.
400	InvalidPeriod	The specified period is not valid.	Periode pengatur waktu tertentu tidak valid.
400	MissingParamter	The specified parameter "Period" is not null.	Parameter Period tidak boleh kosong.
400	Upgrade.NotSupported	Upgrade operation is not supported.	Operasi peningkatan tidak valid.
400	OperationDenied	Specified instance is in VPC.	Snapshot yang ditentukan tidak mengizinkan pembuatan volume data.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
400	DependencyViolation.InstanceType	Current instancetype cannot be changed to the specified one.	Tipe instans saat ini tidak dapat diubah ke tipe instans yang ditentukan.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	Parameter PeriodUnit tidak valid.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	Host khusus yang ditentukan tidak ada.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	Status saat ini dari host khusus tidak mendukung operasi ini.
400	IncorrectDedicatedHostStatus	The current status of the resource does not support this operation.	Status Sumber daya saat ini tidak mendukung operasi ini.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
400	InvalidStatus.Upgrading	The instance is upgrading; please try again later.	Instans sedang ditingkatkan. 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.	Periode perpanjangan yang ditentukan tidak boleh melebihi periode validitas maksimum. Pendekkan periode perpanjangan, lalu coba lagi.
400	LastOrderProcessing	The previous order is still processing, please try again later.	Pesanan sedang diproses. Coba lagi nanti.
400	Idempotence.Processing	The previous request is still processing, please try again later.	Permintaan sedang diproses. Coba lagi nanti.
400	InvalidLoanOrderStatus.Uncompleted	Any unpaid order must be cancelled before you try this action again. The scheduled unpaid order is a loan order that cannot be auto cancelled. For more information, visit the loan management center.
400	OperationDenied.UnfinishedOrder	The current instance has unfinished refundOrder, this operation is denied.	Instans memiliki pesanan pengembalian dana yang tertunda. Tunggu dan coba lagi nanti.
400	InvalidPeriod.NotFound	The specified period and expectedRenewDay cannot both be empty.
400	InvalidExpectedRenewDay.StarterPackageNotSupported	The specified starterPackage cannot support renew with expectedRenewDay.
400	InvalidParam.ExpectedRenewDay	The specified param ExpectedRenewDay is not valid.
400	QuotaExceed.AlignInstance	The maximum number of align operations is exceeded.
400	InvalidExpectedRenewDay.Conflict	The specified expectedRenewDay is in conflict with period.
400	InvalidExpectedRenewDay.ValueNotSupported	The specified parameter ExpectedRenewDay is not valid.
400	OperationDenied.AbnormalInstanceInfo	The current renewable operation is not supported due to abnormal information of the instance, please submit ticket to process.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.	Operasi ini memerlukan izin penagihan. Minta izin dari akun utama Anda, atau atur parameter AutoPay ke true untuk pembayaran otomatis.
400	InvalidOperation.ClassicNetworkTypeNotSupported	The classic network instance does not support this operation.	Instans berbasis arsitektur jaringan klasik tidak dapat diperpanjang. Lakukan migrasi ke VPC sebelum Anda melakukan perpanjangan normal.
500	InternalError	The request processing has failed due to some unknown error.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
403	Diskcategory.Mismatch	The disk specified to convert to portable is not allowed due to the disk category does not support.	Disk yang ditentukan tidak dapat diubah menjadi disk yang dapat dilepas karena pembatasan tipe disk. Disk tidak dapat menguninstall.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.
403	InstanceSpecModification.NotEffective	The specified instance has been reserved for making a spec modification and not taken effective in the current contract period.	Instans yang ditentukan dipesan karena perubahan spesifikasi dan tidak dapat berlaku selama periode kontrak saat ini.
403	LastTokenProcessing	The last token request is processing.
403	Instance.UnPaidOrder	The specified instance has unpaid order.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	Instans tempat disk menyambungkan terkunci karena alasan keamanan.
403	InvalidDisk.NotAllowed	The specified disk is not allowed to be converted to portable.
403	InstanceTypeNotSupported	The specified zone does not offer the specified instancetype.
403	InvalidChargeType.NotSupported	The chargeType of the instance does not support this operation.	Operasi ini tidak didukung untuk instans dengan tipe penagihan ini.
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.ImageNotValid	The specified marketplace image is not authorized. Please verify the marketplace image authorization and try again.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.	Instans yang berpartisipasi dalam promosi paket tingkat awal hanya dapat diatur untuk perpanjangan otomatis bulanan.
403	RenewDateNotSupported.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed three days before it expires.
403	PrePaidInstance.Expired	The prePaid instance has expired.	Instansi langganan telah kedaluwarsa.
404	InvalidDiskId.NotFound	The specified disk does not exist.	Disk yang ditentukan tidak ada. Periksa apakah ID disk sudah benar.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	Instans yang ditentukan tidak ada. Periksa apakah ID instans sudah benar.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.