调用TransformDBInstancePayType接口变更RDS实例的计费方式。

说明
  • 包年包月变更为按量付费时,会扣除手续费后退还余款。详情请参见包年包月转按量付费
  • 账号余额不足时无法按量付费转包年包月。
  • 不支持存在未完成变配订单的实例。
  • 不支持专属集群。

RDS实例支持包年包月和按量付费两种计费方式:

  • 包年包月:也称为预付费,即在新建实例时支付费用。适合长期需求,价格比按量付费更实惠,且购买时长越长,折扣越多。
  • 按量付费:也称为后付费,即每小时生成一个收费订单,并按照生成订单时的实例规格从阿里云账号扣费。适合短期需求,用完可立即释放实例,节省费用。

更多计费方式的介绍请参见价格、收费项与计费方式

调试

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

请求参数

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

系统规定参数。取值:TransformDBInstancePayType

DBInstanceId String rm-uf6wjk5xxxxxx

实例ID。

PayType String Prepaid

实例的付费类型。取值:

  • Postpaid:后付费(按量付费)
  • Prepaid:预付费(包年包月)
ClientToken String ETnLKlblzczshOTUbOCzxxxxxxxxxx

用于保证请求的幂等性,防止重复提交请求。由客户端生成该参数值,要保证在不同请求间唯一,最大值不超过64个ASCII字符,且该参数值中不能包含非ASCII字符。

UsedTime Integer 1

指定购买时长。取值:

  • 当参数PeriodYear时,UsedTime取值为1~5
  • 当参数PeriodMonth时,UsedTime取值为1~9
说明PayType=Prepaid,需要传入该参数。
Period String Month

指定预付费实例为包年或者包月类型。取值:

  • Year:包年
  • Month:包月
说明PayType=Prepaid,需要传入该参数。
BusinessInfo String

业务扩展参数。

返回数据

名称 类型 示例值 描述
ChargeType String Prepaid

付费类型。

DBInstanceId String rm-uf6wjk5xxxxxx

实例ID。

ExpiredTime String 2020-04-20T10:00:00Z

到期时间。

说明 如果变更为按量付费,该参数不返回。
OrderId Long 205157600280623

订单ID。

RequestId String 5E6E09DE-5B12-4BFF-A55E-1C86EDE06D9A

请求ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=TransformDBInstancePayType
&DBInstanceId=rm-uf6wjk5xxxxxx
&PayType=Prepaid
&UsedTime=3
&Period=Month
&<公共请求参数>

正常返回示例

XML 格式

<TransformDBInstancePayTypeResponse>
  <ChargeType>Prepaid</ChargeType>
  <DBInstanceId>rm-uf6wjk5xxxxxx</DBInstanceId>
  <ExpiredTime>2020-04-20T10:00:00Z</ExpiredTime>
  <OrderId>205157600280623</OrderId>
  <RequestId>5E6E09DE-5B12-4BFF-A55E-1C86EDE06D9A</RequestId>
</TransformDBInstancePayTypeResponse>

JSON 格式

{
    "ChargeType":"Prepaid",
    "DBInstanceId":"rm-uf6wjk5xxxxxx",
    "ExpiredTime":"2020-04-20T10:00:00Z",
    "OrderId":205157600280623,
    "RequestId":"5E6E09DE-5B12-4BFF-A55E-1C86EDE06D9A"
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidDBInstanceName.NotFound The specified DB instance name does not exist. 指定DBInstanceId不存在,请检查该参数是否正确。
400 InvalidOrderCharge.NotSupport The specified order charge does not support in RDS. 该订单收费不支持RDS,请提交工单咨询。
400 InvalidOrderTask.NotSupport The Current InstanceId exist Order Task in RDS. 当前实例存在未执行完成的订单,请稍后重试。
400 InvalidPaymentMethod.Incomplete No payment method is specified for your account. We recommend that you add a payment method. 您的账户暂无有效支付方式,请添加支付方式。
400 InvalidOldInstanceType.NotSupport Specified oldInstanceType does not support in RDS. 当前老实例不支持该转换操作
403 OperationDenied.LockMode The operation is not permitted when the instance locked. 实例存于锁定状态

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