UpgradeDBProxyInstanceKernelVersionを呼び出して、ApsaraDB RDSインスタンスのデータベースプロキシバージョンをアップグレードできます。

UpgradeDBProxyInstanceKernelVersion操作を呼び出す前に、インスタンスのデータベースプロキシ機能を有効にするためにModifyDBProxy操作が呼び出されていることを確認してください。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceId String 必須 rm-uf6wjk5 ****

インスタンスの ID です。 DescribeDBInstancesを呼び出して、インスタンスのIDを照会できます。

UpgradeTime String 任意 MaintainTime

インスタンスのデータベースプロキシバージョンをアップグレードする時刻。 有効な値：

  • MaintainTime: ApsaraDB RDSは、指定したメンテナンス期間中にアップグレードを実行します。 デフォルト値です。 詳細については、「メンテナンスウィンドウの変更」をご参照ください。
  • Immediate: ApsaraDB RDSはすぐにアップグレードを実行します。
  • SpecificTime: ApsaraDB RDSは、指定された時点でアップグレードを実行します。
説明
  • インスタンスがMySQLを実行する場合、このパラメーターをMaintainTime、Immediate、またはSpecificTimeに設定できます。
  • インスタンスがPostgreSQLを実行している場合、このパラメーターをMaintainTimeまたはImmediateに設定できます。
SwitchTime String 任意 2019-07-10T13:15:12Z

インスタンスのデータベースプロキシバージョンをアップグレードする時点。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

説明 UpgradeTimeパラメーターをSpecificTimeに設定した場合、SwitchTimeパラメーターを指定する必要があります。
DBProxyEngineType String 任意 normal

内部パラメーター。 指定する必要はありません。

レスポンスパラメーター

項目 データ型 例: 説明　
DBInstanceName String bu9 ***

インスタンスのデータベースプロキシのID。

RequestId String 44537EC8-DFA2-4745-B579-E733FF2C5B9A

リクエストの ID です。

TaskId String 334362871

タスクのID。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=UpgradeDBProxyInstanceKernelVersion
&DBInstanceId=rm-uf6wjk5 ****
&<共通リクエストパラメーター>

正常に処理された場合のレスポンス例

XML 形式 

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

<UpgradeDBProxyInstanceKernelVersionResponse>
    <DBInstanceName>bu9 ***</DBInstanceName>
    <RequestId>44537EC8-DFA2-4745-B579-E733FF2C5B9A</RequestId>
    <TaskId>334362871</TaskId>
</UpgradeDBProxyInstanceKernelVersionResponse>

JSON 形式 

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

{
  "DBInstanceName" : "bu9 ***" 、
  "RequestId" : "44537EC8-DFA2-4745-B579-E733FF2C5B9A" 、
  "TaskId" : 334362871
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 InvalidDBInstanceName 指定されたパラメーターDBInstanceNameは無効です。 DBInstanceNameパラメーターの値が無効な場合に返されるエラーメッセージ。 値がnullまたは空の文字列であるかどうかを確認します。

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