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

ECS インスタンスの支払い方法を変更します。バッチ変更に対応しています。

操作説明

事前準備

サブスクリプション、従量課金、およびその他の支払い方法と、Elastic Compute Service (ECS) の料金について十分に理解していることを確認してください。
対象インスタンスが 実行中 (Running) または停止 (Stopped) 状態であり、アカウントに支払い遅延がないことを確認してください。
支払い方法の変更後、デフォルトで自動支払いが有効になります。アカウントの残高が十分であることを確認してください。残高が不足している場合、異常な注文が生成され、その注文をキャンセルすることしかできません。アカウントの残高が不足している場合は、AutoPay パラメーターを false に設定できます。この場合、未払いの注文が生成され、ECS コンソールにログインして支払いを完了できます。

注意事項

サブスクリプションから従量課金への変更:
サブスクリプションインスタンスを従量課金インスタンスに変更する場合、新しい支払い方法はインスタンスのライフサイクル全体に適用されます。差額分の返金を受け取ることができ、元の支払方法に返金されます。引き換え済みのバウチャーは返金対象外です。
- 返金ルール: 1 か月以内に自由に使用できる返金額には上限があり、繰り越しはできません。返金クォータを使い切った場合、翌月まで支払い方法の切り替えはできません。1 回の支払い方法の切り替えで消費される返金クォータは、次の数式で計算されます。vCPU 数 × (返金日数 × 24 ± 変動時間)。詳細については、「サブスクリプションから従量課金への支払い方法の変更」を参照してください。
従量課金からサブスクリプションへの変更:
- インスタンスにアタッチされているすべての従量課金データディスクを、同時にサブスクリプションデータディスクに変更できます。
- 従量課金インスタンスにリリース時間がセットされている場合、この操作の呼び出しはできません。詳細については、「サブスクリプションから従量課金への支払い方法の変更」を参照してください。
- インスタンスが節約モードの場合は、先にインスタンスを起動してください。

今すぐお試しください

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

update

*インスタンス。

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

なし

リクエストパラメーター

パラメーター	型	必須 / 任意	説明	例
InstanceIds	string	必須	インスタンスの ID。値は、最大 20 個のインスタンス ID で構成される JSON 配列で指定できます。ID はコンマ (,) で区切ります。	["i-bp67acfmxazb4p**","i-bp67acfmxazb4d**"]
RegionId	string	必須	インスタンスのリージョン ID。 DescribeRegions を呼び出して、最新のリージョンリストを照会できます。	cn-hangzhou
Period	integer	任意	サブスクリプションの更新期間。ECS インスタンスが専用ホストでホストされている場合、値は専用ホストのサブスクリプション期間を超えることはできません。有効な値: PeriodUnit が Month に設定されている場合、Period の有効な値は 1、2、3、4、5、6、7、8、9、12 です。	1
PeriodUnit	string	任意	更新期間の単位。Period パラメーターの単位です。有効な値: Month デフォルト値: Month。	Month
IncludeDataDisks	boolean	任意	インスタンスにアタッチされているすべての従量課金データディスクをサブスクリプションデータディスクに変更するかどうかを指定します。 true: はい。 false: いいえ。デフォルト値: false。	false
DryRun	boolean	任意	ドライランのみを実行するかどうかを指定します。有効な値: true: ドライランのみを実行します。システムは、AccessKey ペアが有効かどうか、Resource Access Management (RAM) ユーザーに必須の権限付与があるかどうか、および必要なパラメーターが指定されているかどうかをチェックします。リクエストがドライランに失敗した場合、対応するエラーが返されます。リクエストがドライランに成功した場合、DryRunOperation エラーコードが返されます。 false: ドライランを実行し、通常のリクエストを送信します。リクエストがドライランに成功した場合、2xx HTTP 状態コードが返され、操作が実行されます。デフォルト値: false。	false
AutoPay	boolean	任意	自動支払いを有効にするかどうかを指定します。有効な値: true: 自動支払いを有効にします。アカウントの残高が十分であることを確認してください。アカウントの残高が不足している場合、異常な注文が生成され、その注文をキャンセルすることしかできません。 false: 課金せずに注文を生成します。デフォルト値: true。説明支払い方法の残高が不足している場合は、AutoPay を false に設定できます。この場合、未払いの注文が生成され、ECS コンソールにログインして支払いを完了できます。	false
InstanceChargeType	string	任意	インスタンスの変更後の支払い方法。有効な値: PrePaid: 従量課金インスタンスをサブスクリプションインスタンスに変更します。 PostPaid: サブスクリプションインスタンスを従量課金インスタンスに変更します。デフォルト値: PrePaid。	PrePaid
ClientToken	string	任意	リクエストのべき等性を確保するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、異なるリクエスト間でトークンが一意であることを確認してください。ClientToken 値には ASCII 文字のみを使用でき、長さは 64 文字を超えることはできません。詳細については、「べき等性を確保する方法」を参照してください。	123e4567-e89b-12d3-a456-426655440000
IsDetailFee	boolean	任意	サブスクリプションから従量課金の支払い方法への変更時に、注文料金の詳細を返すかどうかを指定します。有効な値: true: はい。 false: いいえ。デフォルト値: false。	false

レスポンスフィールド

フィールド	型	説明	例
	object
FeeOfInstances	object
FeeOfInstance	array<object>	注文料金の詳細。
	object
Currency	string	請求書の通貨単位。中国サイト: CNY。国際サイト: USD。	CNY
Fee	string	料金金額。	0
InstanceId	string	インスタンス ID	i-bp67acfmxazb4p****
OrderId	string	注文 ID。このパラメーターは、支払い方法がサブスクリプションに変更された場合にのみ返されます。	20413515388****
RequestId	string	リクエスト ID	B61C08E5-403A-46A2-96C1-F7B1216DB10C

例

成功レスポンス

JSONJSON

{
  "FeeOfInstances": {
    "FeeOfInstance": [
      {
        "Currency": "CNY",
        "Fee": "0",
        "InstanceId": "i-bp67acfmxazb4p****"
      }
    ]
  },
  "OrderId": "20413515388****",
  "RequestId": "B61C08E5-403A-46A2-96C1-F7B1216DB10C"
}

エラーコード

HTTP ステータスコード	エラーコード	エラーメッセージ	説明
400	InvalidInstance.UnpaidOrder	%s
400	Throttling	Request was denied due to request throttling, try again later.	リクエストがスロットルされました。
400	InstanceHasProcessingConvertOrder	%s
400	InvalidParameter.InstanceIds	The specified InstanceIds are invalid.	指定されたインスタンスが無効です。
400	InvalidParameter	%s	現在のリクエストパラメーターが無効です。もう一度お試しください。
400	InvalidStatus.ValueNotSupported	%s	指定されたディスクステータスでは、この操作はサポートされていません。
400	InvalidInstanceChargeType.ValueNotSupported	%s	指定されたインスタンスの支払い方法が存在しません。
400	InvalidSpotStrategy	The specified spotStrategy is not valid.	指定された SpotStrategy パラメーターのレートが無効です。
400	ExpiredInstance	The specified instance has expired.	指定されたインスタンスは有効期限切れです。
400	InstancesIdQuotaExceed	The maximum number of Instances is exceeded.
400	InvalidClientToken.ValueNotSupported	The ClientToken provided is invalid.	指定された ClientToken が無効です。
400	InvalidInternetChargeType.ValueNotSupported	%s	指定されたネットワーク課金メソッドが無効です。
400	ReleaseTimeHaveBeenSet	The specified instance has been set released time.	指定されたインスタンスには、すでにリリーススケジュール時刻が設定されています。
400	QuotaExceed.AfterpayInstance	The maximum number of Pay-As-You-Go instances is exceeded: %s.
400	InvalidParameter.Bandwidth	%s	帯域幅パラメーターが無効です。
400	QuotaExceed.RufundVcpu	The maximum number of refund vcpu is exceeded: %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.
400	InvalidMarketImageChargeType.NotSupport	The specified chargeType of marketImage is unsupported.	指定された Alibaba Cloud マーケットプレイスイメージの課金メソッドはサポートされていません。
400	InvalidSystemDiskCategory.ValueNotSupported	%s	指定された SystemDisk.Size が有効ではありません。
400	InvalidAccountStatus.PayAmountLimitExceeded	Your account is being restricted, due to no default payment method is set or you has not being authorized.
400	InvalidInstance.NotFoundSystemDisk	The specified instance has no system disk.	指定されたインスタンスにシステムディスクがアタッチされていません。指定されたインスタンスにシステムディスクがアタッチされていることを確認してください。DescribeInstances を呼び出して、指定されたインスタンスの情報をクエリできます。
400	AccountForbidden.ProductCreationLimited	The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.	エンタープライズクラウド移行のお客様は、従量課金制の ECS インスタンスのみを購入でき、Alibaba Cloud Marketplace が提供するイメージなどのサードパーティプロダクトは購入できません。パラメーターを確認し、有効なパラメーターでリトライしてください。
400	Invalid.PrivatePoolOptions.MatchCriteria	Target mode does not support this operation.	指定された PrivatePoolOptions.MatchCriteria パラメーターが非公開プールと一致しません。
400	InvalidPeriod	The specified period is not valid.	指定された期間が無効です。
400	DISK_IN_DEDICATED_BLOCK_STORAGE_CLUSTER	The disk in dedicated block storage cluster is not allowed to do this operation.
400	NoPermission.Price	The operation requires price permission. Please either apply for permission from your main account, or set the parameter AutoPay as true.	この操作には課金関連の権限が必要です。Alibaba Cloud アカウントから権限を申請するか、AutoPay パラメーターを true に設定して自動支払いを行ってください。
400	NoPermission.Refund	The operation requires refund permission. Please apply for permission from your main account.	アカウントに返金を実行する権限がありません。プライマリアカウントが返金関連のフォーム権限を付与する必要があります。
400	QuotaExceeded.InternetBandwidth	%s.	アカウント配下の従量課金 ECS インスタンスの帯域幅課金パブリック帯域幅の合計が、帯域幅クォータ制限を超えています。
400	DiskExpiredOrInArrears	Your account has an overdue payment for the specified instance.	指定されたインスタンスで支払い遅延が発生しています。
400	LastTokenProcessing	The last token request is processing	前のトークンリクエストがまだ処理中です。後でもう一度お試しください。
500	InternalError	The request processing has failed due to some unknown error, exception or failure.	内部エラーが発生しました。もう一度お試しください。
500	InvalidInstanceType.ValueUnauthorized	The specified InstanceType is not authorized.
500	InvalidOperation.RefundFailed	Failed to refund. Please try again or submit a support ticket.	返金が失敗しました。
403	InvalidInstance.TempBandwidthUpgrade	Cannot switch to Pay-As-You-Go during the period of temporary bandwidth upgrade.	一時的な帯域幅スペックアップ中は、インスタンスを従量課金制に変換できません。
403	InvalidInstanceType.ValueNotSupported	The specified InstanceType does not exist or beyond the permitted range.
403	InstanceType.Offline	%s	指定されたインスタンスタイプは廃止されました。別のインスタンスタイプを選択してください。
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
403	QuotaExceed.PostPaidDisk	Living postPaid disks quota exceeded.	従量課金ディスクの数が許可されたクォータを超えました。
403	ImageNotSupportInstanceType	The specified instanceType is not supported by instance with marketplace image.	指定されたイメージはこのインスタンスタイプをサポートしていません。
403	InvalidInstanceType.PhasedOut	This instanceType is no longer offered.	指定されたインスタンスタイプは廃止されており、販売を終了しています。
403	InvalidPeriod.ExceededDedicatedHost	Instance expired date can't exceed dedicated host expired date.
403	RealNameAuthenticationError	Your account has not passed the real-name authentication yet.	Alibaba Cloud アカウントの実名登録が完了していません。この操作を実行する前に実名登録を完了してください。
403	InvalidOperation.NotSupport	Instance on dedicated host not support modify charge type.
403	QuotaExceed.ElasticQuota	No additional quota is available for the specified ECS instance type.	現在のリージョンで選択したインスタンスタイプで作成されるインスタンスの数がクォータを超えているか、またはすべてのインスタンスタイプの合計 vCPU クォータを超えました。ECS コンソールまたはクォータセンターにアクセスしてクォータの引き上げをリクエストできます。
403	PeriodNotSupported.InstanceOnManagedPrivateSpace	The instance on ManagedPrivateSpace is not supported to modify chargeType.
403	UnsupportedIspChargeType	%s	指定された支払い方法では Isp パラメーターはサポートされていません。
403	InvalidOperation.StoppedModeUnsupported	The specified instance is StopCharging.	節約モードのインスタンスは操作できません。
404	InvalidInstanceId.NotFound	The specified instanceId does not exist.

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

変更履歴

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