将按量付费的MongoDB实例转换为包年包月(预付费)实例。
接口说明
请确保在使用该接口前,已充分了解 MongoDB 产品的收费方式和和和价格。
包年包月的实例无法转换为按量付费的实例,为避免浪费您的资源,请谨慎操作。
调用本接口时,实例必须满足以下条件:
实例状态为运行中。
实例的计费类型为按量付费。
实例没有未完成支付的转包年包月订单。
实例规格不能为历史规格(不再售卖的规格),历史规格列表请参见实例规格表。
如需将历史规格实例转变为包年包月,请先调用 ModifyDBInstanceSpec 或 ModifyNodeSpec 接口变更实例规格。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
dds:TransformToPrePaid |
update |
*Instance
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| InstanceId |
string |
是 |
实例 ID。 |
dds-bp1366caac83**** |
| Period |
integer |
是 |
预付费时长,单位为月。取值范围为 1~9、12、24、36。 |
1 |
| AutoPay |
boolean |
否 |
是否自动支付订单,取值:
说明
默认值为 true。 |
true |
| BusinessInfo |
string |
否 |
附加参数,业务信息。 |
{“ActivityId":"000000000"} |
| AutoRenew |
string |
否 |
到期后是否自动续费,取值:
说明
默认值为 false。 |
true |
| CouponNo |
string |
否 |
是否使用优惠券,取值说明:
|
default |
| ClientToken |
string |
否 |
用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过 64 个 ASCII 字符,且该参数值中不能包含非 ASCII 字符。 |
qwertyui1234567 |
| DryRun |
boolean |
否 |
是否对本次请求执行预检查,取值: true:执行预检查,不真正调用该接口。检查项包含请求参数、请求格式、业务限制和库存等。如果检查不通过,则返回对应错误;如果检查通过,则返回错误码 DryRunOperation。 false(默认):发送正常请求,通过检查后直接执行本次操作。 |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
|||
| OrderId |
string |
订单 ID。 |
21022019252**** |
| RequestId |
string |
请求 ID。 |
2F42BB4E-461F-5B55-A37C-53B1141C**** |
示例
正常返回示例
JSON格式
{
"OrderId": "21022019252****",
"RequestId": "2F42BB4E-461F-5B55-A37C-53B1141C****"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | MissingParameter | Period is mandatory for this action. | |
| 400 | InvalidParam | Period is invalid | |
| 400 | ResourceNotAvailable | Resource you requested is not available for finance user. | |
| 400 | InsufficientBalance | Your account does not have enough balance. | 支付失败,您可以添加其他支付方式,也可以充值后重试。 |
| 403 | AlreadyPrePaid | This instance is already prepaid | 该实例已经是预付费 |
| 403 | RealNameAuthenticationError | Your account has not passed the real-name authentication yet. | 阿里云账号未进行实名认证,请进行实名认证后重试。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。