RenewInstance - Elastic Compute Service - Alibaba Cloud Documentation Center

Operasi ini digunakan untuk memperpanjang instance ECS berlangganan. Anda dapat menetapkan durasi perpanjangan atau memperpanjang instance hingga tanggal kedaluwarsa terpadu.

Deskripsi operasi

Sebelum Anda memanggil operasi ini, pastikan Anda telah memahami metode penagihan dan harga dari Elastic Compute Service (ECS).

Pastikan saldo atau batas kredit akun Anda mencukupi.
Hanya instance berlangganan yang didukung. Kesalahan akan dikembalikan jika Anda memanggil operasi ini untuk instance pay-as-you-go.
Anda harus menentukan salah satu dari parameter durasi perpanjangan (Period dan PeriodUnit) atau parameter tanggal kedaluwarsa terpadu (ExpectedRenewDay), tetapi Anda tidak dapat menentukan keduanya sekaligus.

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

*Instance

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. Hasilkan nilai dari klien Anda untuk memastikan nilai tersebut unik di antara permintaan yang berbeda. ClientToken hanya mendukung karakter ASCII dan tidak boleh melebihi 64 karakter. Untuk informasi selengkapnya, lihat Cara memastikan idempotensi.	0c593ea1-3bea-11e9-b96b-88e9fe637760
InstanceId	string	Yes	ID instance yang ingin Anda perpanjang.	i-bp67acfmxazb4p****
Period	integer	No	Durasi perpanjangan instance berlangganan. Jika `DedicatedHostId` ditentukan, nilai Period tidak boleh melebihi durasi langganan dari dedicated host. Nilai yang valid: Nilai yang valid ketika PeriodUnit diatur ke Month: 1, 2, 3, 4, 5, 6, 7, 8, 9, dan 12. Catatan Anda harus menentukan salah satu dari parameter durasi perpanjangan (`Period` dan `PeriodUnit`) atau parameter tanggal kedaluwarsa terpadu (`ExpectedRenewDay`), tetapi Anda tidak dapat menentukan keduanya sekaligus.	1
PeriodUnit	string	No	Satuan dari durasi perpanjangan, yaitu satuan dari parameter Period. Nilai yang valid: Month. Nilai default: Month.	Month
ExpectedRenewDay	integer	No	Memperpanjang instance hingga tanggal kedaluwarsa terpadu. Nilai yang valid: 1 hingga 28. Untuk menggunakan parameter ini, Anda harus menetapkan tanggal kedaluwarsa terpadu untuk instance ECS. Nilai parameter ini harus sama dengan tanggal kedaluwarsa terpadu yang telah Anda tetapkan. Jika tidak, pemanggilan akan gagal. Catatan Anda harus menentukan salah satu dari parameter durasi perpanjangan (`Period` dan `PeriodUnit`) atau parameter tanggal kedaluwarsa terpadu (`ExpectedRenewDay`), tetapi Anda tidak dapat menentukan keduanya sekaligus.	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
400	InvalidInternetChargeType.ValueNotSupported	The specified InternetChargeType is not 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.
400	InvalidRebootTime.Malformed	The specified RebootTime is not valid.
400	InvalidRebootTime.ValueNotSupported	The specified RebootTime is out of the permitted range.
400	IdempotenceParamNotMatch	Request uses a client token in a previous request but is not identical to that request.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.
400	InvalidInstanceType.codeUnauthorized	The specified InstanceType is not authorized.
400	InvalidInternetChargeType.InstanceNotSupported	The specified instance which is in vpc is not support the parameter InternetChargeType.
400	InvalidPeriod	The specified period is not valid.
400	MissingParamter	The specified parameter "Period" is not null.
400	Upgrade.NotSupported	Upgrade operation is not supported.
400	OperationDenied	Specified instance is in VPC.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
400	DependencyViolation.InstanceType	Current instancetype cannot be changed to the specified one.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.
400	IncorrectDedicatedHostStatus	The current status of the resource does not support this operation.
400	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
400	InvalidStatus.Upgrading	The instance is upgrading; please try again later.
400	InvalidPeriod.ExceededMaximumExpirationDate	The specified renewal period cannot exceed the maximum expiration date. We recommend you try shortening the renewal period at next attempt.
400	LastOrderProcessing	The previous order is still processing, please try again later.
400	Idempotence.Processing	The previous request is still processing, please try again later.
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.
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.
400	InvalidOperation.ClassicNetworkTypeNotSupported	The classic network instance does not support this operation.
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.
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.
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.
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.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.
403	OperationDenied.ImageNotValid	The specified image is not authorized.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.
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.
404	InvalidDiskId.NotFound	The specified disk does not exist.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.

Lihat Error Codes untuk daftar lengkap.

Catatan rilis

Lihat Release Notes untuk daftar lengkap.