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

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

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

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

调试

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

请求参数

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

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

ClientToken String 否 ETnLKlblzczshOTUbOCzxxxxxxxxxx

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

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

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

  • 1~9
  • 12
  • 24
  • 36
  • 48
  • 60
AutoPay String 否 True

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

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

实例是否自动续费，取值：

  • true：是
  • 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格式 

HTTP/1.1 200 OK
Content-Type:application/xml

<?xml version="1.0" encoding="UTF-8" ?>
<RenewInstanceResponse>
	<OrderId>20286717xxxxx</OrderId>
	<RequestId>E10319A3-B96A-46B0-81CE-D610DC891409</RequestId></RenewInstanceResponse>

JSON格式 

HTTP/1.1 200 OK
Content-Type:application/json

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

错误码

HttpCode 错误码 错误信息 描述
400 SYSTEM.CONCURRENT_OPERATE Concurrent operation is detected. 系统中存在并发操作。
400 ArrearageOrderExists Your account has an outstanding balance. 请先充值结清账单后再购买。

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