Changes the billing method of an ApsaraDB for Redis instance from pay-as-you-go to subscription.
For more information about how to perform the corresponding operation in the console, see Switch to subscription.
Debugging
Request parameters
Parameter | Type | Required | Example | Description |
---|---|---|---|---|
Action | String | Yes | TransformToPrePaid |
The operation that you want to perform. Set the value to TransformToPrePaid. |
InstanceId | String | Yes | r-bp1zxszhcgatnx**** |
The ID of the instance. |
Period | Long | Yes | 12 |
The subscription period of the instance. Unit: months. Valid values: 1 to 9, 12, 24, and 36. |
AutoPay | Boolean | No | true |
Specifies whether to enable automatic renewal. Valid values:
Default value: true. Note If you set this parameter to false, you must manually renew the instance before the instance expires. For more information,
see Manual renewal.
|
RegionId | String | No | cn-hangzhou |
The ID of the region. |
Response parameters
Parameter | Type | Example | Description |
---|---|---|---|
EndTime | String | 2019-01-18T16:00:00Z |
The expiration time of the instance after the billing method was changed from pay-as-you-go to subscription. |
OrderId | String | 111111111111111 |
The ID of the order. |
RequestId | String | 426F1356-B6EF-4DAD-A1C3-DE53B9DAF586 |
The ID of the request. |
Examples
Sample requests
https://r-kvstore.aliyuncs.com/?Action=TransformToPrePaid
&InstanceId=r-bp1zxszhcgatnx****
&Period=12
&<Common request parameters>
Sample success responses
XML
format
<TransformToPrePaidResponse>
<OrderId>111111111111111</OrderId>
<RequestId>426F1356-B6EF-4DAD-A1C3-DE53B9DAF586</RequestId>
<EndTime>2019-01-18T16:00:00Z</EndTime>
</TransformToPrePaidResponse>
JSON
format
{
"OrderId": "111111111111111",
"RequestId": "426F1356-B6EF-4DAD-A1C3-DE53B9DAF586",
"EndTime": "2019-01-18T16:00:00Z"
}
Error codes
HttpCode | Error code | Error message | Description |
---|---|---|---|
400 | MissingParameter | Period is mandatory for this action. | The error message returned because the instance ID is required. |
400 | InvalidParam | Period is invalid | The error message returned because the specified period is invalid. |
403 | AlreadyPrePaid | This instance is already prepaid | The error message returned because this instance is already a subscription instance. |
400 | ResourceNotAvailable | Resource you requested is not available for finance user. | The error message returned because the requested resource is unavailable to a finance user. |
400 | InsufficientBalance | Your account does not have enough balance. | The error message returned because you do not have sufficient account balance. Recharge your account and try it again. |
403 | RealNameAuthenticationError | Your account has not passed the real-name authentication yet. | The error message returned because your account did not pass the real-name verification. |
For a list of error codes, visit the API Error Center.