UpgradeDBInstanceKernelVersion操作を呼び出して、ApsaraDB RDSインスタンスのマイナーエンジンバージョンを更新できます。

マイナーエンジンバージョンのアップデートにより、パフォーマンスが向上し、新しい機能が導入され、既知のバグが修正されます。 詳細については、ApsaraDB RDS For MySQLインスタンスのマイナーエンジンバージョンの更新、ApsaraDB RDS for SQL Serverインスタンスのマイナーエンジンバージョンの更新、およびApsaraDB RDS for PostgreSQLインスタンスのマイナーエンジンバージョンの更新をご参照ください。

説明 この操作は、MySQL、SQL Server、またはPostgreSQLデータベースエンジンを実行するインスタンスでのみサポートされます。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceId String 必須 rm-bpxxxxx

インスタンスの ID です。 このパラメーターは、MySQL、PostgreSQL、またはSQL Serverデータベースエンジンを実行するインスタンスでのみサポートされます。

説明
  • インスタンスがPostgreSQLを実行している場合は、インスタンスに標準SSDまたは拡張SSD (ESSD) が搭載されていることを確認する必要があります。 インスタンスにローカルSSDが搭載されている場合は、RestartDBInstanceを呼び出してインスタンスを再起動する必要があります。 ApsaraDB RDSは、再起動プロセス中にインスタンスを最新のマイナーエンジンバージョンに自動的に更新します。
  • インスタンスがSQL Serverを実行している場合は、インスタンスがSQL Server 2019を実行していることを確認する必要があります。
UpgradeTime String 任意 即時

マイナーエンジンのバージョンを更新するために使用されるメソッド。 有効な値：

  • Immediate: マイナーエンジンのバージョンがすぐに更新されます。
  • MaintainTime: 指定したメンテナンス期間中に、マイナーエンジンのバージョンが更新されます。 メンテナンスウィンドウの変更方法の詳細については、「ModifyDBInstanceMaintainTime」をご参照ください。
  • SpecificyTime: マイナーエンジンのバージョンは、指定した時点で更新されます。

デフォルト値: Immediate。

SwitchTime String 任意 2020-01-15T00:00:00Z

更新を実行する特定の時点。 yyyy-MM-dd T HH:mm:ss Z形式のISO 8601標準で時刻を指定します。 時間は UTC にする必要があります。

説明 このパラメーターは、UpgradeTimeパラメーターをSpecificTimeに設定した場合にのみ有効になります。
TargetMinorVersion String 任意 xcluster80_20210305

インスタンスを更新するマイナーエンジンバージョン。 マイナーエンジンのバージョンは、次のいずれかの形式で指定する必要があります。

  • PostgreSQL: rds_postgres_<Major engine version>00_<Minor engine version> 例: rds_postgres_1200_20200830
  • MySQL: <RDS edition >_< マイナーエンジンバージョン> 例: rds_20200229、xcluster_20200229、xcluster80_20200229 次のRDSエディションとMySQLバージョンがサポートされています。
    • rds: インスタンスはRDS Basic EditionまたはHigh-availability Editionを実行します。
    • xcluster: インスタンスはRDS Enterprise EditionでMySQL 5.7を実行します。
    • xcluster80: インスタンスはRDS Enterprise EditionでMySQL 8.0を実行します。
  • SQLServer: <マイナーエンジンバージョン> 例: 15.0.4073.23。

このパラメーターを指定しない場合、インスタンスは最新のマイナーエンジンバージョンに更新されます。

説明 マイナーエンジンバージョンの詳細については、「マイナーAliPGバージョンのリリースノート」、「マイナーAliSQLバージョンのリリースノート」、および「ApsaraDB RDS For SQL Serverのマイナーエンジンバージョンのリリースノート」をご参照ください。

レスポンスパラメーター

項目 データ型 例: 説明　
DBInstanceName String rm-bpxxxxx

インスタンスの ID です。

RequestId String DA2ECBA0-4745-4491-9166-799FF8984AC9

リクエストの ID です。

TargetMinorVersion String xcluster80_20210305

インスタンスの新しいマイナーエンジンバージョン。

TaskId String 226917711

タスクのID。

例

リクエストの例

http(s):// rds.aliyuncs.com/?Action=UpgradeDBInstanceKernelVersion
&DBInstanceId=rm-bpxxxxx
&UpgradeTime=SpecificTime
&SwitchTime=2020-01-15T00:00:00Z
&TargetMinorVersion=xcluster80_20210305
&<共通リクエストパラメーター>

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

XML 形式

<UpgradeDBInstanceKernelVersion>
      <TaskId>226917711</TaskId>
      <RequestId>DA2ECBA0-4745-4491-9166-799FF8984AC9</RequestId>
      <TargetMinorVersion>xcluster80_20210305</TargetMinorVersion>
      <DBInstanceName>rm-bpxxxxx</DBInstanceName>
</UpgradeDBInstanceKernelVersion>

JSON 形式

{
"TaskId": "226917711" 、"RequestId": "DA2ECBA0-4745-4491-9166-799FF8984AC9" 、"TargetMinorVersion": "xcluster80_20210305" 、"DBInstanceName": "rm-bpxxxxx"
}

エラーコード

HTTP ステータスコード エラーコード エラーメッセージ 説明　
400 MissingParameter.MinorVersionTag パラメータMinorVersionTagを指定する必要があります。 インスタンスの新しいマイナーエンジンバージョンが指定されていない場合に返されるエラーメッセージ。
400 EngineNotSupported エンジンは操作をサポートしていません。 インスタンスで実行されているデータベースエンジンでこの操作がサポートされていない場合に返されるエラーメッセージ。
404 InvalidDBInstanceName.NotFound データベースインスタンスが存在しません。 インスタンスが見つからない場合に返されるエラーメッセージ。
400 IncorrectDBInstanceState 現在のインスタンス状態はこの操作をサポートしていません。 インスタンスが存在する状態では、この操作がサポートされていない場合に返されるエラーメッセージ。
403 IncorrectDBInstanceLockMode Current DB instance lock mode does not support this operation. インスタンスのロックモードがこの操作をサポートしていない場合に返されるエラーメッセージ。
400 タスク存在 指定されたタスクが存在します。 指定されたタスクが既に存在する場合に返されるエラーメッセージ。

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