TransformDBInstancePayType操作を呼び出して、ApsaraDB RDSインスタンスの課金方法を変更できます。

説明
  • インスタンスの課金方法をサブスクリプションから従量課金に変更すると、払い戻しが行われます。 払い戻し額は、サービス料金の額を差し引いた残りのサブスクリプション料金に等しくなります。 詳細については、「ApsaraDB RDS For MySQLインスタンスをサブスクリプションから従量課金に切り替える」をご参照ください。
  • Alibaba Cloudアカウントの残高が不足している場合、インスタンスの課金方法を従量課金からサブスクリプションに変更することはできません。
  • この操作は、仕様変更の順序が完了していないインスタンスではサポートされません。
  • この操作は、専用クラスターで作成されたインスタンスではサポートされません。

ApsaraDB RDSは、次の2つの課金方法をサポートしています。

  • サブスクリプション: サブスクリプションインスタンスは、前払い料金を支払うインスタンスです。 長期使用の場合、サブスクリプションの課金方法は、従量課金の課金方法よりも費用対効果が高くなります。 サブスクリプション期間が長くなると、低価格が提供されます。
  • 従量課金: 従量課金インスタンスは、リソースの使用量に基づいて1時間ごとに課金されるインスタンスです。 時間ごとの料金は、発注書で指定したインスタンスタイプに基づいて計算され、Alibaba Cloudアカウントの残高から差し引かれます。 短期使用の場合は、従量課金の課金方法を選択することを推奨します。 従量課金インスタンスが不要になった場合は、インスタンスをリリースしてコストを削減できます。

課金方法の詳細については、「料金、請求可能項目、および課金方法」をご参照ください。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目 データ型 必須／任意 例: 説明　
操作 String 必須 TransformDBInstancePayType

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

ClientToken String 任意 ETnLKlblzczshOTUbOCzxxxxxxxxxx

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

DBInstanceId String 必須 rm-uf6wjk5xxxxxx

インスタンスの ID です。

UsedTime Integer いいえ 1

インスタンスのサブスクリプション期間。 有効な値：

  • If you set the Period parameter to Year, the value of the UsedTime parameter ranges from 1 to 5.
  • [期間] パラメーターを [月] に設定した場合、UsedTimeパラメーターの値は1〜9の範囲です。
説明 PayTypeパラメーターを前払いに設定した場合、このパラメーターを指定する必要があります。
PayType String 必須 プリペイド

インスタンスの課金方法です。 有効な値：

  • 後払い: 従量課金
  • プリペイド: サブスクリプション
期間 String 任意 月

インスタンスのサブスクリプションタイプ。 有効な値：

  • 年: 年間サブスクリプション
  • Month: 毎月のサブスクリプション
説明 PayTypeパラメーターを前払いに設定した場合、このパラメーターを指定する必要があります。
BusinessInfo String 任意 なし

インスタンスの拡張ビジネス情報。

AutoRenew String 任意 真実

インスタンスの自動更新を有効にするかどうかを指定します。 有効な値：

  • true: 自動更新が有効です。
  • false: 自動更新は無効です。
説明
  • このパラメーターは、課金方法を従量課金からサブスクリプションに変更した場合にのみ有効です。
  • trueを除くすべての文字列はfalseと見なされます。

レスポンスパラメーター

項目 データ型 例: 説明　
DBInstanceId String rm-uf6wjk5xxxxxx

インスタンスの ID です。

RequestId String 5E6E09DE-5B12-4BFF-A55E-1C86EDE06D9A

リクエストの ID です。

ExpiredTime String 2020-04-20T10:00:00Z

インスタンスの有効期限が切れる時刻。

説明 課金方法をサブスクリプションから従量課金に変更した場合、このパラメーターは返されません。
OrderId Long 205157600280623

注文 ID。

ChargeType String Prepaid

インスタンスの課金方法です。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=TransformDBInstancePayType
&DBInstanceId=rm-uf6wjk5xxxxxx
&PayType=前払い
&UsedTime=3
&期間=月
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式

HTTP/1.1 200 OK
Content-Type:application/xml

<TransformDBInstancePayTypeResponse>
<ChargeType> プリペイド </ChargeType>
<DBInstanceId>rm-uf6wjk5xxxxxx</DBInstanceId>
<ExpiredTime>2020-04-20T10:00:00Z</ExpiredTime>
<OrderId>205157600280623</OrderId>
<RequestId>5E6E09DE-5B12-4BFF-A55E-1C86EDE06D9A</RequestId>
</TransformDBInstancePayTypeResponse>

JSON 形式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "ChargeType" : "プリペイド" 、
  "DBInstanceId" : "rm-uf6wjk5xxxxxx" 、
  "ExpiredTime" : "2020-04-20T10:00:00Z" 、
  "OrderId" : 205157600280623、
  "RequestId" : "5E6E09DE-5B12-4BFF-A55E-1C86EDE06D9A"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 InvalidDBInstanceName.NotFound 指定された DB インスタンス名は存在しません。 インスタンスの名前が見つからない場合に返されるエラーメッセージ。
400 InvalidInstanceUseType.NotSupport 指定されたinstanceUseTypeはRDSでサポートされていません。 インスタンスが子インスタンスである場合に返されるエラーメッセージ。
400 InvalidOrderCharge.NotSupport 指定された注文料金は ​​RDS ではサポートされていません。 PayTypeパラメーターの値が無効な場合に返されるエラーメッセージ。 このパラメーターの有効な値は、前払いと後払いです。 前払いの値はサブスクリプションの課金方法を示し、後払いの値は従量課金の課金方法を示します。
400 InvalidOrderTask.NotSupport 現在のInstanceIdはRDSの注文タスクです。 The error message returned because the instance has orders that are not finished. しばらくしてからもう一度お試しください。
400 IncorrectDBInstanceType Current DB instance type does not support this operation. インスタンスが現在の状態の場合、この操作がサポートされていない場合に返されるエラーメッセージ。
400 IncompleteAccountInfo Your information is incomplete. 操作の前にあなたの情報を完了してください。 アカウント情報が不完全な場合に返されるエラーメッセージ。 アカウントセンターコンソールにログインし、アスタリスク (*) のラベルが付いたすべてのアカウント情報項目を指定します。
400 IncompleteTaxInfo あなたの税情報は不完全です。 操作の前にあなたの情報を完了してください。 税務情報が不完全な場合に返されるエラーメッセージ。 必要なすべての税情報を指定します。
400 InvalidPaymentMethod.Incomplete アカウントの支払い方法は指定されていません。 お支払い方法を追加することを推奨します。 Alibaba Cloudアカウント内で有効な支払い方法が提供されていない場合に返されるエラーメッセージ。 有効な支払い方法を追加して、もう一度お試しください。
400 InvalidPaymentMethod.Missing お支払い方法は不完全です。 お支払い方法を追加することを推奨します。 現在のAlibaba Cloudアカウントで有効な支払い方法が提供されていない場合に返されるエラーメッセージ。 有効な支払い方法を追加して、もう一度お試しください。
400 InsuffcientBalanceOrBankAccount 支払い方法を追加するか、前払い残高に資金を追加します。 インスタンスの作成から始めましょう。 現在のAlibaba Cloudアカウントで有効な支払い方法が提供されていない場合に返されるエラーメッセージ。 有効な支払い方法または資金を追加して、もう一度お試しください。
400 InvalidPaymentMethod.Missing アカウントの支払い方法は指定されていません。 お支払い方法を追加することを推奨します。 Alibaba Cloudアカウント内で有効な支払い方法が提供されていない場合に返されるエラーメッセージ。 有効な支払い方法を追加して、もう一度お試しください。
400 OrderTaskAlreadyExists 注文タスクは既に存在します。 注文が既に存在する場合に返されるエラーメッセージ。
400 InvalidOldInstanceType.NotSupport 指定されたoldInstanceTypeはRDSでサポートされていません。 この操作がデータベースエンジンバージョンのインスタンスでサポートされていない場合に返されるエラーメッセージ。
400 OperationDenied.TimeLimit 2つの変換操作の間隔は15分を超える必要があります。 この操作と前の操作の時間間隔が15分以内の場合に返されるエラーメッセージ。
400 InvalidResource.Format 指定されたパラメーターResourceは無効です。 指定されたリソースが無効な場合に返されるエラーメッセージ。
400 InvalidPayType. フォーマット 指定されたパラメーターPayTypeは無効です。 PayTypeパラメーターの値が無効な場合に返されるエラーメッセージ。
400 InvalidUsedTime. フォーマット 指定されたパラメーターUsedTimeは無効です。 UsedTimeパラメーターが指定されていない場合に返されるエラーメッセージ。
403 OperationDenied.LockMode インスタンスがロックされている場合、操作は許可されません。 インスタンスがロックされている場合に返されるエラーメッセージ。 Alibaba Cloudアカウントの残高が不足している可能性があります。 アカウントに資金を追加してインスタンスのロックを解除し、再試行します。

エラーコードリストについては、「API エラーセンター」をご参照ください。