调用TransformToPrePaid接口将按量付费的MongoDB实例转换为包年包月（预付费）实例。

请确保在使用该接口前，已充分了解云数据库MongoDB产品的收费方式和价格。
说明 包年包月的实例无法转换为按量付费的实例，为避免浪费您的资源，请谨慎操作。

调用本接口时，实例必须满足以下条件：

  • 实例状态为运行中。
  • 实例的计费类型为按量付费。
  • 实例没有未完成支付的转包年包月订单。
  • 实例规格不能为历史规格（不再售卖的规格），历史规格列表请参见实例规格表。
    说明 如需将历史规格实例转变为包年包月，请先调用ModifyDBInstanceSpec或ModifyNodeSpec接口变更实例规格。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 TransformToPrePaid

要执行的操作，取值：TransformToPrePaid。

Period Long 是 1

预付费时长，单位为月。取值范围为1-9、12、24、36。

InstanceId String 是 dds-bpxxxxxxxx

实例ID。
AutoPay Boolean 否 true

是否自动支付订单，取值：

说明 默认值为true。
FromApp String 否 OpenApi

请求来源，取值：

  • OpenApi：请求来源为OpenAPI。
  • mongo_buy：请求来源为控制台。
说明 默认值为OpenApi。
BusinessInfo String 否 {“ActivityId":"000000000"}

附加参数，业务信息。
AutoRenew String 否 true

到期后是否自动续费，取值：

  • true：自动续费。
  • false：手动续费。
说明 默认值为false。
CouponNo String 否 youhuiquan_promotion_option_id_for_blank

优惠码，默认为：youhuiquan_promotion_option_id_for_blank。

RegionId String 否 cn-hangzhou

实例所属的地域ID，您可以调用DescribeDBInstanceAttribute接口查询。

返回数据

名称 类型 示例值 描述
RequestId String EFD65226-08CC-4C4D-B6A4-CB3C382F67B0

请求ID。
OrderId String 2043xxxxxxxx

订单ID。

示例

请求示例

http(s)://mongodb.aliyuncs.com/?Action=TransformToPrePaid
&Period=1
&InstanceId=dds-bpxxxxxxxx
&<公共请求参数>

正常返回示例

XML 格式 

<TransformToPrePaidResponse>
	  <OrderId>2043xxxxxxxx</OrderId>
	  <RequestId>EFD65226-08CC-4C4D-B6A4-CB3C382F67B0</RequestId>
</TransformToPrePaidResponse>

JSON 格式 

{
	"OrderId": "2043xxxxxxxx",
	"RequestId": "EFD65226-08CC-4C4D-B6A4-CB3C382F67B0"
}

错误码

HttpCode 错误码 错误信息 描述
400 InsufficientBalance Your account does not have enough balance. 余额不足，请您先充值后再试。
403 RealNameAuthenticationError Your account has not passed the real-name authentication yet. 用户未进行实名认证，请您先进行实名认证后再试。

访问错误中心查看更多错误码。