この 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 |
更新を有効にするかどうかを指定します。 設定可能な値:
デフォルト値は、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)」をご参照ください。