You can call this operation to renew an RDS instance.

Before performing this operation, make sure that you fully understand the billing methods and pricing of RDS.

The instance must meet the following requirements:

  • The billing method of the instance is Subscription.
  • Your Alibaba Cloud account has sufficient balance or has been bound to a credit card.
Note Coupons under your account will be preferentially used during payment.

Debugging

You can use API Explorer to perform debugging.

API Explorer provides various functions to simplify API usage. For example, you can search APIs, call APIs, and generate SDK sample code.

Request parameters

Parameter Type Required Example Description
Action String Yes RenewInstance

The operation that you want to perform. Set the value to RenewInstance.

DBInstanceId String Yes rm-uf6wjk5xxxxxxxxxx

The ID of the instance.

Period String Yes 12

The renewal period. Unit: months. Valid values:

  • 1 to 9
  • 12
  • 24
  • 36
  • 48
  • 60
ClientToken String No ETnLKlblzczshOTUbOCzxxxxxxxxxx

The client token that is used to ensure the idempotency of requests. The parameter value is generated by the client and is unique among different requests, which is a string of up to 64 ASCII characters.

AutoPay String No True

Indicates whether automatic payment is enabled. Valid values:

  • True: Automatic payment is enabled. Make sure that your account has sufficient balance.
  • False: Automatic payment is disabled. You need to pay on the console as follows: Log on to the console. In the upper-right corner, choose Billing Management > Billing Management. On the Billing Management page, choose Bills. On the Unpaid tab, click Make a Payment in the Actions column.

Default value: false

AccessKeyId String No LTAIfCxxxxxxxxxx

The AccessKey ID issued by Alibaba Cloud for users to access services.

Response parameters

Parameter Type Example Description
OrderId Long 201815745430941

The ID of the order.

RequestId String 1AD222E9-E606-4A42-BF6D-8A4442913CEF

The ID of the request.

Examples

Request example

http(s)://rds.aliyuncs.com/?Action=RenewInstance
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx 
&Period=12 
&<Common request parameters>

Normal response examples

XML format

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

JSON format

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

Error codes

View error codes