RenewInstance操作を呼び出して、ApsaraDB RDSインスタンスを手動で更新できます。

この操作を呼び出す前に、ApsaraDB RDSの課金方法と料金を理解していることを確認してください。 詳細については、「課金可能なアイテム、課金方法、および料金」をご参照ください。

この API を呼び出す場合、インスタンスは次の要件を満たしている必要があります。

  • インスタンスはサブスクリプションインスタンスです。
  • アカウントは、クレジットカード支払いまたは残高支払いをサポートしています。
    説明 デフォルトでは、アカウントで利用可能なクーポンは優先的に支払いに使用されます。

デバッグ

OpenAPI Explorer は署名値を自動的に計算します。 この操作は、OpenAPI Explorer で呼び出すことを推奨します。 OpenAPI Explorer は、さまざまな SDK に対して操作のサンプルコードを動的に生成します。

リクエストパラメーター

項目データ型必須／任意例:説明　
操作String必須RenewInstance

実行する操作です。 値をRenewInstanceに設定します。

ClientTokenString任意ETnLKlblzczshOTUbOCzxxxxxxxxxx

リクエストのべき等性を保証するために使用されるクライアントトークン。 クライアントを使用して値を生成できますが、生成されたトークンが異なるリクエスト間で一意であることを確認する必要があります。 トークンには ASCII 文字のみを含めることができ、長さは 64 文字を超えることはできません。

DBInstanceIdString必須rm-uf6wjk5xxxxxxxxxx

インスタンスの ID です。

期間Integer〇12

サブスクリプション更新の期間。 単位：月。 有効な値：

  • 1 ~ 9
  • 12
  • 24
  • 36
  • 48
  • 60
AutoPayString任意正しい

更新中に自動支払いを有効にするかどうかを指定します。 有効な値：

  • True: 自動支払いが有効です。 Alibaba Cloudアカウントに十分な残高があることを確認してください。
  • False: 自動支払いは無効です。 コンソールで注文を手動で支払う必要があります。 ApsaraDB RDSコンソールにログインします。 右上隅で、[費用]> [ユーザーセンター] を選択します。 左側のナビゲーションウィンドウで、[注文] をクリックします。 表示されるページで、注文を見つけて支払いを完了します。
AutoRenewString任意真実

インスタンスの自動更新を有効にするかどうかを指定します。 有効な値：

  • trueになります。
  • falseを実行します。 デフォルト値です。

レスポンスパラメーター

項目データ型例:説明　
OrderIdLong201815745430941

注文 ID。

RequestIdString1AD222E9-E606-4A42-BF6D-8A4442913CEF

リクエストの ID です。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=RenewInstance
&DBInstanceId=rm-uf6wjk5xxxxxxxxxx
&期間=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"
}

エラーコード

HTTP ステータスコードエラーコードエラーメッセージ説明　
400SYSTEM.CONCURRENT_OPERATE同時動作が検出される。システムで同時操作が実行された場合に返されるエラーメッセージ。
400ArrearageOrderExistsYour account has an outstanding balance.Alibaba Cloudアカウントに未払いの残高がある場合に返されるエラーメッセージ。

エラーコードリストについては、「API エラーセンター」をご参照ください。