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

1 つ以上のリザーブドインスタンスを更新します。リザーブドインスタンスを更新する際、有効期間 (更新期間) およびリザーブドインスタンスの自動更新を有効にするかどうかを指定できます。

操作説明

この操作を呼び出す前に、リザーブドインスタンスの課金と料金設定をよく理解していることを確認してください。

リザーブドインスタンスは手動で更新するか、自動更新を有効にすることができます。詳細については、「リザーブドインスタンス」トピックの「更新」セクションをご参照ください。
DescribeReservedInstances 操作を呼び出して、購入したリザーブドインスタンスをクエリできます。
この操作を呼び出してリザーブドインスタンスの自動更新を有効にすることはできますが、この操作で自動更新を無効にすることはできません。リザーブドインスタンスの自動更新を無効にするには、ModifyReservedInstanceAutoRenewAttribute 操作を呼び出します。

今すぐお試しください

この 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:RenewReservedInstances

create

*ReservedInstance

acs:ecs:{#regionId}:{#accountId}:reservedinstance/{#ReservedInstanceId}

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
ReservedInstanceId	array	任意	リザーブドインスタンスの ID。
	string	任意	リザーブドインスタンスの ID。DescribeReservedInstances 操作を呼び出して、購入したリザーブドインスタンスの ID をクエリできます。 1 回のリクエストで最大 10 個のリザーブドインスタンス ID を指定できます。	ecsri-2ze53qonjqxg7r****
RegionId	string	任意	リザーブドインスタンスのリージョン ID。 DescribeRegions 操作を呼び出して、最新のリージョンリストをクエリできます。	cn-hangzhou
Period	integer	任意	リザーブドインスタンスの有効期間。有効値：1 および 3。デフォルト値：1。	1
PeriodUnit	string	任意	リザーブドインスタンスの有効期間の単位。値を Year に設定します。	Year
ClientToken	string	任意	リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認する必要があります。トークンは ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」をご参照ください。	123e4567-e89b-12d3-a456-426655440000
AutoRenew	boolean	任意	リザーブドインスタンスの自動更新を有効にするかどうかを指定します。有効値： true false デフォルト値：false。	true
AutoRenewPeriod	integer	任意	自動更新期間。単位：月。このパラメーターは、AutoRenew が true に設定されている場合にのみ有効です。有効値：12 および 36。デフォルト値：12。	1

レスポンスフィールド

フィールド	型	説明	例
	object
RequestId	string	リクエスト ID。	8C314443-AF0D-4766-9562-C83B7F1****
ReservedInstanceIdSets	object
ReservedInstanceId	array	リザーブドインスタンスの ID。
	string	リザーブドインスタンスの ID。	ecsri-2ze53qonjqxg7r****
OrderId	string	注文 ID。	2023912123****

例

成功レスポンス

JSONJSON

{
  "RequestId": "8C314443-AF0D-4766-9562-C83B7F1****",
  "ReservedInstanceIdSets": {
    "ReservedInstanceId": [
      "ecsri-2ze53qonjqxg7r****"
    ]
  },
  "OrderId": "2023912123****"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ
400	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
400	InvalidParameter.Conflict	The specified region and cluster do not match.
400	InvalidTagKey.Malformed	The specified Tag.n.Key is not valid.
400	InvalidPeriodUnit.ValueNotSupported	The specified parameter PeriodUnit is not valid.
400	InvalidTagValue.Malformed	The specified Tag.n.Value is not valid.
400	InvalidChargeType.ValueNotSupported	ChargeType is not valid.
400	OperationDenied	The specified InstanceType or Zone is not authorized for current user.
400	InvalidPeriod	The specified Period or PeriodUnit is not correct.
400	MissingParameter.ReservedInstanceIds	The specified ReservedInstanceIds does not exist.
400	InvalidParameter.PeriodUnit	The specified PeriodUnit is invalid.
400	InvalidParameter.Period	The specified Period is invalid.
400	InvalidParameter.ReservedInstanceIds	The specified ReservedInstanceIds is invalid.
400	InvalidPeriod.ExceededMaximumExpiration	The specified renewal period cannot exceed the maximum expiration date. We recommend you try shortening the renewal period at next attempt.
500	InternalError	The request processing has failed due to some unknown error.
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	Sales of this resource are temporarily suspended in the specified region; please try again later.
403	NodeControllerUnavailable	The Node Controller is temporarily unavailable.
403	InvalidParameter.ResourceOwnerAccount	ResourceOwnerAccount is Invalid.
403	Zone.NotOpen	The specified zone is not granted to you to buy resources yet.
403	Zone.NotOnSale	The specified zone is not available for purchase.
403	Account.Arrearage	Your account has been in arrears.
403	InvalidReservedInstanceName.Malformed	The specified parameter ReservedInstanceName is invalid.
403	InvalidParameter.Scope	The specified parameter 'Scope' is invalid.
403	InvalidReservedInstanceStatus.ValueNotSupported	ReservedInstance status is not supported.
403	InvalidReservedInstanceOfferingType.ValueNotSupported	The OfferingType is not supported.
403	InvalidReservedInstanceOfferingClass.ValueNotSupported	The OfferingClass is not supported.
403	MissingParameter.ZoneId	The specified zoneId should be not empty.
403	MissingParameter.InstanceType	The instanceType should be not empty.
403	MissingParameter.ReservedInstanceId	The ids of reservedInstance can not be empty.
403	MissingParameter.ReservedInstanceConfiguration	The configurations of reservedInstance can not be empty.
403	InvalidParameter.SplitOrMerge	The Many-to-many of modification is not supported.
403	MissingParameter.InstanceTypeAndAmountBothEmpty	The instanceType and amount can not be both empty.
403	InvalidReservedInstancePlatform.ValueNotSupported	The Platform is not supported.
403	InvalidParameter.ReservedInstanceName	The reservedInstanceName is invalid.
403	InvalidReservedInstanceZone.ValueNotSupported	The zoneId is not exist.
403	InvalidParameter.ValueNotSupported	The instanceTypeFamily of the instance to be changed must be consistent.
403	IncorrectInstanceStatus	The status of specified reservedInstance must be active.
403	InvalidPlatform.ValueNotSupported	The platform of reservedInstance is invalid.
403	InvalidScope.ValueNotSupported	The scope of reservedInstance is invalid, The valid value is Zone or Region.
403	InvalidConfiguration.ValueNotSupported	The modification Configuration should not be empty.
403	InvalidZoneId.ValueNotSupported	The specified zoneId should be same.
403	InvalidParameter	The parameter is invalid.Please check it.
403	InvalidInstanceAmount.ValueNotSupported	The instanceAmount is invalid.
403	OperationDenied.OnlyModifyName	It is not allowed to modify the ReservedInstanceName only.
403	InvalidReservedInstanceId.NotFound	The specified parameter ReservedInstanceId is invalid.
403	ChargeTypeViolation	The operation is not permitted due to charge type of the instance.
404	InvalidZoneId.NotFound	The ZoneId provided does not exist in our records.

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

変更履歴

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