调用TransformToPrePaid将按量付费的Redis实例转换为包年包月(预付费)实例。
该API对应的控制台操作请参见转包年包月。
说明 包年包月实例暂不支持转换为按量付费实例。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
请求参数
| 名称 | 类型 | 是否必选 | 示例值 | 描述 |
|---|---|---|---|---|
| Action | String | 是 | TransformToPrePaid | 系统规定参数,取值:TransformToPrePaid。 |
| InstanceId | String | 是 | r-bp1zxszhcgatnx**** | 实例ID,可调用DescribeInstances获取。 |
| Period | Long | 是 | 12 | 预付费时长,单位为月。取值:1~9、12、24、36。 |
| AutoPay | Boolean | 否 | true | 是否自动付款,取值:
说明 取值为
false时,请于实例即将到期前,通过控制台手动续费,详情请参见
手动续费。
|
| RegionId | String | 否 | cn-hangzhou | 地域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-bp1zxszhcgatnx**** &Period=12 &<公共请求参数>
正常返回示例
XML格式
<TransformToPrePaidResponse>
<OrderId>111111111111111</OrderId>
<RequestId>426F1356-B6EF-4DAD-A1C3-DE53B9DAF586</RequestId>
<EndTime>2019-01-18T16:00:00Z</EndTime>
</TransformToPrePaidResponse>
JSON格式
{
"OrderId": "111111111111111",
"RequestId": "426F1356-B6EF-4DAD-A1C3-DE53B9DAF586",
"EndTime": "2019-01-18T16:00:00Z"
}
错误码
| HttpCode | 错误码 | 错误信息 | 描述 |
|---|---|---|---|
| 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 | Your account does not have enough balance. | 账户余额不足,请先充值再操作。 |
| 403 | RealNameAuthenticationError | Your account has not passed the real-name authentication yet. | 您的帐户还没有通过实名认证。 |
访问错误中心查看更多错误码。