1 つ以上のインスタンスの課金方法を切り替えます。このインターフェイスを使用して、従量課金とサブスクリプション間で課金方法を変更できます。さらに、インスタンスにマウントされているすべての従量課金クラウドディスクをサブスクリプションクラウドディスクに変更できます。

説明

このインターフェイスを呼び出す前に、 ECS の課金方法や定価などを予めご了承ください。

このインターフェイスを呼び出すときは、次の点にご注意ください:

  • 対象のインスタンスが 実行中Running )または 停止中Stopped )ステータスの場合と、お支払いアカウントの残高が十分な場合にのみ、課金方法を変更できます。
  • デフォルトでは、システムは最新の課金方法を使用して自動的に料金を請求します。アカウントの残高が十分にあることを確認します。そうでない場合、システムは注文を例外とみなすため、注文をキャンセルしなければなりません。アカウントの残高が不十分な場合は、 AutoPayfalse に設定します、システムは通常の未払いの注文を生成します。 ECS コンソール にログインすると、この注文の支払いを行えます。
  • サブスクリプションから従量課金へ
    • 特定の信用レベルに達した Alibaba Cloud ユーザーは、課金方法をサブスクリプションから従量課金に変更できます。
    • 課金方法をサブスクリプションから従量課金に変更した後、新しい課金方法はインスタンスのライフサイクル全体を通して有効になり、インスタンス料金差額の返金が受けられます。元の支払アカウントに返金されますが、引き換え済みのクーポンは返金されません。
    • 返金ポリシー :1 か月間、自由に受け取ることができる返金額は限られています。また、返金額は翌月に繰り越しされません。当月の最大返金額に達した場合は、翌月にのみ課金方法を変更できます。課金方法の変更で発生した返金額は、次の式で計算されます。 vCPU 数 × (課金方法切り替え日を除くインスタンスのライフサイクル内の残り日数 × 24 + 課金方法切り替え日の残り時間数) または vCPU 数 × (課金方法切り替え日を含むインスタンスのライフサイクル内の残り日数 x 24 - 課金方法切り替え日の経過時間数)
  • 従量課金からサブスクリプションへ
    • インスタンスにマウントされているすべての従量課金データディスクを、サブスクリプションディスクに変更できます。
    • リリース時間が従量課金インスタンスに設定されている場合、このインタフェースは呼び出すことができません。

デバッグ

API Explorer】にアクセスしてデバッグできます。API Explorer は API のオンライン呼び出し、SDK Example コードの動的作成、及びクイック検索 API などの機能を提供し、クラウド API の使用方法をさらに簡単にすることができるため、強く推奨いたします。

リクエストパラメータ

名前 データ型 必須かどうか 説明
InstanceIds String はい ["i-xxxxx1","i-xxxxx2"]

インスタンスの ID。その値は複数のインスタンス ID で構成される JSON 配列です。最大 20 個の ID を使用でき、ID はカンマ ( , )で区切る必要があります。。

RegionId String はい cn-hangzhou

インスタンスが配置されているリージョンの ID。 DescribeRegions を呼び出して最新のリージョンリストを取得します。

Action String いいえ ModifyInstanceChargeType

インターフェースの名前。値: ModifyInstanceChargeType

AutoPay Boolean いいえ false

自動支払いを許可するかどうか。パラメータ OperatorType が downgrade に設定されている場合、パラメータの AutoPay を無視します。値の範囲:

  • true (デフォルト値) :自動支払いを許可します。支払いアカウントの残高が十分であることを確認します。残高が足りない場合、注文がエラーになりますが、これはキャンセルすることしかできません。
  • false:請求書のみ生成されます。支払いアカウントの残高が足りない場合は、 AutoPayfalse に設定します、そうすると通常の未払いの注文が生成されます。 ECS コンソールにログインして注文の支払いを行えます。
DryRun Boolean いいえ false

システムが権限チェックのみ実行するかどうか。

  • true:実際の API アクションを実行せずに、権限チェックリクエストを送信します。DryRun を有効にすると、AccessKey が有効かどうか、RAM ユーザーの認証ステータス、および必要なパラメーターが設定されているかどうかをチェックします。必要な権限がない場合は、関連するエラー応答が返されます。それ以外の場合は、 DryRunOperation になります。
  • false(デフォルト):通常のリクエストを送信し、チェック後に 2XX HTTP ステータスコードを返し、リソースステータスを直接照会します。
IncludeDataDisks Boolean いいえ true

インスタンスにマウントされているすべての従量課金データディスクを、サブスクリプションディスクに変更するかどうか。デフォルト値は true です。

InstanceChargeType String いいえ PrePaid

対象の課金方法、値の範囲:

  • PrePaid(デフォルト値):サブスクリプション。課金方法が従量課金からサブスクリプションに変更されます。
  • PostPaid:従量課金。課金方法がサブスクリプションから従量課金に変更されます。
OwnerAccount String いいえ EcsforCloud@Alibaba.com

RAM ユーザーのアカウント名。

Period Integer いいえ 2

インスタンスライフサイクル。DedicatedHostId を指定すると、値の範囲は DDH の有効期間を超えることはできません。値の範囲:

  • PeriodUnit=Month の場合, Period の値:{ “1”, “2”, “3”, “4”, “5”, “6”, “7”, “8”, “9”, “12”, “24”, “36”,”48”,”60”}
PeriodUnit String いいえ month

有効期間の単位,すなわち、パラメータ Period の単位。値の範囲:

  • Month(デフォルト)
ClientToken String いいえ 155780923770 084 104 105 115 073 115 084 104 101 070 105 114 115 116 082 101 113 117 101 115 116

リクエストのべき等性を保証します。値はクライアントによって生成され、グローバルに一意である必要があります。 ClientToken は ASCII 文字のみ使用できます。最大 64 ASCII 文字を含めることができます。詳細は、 べき等性の保証方法 をご参照ください。

レスポンスパラメータ

名前 データ型
OrderId String 10111111111xxxxx

生成された注文の ID。

RequestId String 473469C7-AA6F-4DC5-B3DB-A3DC0DE3C83E

リクエストの ID。

リクエストの例


https://ecs.aliyuncs.com/?Action=ModifyInstanceChargeType
&RegionId=cn-hangzhou
&InstanceIds=["i-xxxxx1","i-xxxxx2"]
&Period=1
&PeriodUnit=Month
&AutoPay=false
&IncludeAllDisks=true
&ClientToken=xxxxxxxxxxxxxx
&<Common Request Parameters>
			

通常レスポンスの例

XML 形式

<ModifyInstanceChargeTypeResponse>
  <RequestId>04F0F334-1335-436C-A1D7-6C044FExxxxx</RequestId>
  <OrderId>10111111111xxxxx</OrderId>
</ModifyInstanceChargeTypeResponse>
			

JSON 形式

{
	"OrderId":"10111111111xxxxx",
	"RequestId":"04F0F334-1335-436C-A1D7-6C044FExxxxx"
}

エラーコード

HttpCode エラーコード エラーメッセージ 説明
400 InvalidParameter.InstanceIds The specified InstanceIds are invalid. 指定されたインスタンスは無効です。
400 InvalidParameter %s パラメータの形式が正しくありません。
400 InvalidStatus.ValueNotSupported %s インスタンスは「実行中」または「停止済み」である必要があります。
400 InvalidInstanceChargeType.ValueNotSupported %s 課金方法の値が正しくありません。
403 InvalidInstance.TempBandwidthUpgrade Cannot switch to Pay-As-You-Go during the period of temporary bandwidth upgrade. 一時的な帯域幅のアップグレード中は、従量課金制に切り替えることはできません。
400 InvalidInternetChargeType.ValueNotSupported %s パラメータが無効です。
403 InvalidInstanceType.ValueNotSupported The specified InstanceType does not exist or beyond the permitted range. 指定されたインスタンスタイプが存在しないか、仕様の範囲を超えています。
403 InstanceType.Offline %s インスタンスの仕様を使用できません。
500 InternalError The request processing has failed due to some unknown error, exception or failure. 未知のエラーが発生しました。
400 ReleaseTimeHaveBeenSet The specified instance has been set released time. 指定されたインスタンスはリリース時刻を設定済みです。
403 InvalidAccountStatus.NotEnoughBalance Your account does not have enough balance. アカウントの残高が不足しています。
403 Account.Arrearage Your account has an outstanding payment. アカウントには未支払い項目があります。
403 InvalidParameter.NotMatch %s パラメータが一致しません。
403 InvalidAction %s 操作が無効です。
400 Throttling %s リクエストがフロー制御されています。
400 InvalidParameter.Bandwidth %s パラメータが無効です。
400 InvalidPeriod.UnitMismatch The specified Period must be correlated with the PeriodUnit. 指定された期間は PeriodUnit と関連しなければなりません。
400 InvalidImageType.NotSupported %s 指定されたイメージタイプが無効です。
400 InvalidPeriod.ExceededDedicatedHost Instance expired date can't exceed dedicated host expired date. インスタンスの有効期限は、DDH の有効期限を超えることはできません。
400 InvalidMarketImageChargeType.NotSupport The specified chargeType of marketImage is unsupported. クラウドマーケットの課金方法が無効です。
403 ImageNotSupportInstanceType The specified instanceType is not supported by instance with marketplace image. 指定されたマーケットイメージは、インスタンスタイプをサポートしていません。
403 InvalidInstanceType.PhasedOut This instanceType is no longer offered. このインスタンスタイプは提供されなくなりました。
400 InvalidSystemDiskCategory.ValueNotSupported %s パラメータがサポートされません。

API エラーコードリスト