1 つ以上のインスタンスの課金方法を切り替えます。このインターフェイスを使用して、従量課金とサブスクリプション間で課金方法を変更できます。さらに、インスタンスにマウントされているすべての従量課金クラウドディスクをサブスクリプションクラウドディスクに変更できます。
説明
このインターフェイスを呼び出す前に、 ECS の課金方法や定価などを予めご了承ください。
このインターフェイスを呼び出すときは、次の点にご注意ください:
-
対象のインスタンスが
実行中 (
Running
)または 停止中 (Stopped
)ステータスの場合と、お支払いアカウントの残高が十分な場合にのみ、課金方法を変更できます。 -
デフォルトでは、システムは最新の課金方法を使用して自動的に料金を請求します。アカウントの残高が十分にあることを確認します。そうでない場合、システムは注文を例外とみなすため、注文をキャンセルしなければなりません。アカウントの残高が不十分な場合は、
AutoPay
をfalse
に設定します、システムは通常の未払いの注文を生成します。 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 を無視します。値の範囲:
|
DryRun | Boolean | いいえ | false |
システムが権限チェックのみ実行するかどうか。
|
IncludeDataDisks | Boolean | いいえ | true |
インスタンスにマウントされているすべての従量課金データディスクを、サブスクリプションディスクに変更するかどうか。デフォルト値は true です。 |
InstanceChargeType | String | いいえ | PrePaid |
対象の課金方法、値の範囲:
|
OwnerAccount | String | いいえ | EcsforCloud@Alibaba.com |
RAM ユーザーのアカウント名。 |
Period | Integer | いいえ | 2 |
インスタンスライフサイクル。DedicatedHostId を指定すると、値の範囲は DDH の有効期間を超えることはできません。値の範囲:
|
PeriodUnit | String | いいえ | 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 | パラメータがサポートされません。 |