调用RenewInstance接口对RDS实例进行手动续费。

请确保在使用该接口前,已充分了解RDS产品的收费方式和价格

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

  • 该接口仅支持续费包年包月的RDS实例;
  • 您的账号必须支持账号余额支付或信用支付。
    说明 付款时,默认优先使用您账号下可用的优惠券。

调试

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

请求参数

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

系统规定参数。取值:RenewInstance

DBInstanceId String rm-uf6wjk5xxxxxxxxxx

需要续费的实例ID。

Period String 12

预付费续费时长,单位:月。取值:

  • 1~9
  • 12
  • 24
  • 36
  • 48
  • 60
ClientToken String ETnLKlblzczshOTUbOCzxxxxxxxxxx

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

AutoPay String True

续费时是否自动付费。取值:

  • True:自动付费。请确保账号有足够的余额。
  • False:控制台手动付费。具体操作为:登录控制台,在右上角选择费用>进入费用中心,在订单管理找到目标订单进行支付。

默认值:False

返回数据

名称 类型 示例值 描述
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求ID。

OrderId Long 201815745430941

订单ID。

示例

请求示例

http(s)://rds.aliyuncs.com/?Action=RenewInstance
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&Period=12
&<公共请求参数>

正常返回示例

XML 格式

<RenewInstanceResponse>
	  <OrderId>20286717xxxxx</OrderId>
	  <RequestId>E10319A3-B96A-46B0-81CE-D610DC891409</RequestId></RenewInstanceResponse>

JSON 格式

{
    "OrderId": "20286717xxxxx",
    "RequestId": "E10319A3-B96A-46B0-81CE-D610DC891409"
}

错误码

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