インスタンスを新しいメジャーエンジンバージョンにアップグレードする前に、UpgradeDBInstanceMajorVersionPrecheck操作を呼び出して、新しいメジャーエンジンバージョンとApsaraDB RDS for PostgreSQLインスタンスの互換性を確認できます。
ApsaraDB RDS for PostgreSQLは、メジャーエンジンバージョンのアップグレード機能を提供します。 この機能を使用して、ApsaraDB RDS for PostgreSQLインスタンスのメジャーエンジンバージョンをアップグレードできます。
アップグレードを実行する前に、アップグレードチェックを実行し、チェック結果がSuccessであることを確認する必要があります。 この操作では、アップグレードチェックを実行します。
アップグレードは、数分続く一時的な接続などの影響を引き起こします。 オフピーク時にアップグレードを実行することを推奨します。 アップグレードを実行する前に、ApsaraDB RDS for PostgreSQLインスタンスのメジャーエンジンバージョンのアップグレードの説明を読むことを推奨します。
デバッグ
リクエストパラメーター
項目 | データ型 | 必須/任意 | 例: | 説明 |
---|---|---|---|---|
操作 | String | 必須 | UpgradeDBInstanceMajorVersionPrecheck | 実行する操作です。 値をUpgradeDBInstanceMajorVersionPrecheckに設定します。 |
DBInstanceId | String | 必須 | pgm-bp1c808s731l **** | インスタンスの ID です。 インスタンスは次の要件を満たす必要があります。
|
TargetMajorVersion | String | 必須 | 12.0 | インスタンスの新しいメジャーエンジンバージョン。 新しいメジャーエンジンバージョンは、元のメジャーエンジンバージョンよりも後でなければなりません。 たとえば、元のメジャーエンジンのバージョンがPostgreSQL 10の場合、新しいメジャーエンジンのバージョンはPostgreSQL 11、PostgreSQL 12、PostgreSQL 13、PostgreSQL 14、またはPostgreSQL 15です。 |
レスポンスパラメーター
項目 | データ型 | 例: | 説明 |
---|---|---|---|
DBInstanceName | String | pgm-bp1c808s731l **** | インスタンスの名前です。 |
TargetMajorVersion | String | 12.0 | インスタンスの新しいメジャーエンジンバージョン。 |
RequestId | String | 99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4 | リクエストの ID です。 |
TaskId | String | 41698 **** | タスクのID。 |
例
リクエストの例
http(s):// rds.aliyuncs.com/?Action=UpgradeDBInstanceMajorVersionPrecheck
&DBInstanceId=pgm-bp1c808s731l ****
&TargetMajorVersion=12.0
&<共通リクエストパラメーター>
正常に処理された場合のレスポンス例
XML
形式
HTTP/1.1 200 OK
Content-Type:application/xml
<UpgradeDBInstanceMajorVersionPrecheck>
<TaskId>41698 ****</TaskId>
<RequestId>99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4</RequestId>
<TargetMajorVersion>12.0</TargetMajorVersion>
<DBInstanceName>pgm-bp1c808s731l ****</DBInstanceName>
</UpgradeDBInstanceMajorVersionPrecheck>
JSON
形式
HTTP/1.1 200 OK
Content-Type:application/json
{
"TaskId" : "41698 ****" 、
"RequestId" : "99C1FEEE-FB44-5342-8EBA-DC1E1A1557A4" 、
"TargetMajorVersion" : 12.0、
"DBInstanceName" : "pgm-bp1c808s731l ****"
}
エラーコード
HTTP ステータスコード | エラーコード | エラーメッセージ | 説明 |
---|---|---|---|
400 | InvalidDBInstanceName.NotFound | 指定された DB インスタンス名は存在しません。 | インスタンスの名前が見つからない場合に返されるエラーメッセージ。 |
400 | InvalidDBInstanceEngineType. フォーマット | DBインスタンスエンジンタイプはこの操作をサポートしていません。 | この操作がインスタンスのデータベースエンジンでサポートされていない場合に返されるエラーメッセージ。 |
403 | ParamNotFound | インターフェイスのパラメーターが見つかりません。 | パラメーターが見つからない場合に返されるエラーメッセージ。 |
エラーコードの一覧については、「サービスエラーコード」をご参照ください。