RenewInstance - Elastic Compute Service - Alibaba Cloud ドキュメントセンター

サブスクリプションの Elastic Compute Service (ECS) インスタンスを更新します。更新期間を指定するか、インスタンスを統一有効期限日まで更新できます。

操作説明

この操作を呼び出す前に、ECS の支払い方法と料金をよく理解していることを確認してください。

アカウントの残高またはクレジット残高が十分であることを確認してください。
サブスクリプションインスタンスのみがサポートされています。従量課金インスタンスに対してこの操作を呼び出すと、エラーが返されます。
更新期間に関連するパラメーターペア (Period と PeriodUnit) または ExpectedRenewDay のいずれかを指定する必要がありますが、両方を指定することはできません。

今すぐお試しください

この API を OpenAPI Explorer でお試しください。手作業による署名は必要ありません。呼び出しに成功すると、入力したパラメーターに基づき、資格情報が組み込まれた SDK コードが自動的に生成されます。このコードをダウンロードしてローカルで使用できます。

テスト

RAM 認証

下表に、この API を呼び出すために必要な認証情報を示します。認証情報は、RAM (Resource Access Management) ポリシーを使用して定義できます。以下で各列名について説明します。

アクション：特定のリソースに対して実行可能な操作。ポリシー構文ではAction要素として指定します。
API：アクションを具体的に実行するための API。
アクセスレベル：各 API に対して事前定義されているアクセスの種類。有効な値：create、list、get、update、delete。
リソースタイプ：アクションが作用するリソースの種類。リソースレベルでの権限をサポートするかどうかを示すことができます。ポリシーの有効性を確保するため、アクションの対象として適切なリソースを指定してください。
- リソースレベルの権限を持つ API の場合、必要なリソースタイプはアスタリスク (*) でマークされます。ポリシーのResource要素で対応する ARN を指定してください。
- リソースレベルの権限を持たない API の場合、「すべてのリソース」と表示され、ポリシーのResource要素でアスタリスク (*) でマークされます。
条件キー：サービスによって定義された条件のキー。このキーにより、きめ細やかなアクセス制御が可能になります。この制御は、アクション単体に適用することも、特定のリソースに対するアクションに適用することもできます。Alibaba Cloud は、サービス固有の条件キーに加えて、すべての RAM 統合サービスに適用可能な一連の共通条件キーを提供しています。
依存アクション：ある特定のアクションを実行するために、前提として実行が必要となる他のアクション。依存アクションの権限も RAM ユーザーまたは RAM ロールに付与する必要があります。

アクション

アクセスレベル

リソースタイプ

条件キー

依存アクション

ecs:RenewInstance

update

*Instance

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ClientToken	string	任意	リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。トークンは ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。	0c593ea1-3bea-11e9-b96b-88e9fe637760
InstanceId	string	必須	更新するインスタンスの ID。	i-bp67acfmxazb4p****
Period	integer	任意	サブスクリプションインスタンスの更新期間。`DedicatedHostId` が指定されている場合、Period の値は指定された専用ホストのサブスクリプション期間を超えることはできません。 PeriodUnit が Month に設定されている場合の有効な値：1、2、3、4、5、6、7、8、9、12。説明更新期間に関連するパラメーターペア (`Period` と `PeriodUnit`) と `ExpectedRenewDay` は相互排他的です。	1
PeriodUnit	string	任意	更新期間の単位。有効な値： Month デフォルト値：Month。	Month
ExpectedRenewDay	integer	任意	統一有効期限日を指定します。有効な値：1～28。このパラメーターを使用するには、ECS インスタンスの統一有効期限日を指定する必要があります。このパラメーターの値は、指定された統一有効期限日と同じでなければなりません。そうでない場合、呼び出しは失敗します。説明更新期間に関連するパラメーターペア (`Period` と `PeriodUnit`) と `ExpectedRenewDay` は相互排他的です。	5

レスポンスフィールド

フィールド	型	説明	例
	object
OrderId	string	注文 ID。	1234567890
RequestId	string	リクエスト ID。	473469C7-AA6F-4DC5-B3DB-A3DC0DE3****

例

成功レスポンス

JSONJSON

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

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
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.

完全なリストについては、「エラーコード」をご参照ください。

変更履歴

完全なリストについては、「変更履歴」をご参照ください。