调用ModifyDBInstancePayType接口变更RDS实例的付费类型。

仅支持从按量付费(即后付费)变更为包年包月(即预付费),不支持从包年包月变更为按量付费。

  • 按量付费适合短期需求,用完可立即释放实例,节省费用。
  • 包年包月适合长期需求,价格比按量付费更实惠,且购买时长越长,折扣越多。

调用该接口时,实例必须满足以下条件,否则将操作失败:

  • 实例付费类型为按量付费。
  • 实例状态为运行中。
  • 实例没有未完成的变更付费类型的订单。
  • 实例规格不能为历史规格,请先将历史规格的按量付费实例升级规格后再调用本接口。详情请参见主实例规格表变更配置

调试

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

请求参数

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

系统规定参数,取值:ModifyDBInstancePayType

DBInstanceId String rm-uf6wjk5xxxxxx

实例ID。

PayType String Prepaid

付费类型。仅支持按量付费变更为包年包月 ,唯一取值:Prepaid

Period String Year

指定实例为包年或者包月类型,取值:

  • Year :包年
  • Month :包月
UsedTime Integer 2

指定购买时长,取值:

  • 当参数Period=Year 时,取值为 1~3
  • 当参数Period=Month时,取值为 1~9

返回数据

名称 类型 示例值 描述
OrderId Long 205395023430728

订单ID。

示例

请求示例

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

正常返回示例

XML 格式

<ModifyDBInstancePayTypeResponse>
  <RequestId>E8C56392-C175-4731-A7F3-9BFA0C77D96F</RequestId>
  <OrderId>205395023430728</OrderId>
</ModifyDBInstancePayTypeResponse>

JSON 格式

{
	"RequestId": "E8C56392-C175-4731-A7F3-9BFA0C77D96F",
	"OrderId": 205395023430728
}

错误码

HttpCode 错误码 错误信息 描述
400 InvalidPaymentMethod.Missing No payment method is specified for your account. We recommend that you add a payment method. 您的账户暂无有效支付方式,请添加支付方式

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