RenewInstance - - 阿里雲

Renews a subscription Elastic Compute Service (ECS) instance.

Description

Before you call this operation, make sure that you understand the billing methods and pricing schedule of ECS. For more information, see the Elastic Compute Service product page.
You can call this operation to renew a subscription instance for a period of time or to a synchronized expiration date.
A subscription instance cannot be renewed for a period of time and to a synchronized expiration date at the same time by calling this operation. The renewal period-related parameter pair (Period and PeriodUnit) and the ExpectedRenewDay parameter are mutually exclusive.
Your account must have sufficient credits.

Debugging

OpenAPI Explorer automatically calculates the signature value. For your convenience, we recommend that you call this operation in OpenAPI Explorer. OpenAPI Explorer dynamically generates the sample code of the operation for different SDKs.

Request parameter


Parameter	Type	Required	Example	Description
Action	String	Yes	RenewInstance	The operation that you want to perform. Set the value to RenewInstance.
ClientToken	String	No	0c593ea1-3bea-11e9-b96b-88e9fe637760	The client token that is used to ensure the idempotence of the request. You can use the client to generate the value, but you must make sure that it is unique among different requests. The ClientToken value can contain only ASCII characters and cannot exceed 64 characters in length. For more information, see How to ensure idempotence.
InstanceId	String	Yes	i-bp67acfmxazb4p****	The ID of the instance.
Period	Integer	No	1	The renewal period of the subscription instance. If the `DedicatedHostId` parameter is specified, the value of Period must not exceed the subscription period of the specified dedicated host. Valid values: Valid values when PeriodUnit is set to Month: 1, 2, 3, 4, 5, 6, 7, 8, 9, and 12. Note The renewal period-related parameter pair (`Period` and `PeriodUnit`) and the `ExpectedRenewDay` parameter are mutually exclusive.
PeriodUnit	String	No	Month	The unit of the renewal period. Valid value: Month Default value: Month.
ExpectedRenewDay	Integer	No	5	The synchronized expiration date. Set the value to a synchronized expiration date that you specified. Otherwise, the call fails. If you set this parameter, your instance will be renewed to the specified synchronized expiration date. Valid values: 1 to 28. For information about how to synchronize the expiration dates of instances, see Synchronize the expiration dates of subscription instances. Note The renewal period-related parameter pair (`Period` and `PeriodUnit`) and the `ExpectedRenewDay` parameter are mutually exclusive.

Response parameters


Parameter	Type	Example	Description
OrderId	String	1234567890	The ID of the order.
RequestId	String	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****	The ID of the request.

Examples

Sample requests

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

Sample success responses

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.	The error message returned because the specified instance billing method for network usage is invalid.
400	InvalidInstanceType.NotSupported	The specified InstanceType is not Supported.	The error message returned because the specified instance type is invalid.
400	InvalidInstanceChargeType.NotFound	The InstanceChargeType does not exist in our records.	The error message returned because the specified instance billing method does not exist.
400	InvalidRebootTime.ValueNotSupported	The specified RebootTime is out of the permitted range.	The error message returned because the specified restart time is out of the permitted range.
400	IdempotenceParamNotMatch	Request uses a client token in a previous request but is not identical to that request.	The error message returned because this request and the previous request contain the same client token but different parameters.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	The error message returned because the specified ClientToken parameter is invalid.
400	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.	The error message returned because the specified instance type does not exist or because you are not authorized to manage instances of the specified instance type.
400	InvalidInstanceType.codeUnauthorized	The specified InstanceType is not authorized.	The error message returned because the specified instance type is invalid.
400	InvalidInternetChargeType.InstanceNotSupported	The specified instance which is in vpc is not support the parameter InternetChargeType.	The error message returned because the specified billing method for network usage is not supported by the specified instance that resides in a virtual private cloud (VPC).
400	InvalidPeriod	The specified period is not valid.	The error message returned because the specified Period parameter is invalid.
400	Upgrade.NotSupported	Upgrade operation is not supported.	The error message returned because the upgrade operation is invalid.
400	OperationDenied	Specified instance is in VPC.	The error message returned because the instance resides in a VPC.
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.	The error message returned because you are not authorized to use the specified instance type.
400	DependencyViolation.InstanceType	Current instancetype cannot be changed to the specified one.	The error message returned because the current instance type cannot be changed to the specified one.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.	The error message returned because the specified PeriodUnit parameter is invalid.
400	InvalidDedicatedHostId.NotFound	The specified DedicatedHostId does not exist.	The error message returned because the specified dedicated host does not exist.
400	InvalidDedicatedHostStatus.NotSupport	Operation denied due to dedicated host status.	The error message returned because the operation is not supported while the dedicated host is in the current state.
400	IncorrectDedicatedHostStatus	The current status of the resource does not support this operation.	The error message returned because the operation is not supported while the resource is in the current state.
400	InvalidStatus.Upgrading	The instance is upgrading; please try again later.	The error message returned because the configurations of the specified instance are being upgraded. 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.	The error message returned because the specified renewal period exceeds the maximum allowed value. We recommend that you shorten the renewal period on your next attempt.
400	LastOrderProcessing	The previous order is still processing, please try again later.	The error message returned because the order is being processed. Try again later.
400	Idempotence.Processing	The previous request is still processing, please try again later.	The error message returned because the previous request is being processed. Try again later.
400	OperationDenied	The current user does not support this operation.	The error message returned because your account does not support the operation.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.	The error message returned because the operation is not supported while the instance uses the current billing method.
403	Diskcategory.Mismatch	The disk specified to convert to portable is not allowed due to the disk category does not support.	The error message returned because the specified disk cannot be converted to a removable disk due to disk category constraints.
403	IncorrectInstanceStatus	The current status of the resource does not support this operation.	The error message returned because the operation is not supported while the resource is in the current state.
403	InstanceSpecModification.NotEffective	The specified instance has been reserved for making a spec modification and not taken effective in the current contract period.	The error message returned because the instance is reserved due to an instance type change. Changes made to it cannot take effect during the current contract period.
403	LastTokenProcessing	The last token request is processing.	The error message returned because the last token request is being processed. Try again later.
403	Instance.UnPaidOrder	The specified instance has unpaid order.	The error message returned because you have unpaid orders for the instance.
403	InstanceLockedForSecurity	The specified operation is denied as your instance is locked for security reasons.	The error message returned because the operation is not supported while the instance is locked for security reasons.
403	InvalidDisk.NotAllowed	The specified disk is not allowed to be converted to portable.	The error message returned because the specified disk cannot be converted to a removable disk.
403	InstanceTypeNotSupported	The specified zone does not offer the specified instancetype.	The error message returned because the specified instance type is not supported in the specified zone.
403	InvalidChargeType.NotSupported	The chargeType of the instance does not support this operation.	The error message returned because the operation is not supported while the instance uses the current billing method.
403	OperationDenied.NoStock	The requested resource is sold out in the specified zone, try other types of resources or other regions and zones.	The error message returned because requested resources are sold out in the specified zone. Try a different instance type or zone.
403	OperationDenied.NoStock	The resource is out of usage.	The error message returned because the instance is not in the Running state. Start the instance or check whether the specified operation is valid.
403	InvalidPeriod.StarterPackage	This instance was created by using a Starter Package plan and can only be renewed monthly, not yearly.	The error message returned because the instance was created by using a Starter Package plan and can only be automatically renewed on a monthly basis.
404	InvalidDiskId.NotFound	The specified disk does not exist.	The error message returned because the specified disk does not exist. Check whether the disk ID is correct.
404	InvalidInstanceId.NotFound	The specified InstanceId does not exist.	The error message returned because the specified InstanceId parameter does not exist.
500	InternalError	The request processing has failed due to some unknown error.	The error message returned because an internal error has occurred. Try again later.

For a list of error codes, visit the API Error Center.