マイナーエンジンのバージョンを更新する - 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 エラーセンター」をご参照ください。