この API を呼び出して、1 つや複数のサブスクリプションインスタンスを自動更新ステータスに設定できます。 インスタンスの有効期限が切れた際のメンテナンスに要するワークロード低減のため、サブスクリプション ECS インスタンスの自動更新を設定することができます。

説明

この API を呼び出す前に、ECS の課金方法と料金表の内容を十分にご確認ください。

  • 自動更新の支払いは、インスタンスの有効期限が切れる 9 日前の 08:00:00(UTC + 8)に始めて行われます。
  • 初めての支払いが失敗した場合、支払いを成功させるか、9 日間の期間が終了してインスタンスがロックされるまで、このプロセスは毎日繰り返されます。 支払口座に十分な残高またはクレジットがあることをご確認ください。

デバッグ

API Explorer でデバッグを実行できます。 API Explorer で各種操作を実行して API の使用を簡素化できます。 たとえば、API の取得、API の呼び出し、SDK のサンプルコードの動的な生成ができます。

リクエストパラメーター

名前 データ型 必須/省略可能 説明
InstanceId String 必須 i-instance1,i-instance2

インスタンス ID。 一度に最大 100 個のインスタンスを入力できます。 複数のインジケーターはコンマ(、)で区切ります。

RegionId String 必須 cn-hangzhou

インスタンスのリージョン ID 。 DescribeRegionsを実行すると、最新のリージョンリストが表示されます。

Action String 省略可能 ModifyInstanceAutoRenewAttribute

実行する操作。 値を ModifyInstanceAutoRenewAttribute に設定します。

AutoRenew Boolean 省略可能 true

自動更新が有効になっているかを示します。 デフォルト値:false。

Duration Integer 省略可能 2

自動更新期間。

  • PeriodUnitに設定した場合、購入期間を {"1", "2", "3 "} にすることができます。
  • PeriodUnitMonthに設定した場合、購入期間を {"1", "2", "3", "6", "12 "} にすることができます。
OwnerAccount String 省略可能 ECSforCloud@Alibaba.com

RAM ユーザーのログインネーム。

PeriodUnit String 省略可能 Week

Periodの単位。 既定値:Month 。 有効値:

  • Month 。
  • Year。
RenewalStatus String 省略可能 AutoRenewal

インスタンスを更新するかどうかを示します。RenewalStatusの優先度はAutoRenewよりも高くなっています。 RenewalStatusが指定されていない場合、デフォルトでAutoRenewの値が使用されます。 有効値:

  • AutoRenewal:自動更新を有効にします。
  • Normal:自動更新を無効にします。
  • NotRenewa:更新を使用しません。 システムは有効期限リマインダーを送信しなくなりましたが、有効期限の 3 日前に非更新リマインダーのみを送信します。 更新が使用されないインスタンスの場合、自動更新ステータスをNormalに変更できます。 そして、手動更新か、自動更新に設定できます。

レスポンスパラメーター

名前 データ型 説明
RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエスト ID 。 API 操作の結果にかかわらず、各 API リクエストに対してシステムから固有の RequestId が返されます。

リクエストの例


https://ecs.aliyuncs.com/?Action=ModifyInstanceAutoRenewAttribute
&RegionId=cn-hangzhou 
&InstanceId=i-instance1,i-instance2 
&Duration=2 
&AutoRenew=True 
&<Common request parameters>

通常のレスポンスの例

XML 形式

<ModifyInstanceAutoRenewAttributeResponse>
  <RequestId>04F0F334-1335-436C-A1D7-6C044FE73368</RequestId> 
</ModifyInstanceAutoRenewAttributeResponse>

JSON 形式

{
	"RequestId":"04F0F334-1335-436C-A1D7-6C044FE73368"
}

Error codes

HTTP ステータスコード エラーコード エラーメッセージ 説明
403 MissingParameter.InstanceId InstanceId should not be null. InstanceId が指定されていない場合に返されるエラーメッセージ。
403 InvalidParameter.InvalidInstanceId %s 指定された InstanceId が無効な場合に表示されるエラーメッセージ。
403 IncorrectInstanceStatus The current status of the resource does not support this operation. リソースの現在のステータスで該当の操作がサポートされていない場合に返されるエラーメッセージ。
403 InvalidParameter.Duration %s Duration パラメータが無効な場合に返されるエラーメッセージ。
403 InvalidParameter.RenewalStatus %s RenewalStatus パラメーターが無効な場合に返されるエラーメッセージ。
403 InvalidPeriodUnit.ValueNotSupported The specified parameter “Period” is not valid. 指定された PeriodUnit が無効な場合に返されるエラーメッセージ。

エラーコードの表示