調用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。

AccessKeyId String 否 LTAIfCxxxxxxxxxx

阿里雲頒發給使用者的訪問服務所用的密鑰ID。

返回資料

名稱 類型 樣本值 描述
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 格式 

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

錯誤碼

訪問錯誤中心查看更多錯誤碼。