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

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

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

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

调试

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

请求参数

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

要执行的操作,取值:TransformToPrePaid

Period Long 1

预付费时长,单位为月。取值范围为1-9122436

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. 用户未进行实名认证,请您先进行实名认证后再试。

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