すべてのプロダクト
Search
ドキュメントセンター

Elastic Compute Service:ModifyInstanceChargeType

最終更新日:Apr 04, 2026

Elastic Compute Service (ECS) インスタンスの支払い方法をバッチで変更します。

操作説明

注意事項

  • この操作を呼び出す前に、ECS のサブスクリプションおよび従量課金の支払い方法と料金をよく理解していることを確認してください。

  • インスタンスは実行中 (Running) または停止済み (Stopped) の状態であり、インスタンスに対する支払い遅延がない必要があります。

  • 支払い方法を変更すると、支払いは自動的に完了します。アカウントの残高が十分であることを確認してください。残高が不足している場合、注文は無効になり、キャンセルされます。アカウントの残高が不足している場合は、AutoPayfalse に設定して未払いの注文を生成できます。その後、ECS コンソールにログインして注文の支払いを行うことができます。

考慮事項

  • 支払い方法をサブスクリプションから従量課金に変更

    • インスタンスの支払い方法をサブスクリプションから従量課金に変更した後、新しい支払い方法はインスタンスの残りのライフサイクル期間中有効です。差額は、使用した支払いアカウントに返金されます。償還済みのクーポンは返金されません。

    • 返金ルール:毎月の返金総額にはクォータがあり、このクォータの未使用残高は翌月に繰り越されません。当月の返金クォータを使い切った場合、支払い方法の変更は翌月以降に可能になります。支払い方法を変更する際の返金額は、次の数式に基づいて計算されます: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

*Instance

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

任意

サブスクリプションインスタンスの更新期間。インスタンスが専用ホストでホストされている場合、インスタンスの更新期間は専用ホストのサブスクリプション期間を超えることはできません。有効値:

PeriodUnit が Month に設定されている場合の有効値: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

任意

リクエストのべき等性を保証するために使用されるクライアントトークン。クライアントを使用してトークンを生成できますが、トークンが異なるリクエスト間で一意であることを確認する必要があります。token は ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。詳細については、「べき等性の確保方法」をご参照ください。

123e4567-e89b-12d3-a456-426655440000

IsDetailFee

boolean

任意

支払い方法がサブスクリプションから従量課金に変更された後、注文の料金詳細を返すかどうかを指定します。有効値:

  • true

  • false

デフォルト値:false。

false

レスポンスフィールド

フィールド

説明

object

OrderId

string

注文 ID。

20413515388****

RequestId

string

リクエスト ID。

B61C08E5-403A-46A2-96C1-F7B1216DB10C

FeeOfInstances

object

FeeOfInstance

array<object>

注文の料金詳細。

object

InstanceId

string

インスタンス ID。

i-bp67acfmxazb4p****

Currency

string

請求書の通貨単位。

Alibaba Cloud 中国サイト (aliyun.com): CNY。

Alibaba Cloud 国際サイト (alibabacloud.com): USD。

CNY

Fee

string

費用額。

0

成功レスポンス

JSONJSON

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

エラーコード

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.
400 ExpiredInstance The specified instance has expired.
400 InstancesIdQuotaExceed The maximum number of Instances is exceeded.
400 InvalidClientToken.ValueNotSupported The ClientToken provided is invalid.
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.
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.
400 InvalidSystemDiskCategory.ValueNotSupported %s
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.
400 AccountForbidden.ProductCreationLimited The commodity must be officially operated by Aliyun and in pay-as-you-go billing method.
400 Invalid.PrivatePoolOptions.MatchCriteria Target mode does not support this operation.
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.
400 NoPermission.Refund The operation requires refund permission. Please apply for permission from your main account.
400 QuotaExceeded.InternetBandwidth %s.
400 DiskExpiredOrInArrears Your account has an overdue payment for the specified instance.
500 InternalError The request processing has failed due to some unknown error, exception or failure.
500 InvalidInstanceType.ValueUnauthorized The specified InstanceType is not authorized.
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.
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.
403 PeriodNotSupported.InstanceOnManagedPrivateSpace The instance on ManagedPrivateSpace is not supported to modify chargeType.
403 UnsupportedIspChargeType %s
403 InvalidOperation.StoppedModeUnsupported The specified instance is StopCharging.
404 InvalidInstanceId.NotFound The specified instanceId does not exist.

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

変更履歴

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