インスタンスを新しいメジャーエンジンバージョンにアップグレードする前に、UpgradeDBInstanceMajorVersionPrecheck操作を呼び出して、新しいメジャーエンジンバージョンとApsaraDB RDS for PostgreSQLインスタンスの互換性を確認できます。

ApsaraDB RDS for PostgreSQLは、メジャーエンジンバージョンのアップグレード機能を提供します。 この機能を使用して、ApsaraDB RDS for PostgreSQLインスタンスのメジャーエンジンバージョンをアップグレードできます。

アップグレードを実行する前に、アップグレードチェックを実行し、チェック結果がSuccessであることを確認する必要があります。 この操作では、アップグレードチェックを実行します。

アップグレードは、数分続く一時的な接続などの影響を引き起こします。 オフピーク時にアップグレードを実行することを推奨します。 アップグレードを実行する前に、ApsaraDB RDS for PostgreSQLインスタンスのメジャーエンジンバージョンのアップグレードの説明を読むことを推奨します。

デバッグ

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

リクエストパラメーター

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

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

DBInstanceId String 必須 pgm-bp1c808s731l ****

インスタンスの ID です。

インスタンスは次の要件を満たす必要があります。

  • インスタンスは、PostgreSQL 14、PostgreSQL 13、PostgreSQL 12、PostgreSQL 11、またはPostgreSQL 10、またはPostgreSQL 9.4を実行します。
  • インスタンスは、RDS High-availability EditionまたはRDS Basic Editionを実行します。
  • RDSインスタンスは、仮想プライベートクラウド (VPC) に存在する必要があります。 元のインスタンスがクラシックネットワークにある場合、この操作を呼び出す前にインスタンスをVPCに移行する必要があります。 インスタンスのネットワークタイプを表示または変更する方法の詳細については、「ApsaraDB RDS For PostgreSQLインスタンスのネットワークタイプの変更」をご参照ください。
  • インスタンスを読み取り専用インスタンスにすることも、専用クラスターに作成することもできません。
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 インターフェイスのパラメーターが見つかりません。 パラメーターが見つからない場合に返されるエラーメッセージ。

エラーコードの一覧については、「サービスエラーコード」をご参照ください。