この API を呼び出して、ApsaraDB for Redis インスタンスの課金方法を、従量課金からサブスクリプションに変更できます。

コンソールで対応する操作を実行する方法の詳細については、「Switch to subscription」をご参照ください。

現在、インスタンスの課金方法をサブスクリプションから従量課金に変更することはできません。

デバッグ

OpenAPI Explorer を使用すると、署名を手作業で計算することなく、この API を呼び出すことができます。 また、SDK サンプルコードを自動的に生成できます。

リクエストパラメーター

パラメータ タイプ 必須項目 説明
InstanceId String 必須 r-bp1xxxxxxxxxxxxx

課金方法を変更するインスタンスの IDです。

Period Long 必須 12

インスタンスのサブスクリプション期間です。 単位 : 月。 有効な値は 1、2、3、4、5、6、7、8、9、12、24、および36 です。

Action String 任意 TransformToPrePaid

実行するAPI (TransformToPrePaid) を設定します。

RegionId String 任意 cn-hangzhou

リージョンの ID です。

AutoPay Boolean 任意 true

更新を有効にするかどうかを指定します。 設定可能な値:

  • true
  • false

デフォルト値は、false です。

このパラメーターを false に設定する場合は、インスタンスの有効期限期限が経過する前にインスタンスを「手動で更新」します。
AccessKeyId String 任意 Lxxxxxxxxxxxxxxw

サービスにアクセスするために Alibaba Cloud から提供された AccessKey ID です。

応答パラメーター

パラメーター タイプ 説明
EndTime String 2019-01-18T16:00:00Z

課金方法が従量課金からサブスクリプションに変更された後のインスタンスの有効期限です。

OrderId String 111111111111111

注文 ID。

RequestId String 426F1356-B6EF-4DAD-A1C3-DE53B9DAF586

リクエストの ID です。

リクエスト例


https://r-kvstore.aliyuncs.com/
? Action=TransformToPrePaid
&InstanceId=r-bp1xxxxxxxxxxxxx
&Period=12
&<Common request parameters>

通常のレスポンス例

XML 形式

<TransformToPrePaidResponse>
      <OrderId>111111111111111</OrderId>
      <RequestId>426F1356-B6EF-4DAD-A1C3-DE53B9DAF586</RequestId>
      <EndTime>2019-01-18T16:00:00Z</EndTime>
</TransformToPrePaidResponse>

JSON 形式

{
	"RequestId":"426F1356-B6EF-4DAD-A1C3-DE53B9DAF586",
	"OrderId":"111111111111111",
	"EndTime":"2019-01-18T16:00:00Z"
}

Error codes

HTTP ステータスコード エラーコード エラーメッセージ 説明
400 MissingParameter Period is mandatory for this action. インスタンス ID が必須であるために返されるエラーメッセージです。
400 InvalidParam Period is invalid 指定された期間が無効なために返されるエラーメッセージです。
403 AlreadyPrePaid This instance is already prepaid このインスタンスはすでにサブスクリプションインスタンスであるために返されるエラーメッセージです。
400 ResourceNotAvailable Resource you requested is not available for finance user. 要求したリソースが金融ユーザーでは利用できないために返されるエラーメッセージです。
400 InsufficientBalance アカウントの残高が不足しています。 アカウントの残高が十分でない場合に返されるエラーメッセージです。 アカウントの残高を回復後、もう一度お試しください。
403 RealNameAuthenticationError Your account has not passed the real-name authentication yet. アカウントが実名検証に合格しなかったために返されるエラーメッセージです。

詳細については、「エラーコード (Error codes)」をご参照ください。