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

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

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

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

调试

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

请求参数

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

系统规定参数。取值：RenewInstance。

DBInstanceId String 是 rm-uf6wjk5xxxxxxxxxx

需要续费的实例ID。
Period Integer 是 12

预付费续费时长，单位：月。取值：

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

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

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

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

默认值：False。

返回数据

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

订单ID。
RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

请求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"
}

错误码

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