ApsaraDB RDS:UpgradeDBInstanceMajorVersion

ターゲットインスタンスのインスタンスタイプ。vCPU とメモリの仕様は、元のインスタンスの仕様以上である必要があります。UpgradeMode が inPlaceUpgrade または zeroDownTimeUpgrade に設定されている場合、このパラメーターを指定する必要はありません。

たとえば、元のインスタンスタイプ pg.n2.small.2c が 1 vCPU と 2 GB のメモリを持つ場合、2 vCPU と 4 GB のメモリを持つ pg.n2.medium.2c にアップグレードできます。

ターゲットインスタンスのストレージ容量。単位：GB。UpgradeMode が inPlaceUpgrade または zeroDownTimeUpgrade に設定されている場合、このパラメーターを指定する必要はありません。

有効値：

• ESSD PL1 クラウドディスク：20～3200

• ESSD PL2 クラウドディスク：500～3200

• ESSD PL3 クラウドディスク：1500～3200

• Ultra ディスク：40～2000

課金方法。値は Postpaid (従量課金) である必要があります。

ターゲットインスタンスのネットワークタイプ。値は VPC である必要があります。メジャーバージョンアップは VPC 内のインスタンスでのみサポートされています。

ご利用のインスタンスがクラシックネットワークを使用している場合は、まずネットワークタイプを VPC に切り替える必要があります。ネットワークタイプの表示または切り替え方法については、「ApsaraDB RDS for PostgreSQL インスタンスのネットワークタイプを変更する」をご参照ください。

切り替え時間。このパラメーターは SwitchOver が true に設定されている場合にのみ有効です。

有効値：

• Immediate：切り替えはすぐに実行されます。

• MaintainTime：切り替えは指定されたメンテナンスウィンドウ内で実行されます。ModifyDBInstanceMaintainTime 操作を呼び出してメンテナンスウィンドウを変更できます。

これは予約済みのパラメーターです。このパラメーターを指定する必要はありません。

アップグレード後にワークロードをターゲットインスタンスに切り替えるかどうかを指定します。

有効値：

• true：自動切り替えを実行します。このオプションは通常、新しいメジャーバージョンでワークロードが期待どおりに実行できることを確認した後の本番アップグレードに使用されます。

• false：切り替えを実行しません。このオプションは通常、本番アップグレードの前に新しいメジャーバージョンとのワークロードの互換性をテストするために使用されます。

データベースの統計情報収集をいつ実行するかを指定します。

• Before：切り替え前に統計情報を収集します。この方法はワークロードの安定性を確保しますが、インスタンスに大量のデータが含まれている場合、アップグレード時間が長くなる可能性があります。

• After：切り替え後に統計情報を収集します。この方法はインスタンスのアップグレードを高速化します。ただし、アップグレード後、統計情報が生成されていないテーブルに対するクエリは不正確な実行計画を使用する可能性があり、ピーク時にデータベースがクラッシュする原因となることがあります。

インスタンスのターゲットメジャーエンジンバージョン。このパラメーターの値は、事前チェックで指定されたターゲットバージョンと一致する必要があります。

元のインスタンスの ID。

VPC ID。UpgradeMode が inPlaceUpgrade または zeroDownTimeUpgrade に設定されている場合、このパラメーターを指定する必要はありません。

DescribeDBInstanceAttribute 操作を呼び出して、元のインスタンスの VPC ID を表示できます。

ターゲットインスタンスの vSwitch ID。UpgradeMode が inPlaceUpgrade または zeroDownTimeUpgrade に設定されている場合、このパラメーターを指定する必要はありません。

• 元のインスタンスが RDS Basic Edition を実行している場合、ターゲットインスタンスの vSwitch ID を指定します。

• 元のインスタンスが RDS High-availability Edition を実行している場合、ターゲットインスタンスのプライマリインスタンスとセカンダリインスタンスの vSwitch ID を指定できます。vSwitch ID はカンマ (,) で区切ります。

ターゲットインスタンスのプライベート IP アドレス。システムが指定された VPCId と VSwitchId に基づいて自動的に割り当てるため、このパラメーターを指定する必要はありません。

これは予約済みのパラメーターです。このパラメーターを指定する必要はありません。

これは予約済みのパラメーターです。このパラメーターを指定する必要はありません。

ターゲットインスタンスのストレージタイプ。

有効値：

• cloud_ssd：SSD

• cloud_essd：ESSD PL1

• cloud_essd2：ESSD PL2

• cloud_essd3：ESSD PL3

• general_essd：Ultra ディスク

メジャーバージョンアップ機能はスナップショットに基づいています。ターゲットインスタンスで選択できるストレージタイプは、元のインスタンスのストレージタイプによって異なります。

• 元のインスタンスが SSD クラウドディスクを使用している場合、SSD クラウドディスクのみを選択できます。

• 元のインスタンスが ESSD クラウドディスクを使用している場合、ESSD PL1、ESSD PL2、ESSD PL3、または Ultra ディスクを選択できます。

• 元のインスタンスがパフォーマンス専有型ローカルディスクを使用している場合、ESSD PL1、ESSD PL2、ESSD PL3、または Ultra ディスクを選択できます。

ターゲットインスタンスのプライマリゾーン ID。UpgradeMode が inPlaceUpgrade または zeroDownTimeUpgrade に設定されている場合、このパラメーターを指定する必要はありません。

DescribeRegions 操作を呼び出してゾーン ID をクエリできます。

ターゲットインスタンスは、同じリージョン内であれば、元のインスタンスとは異なるゾーンにデプロイできます。

ターゲットインスタンスのセカンダリゾーン ID。このパラメーターは、元のインスタンスが RDS High-availability Edition を実行している場合にのみ使用できます。UpgradeMode が inPlaceUpgrade または zeroDownTimeUpgrade に設定されている場合、このパラメーターを指定する必要はありません。

ターゲットインスタンスのセカンダリインスタンスは、同じリージョン内であれば、元のインスタンスとは異なるゾーンにデプロイできます。

DescribeRegions 操作を呼び出してゾーン ID をクエリできます。

これは予約済みのパラメーターです。このパラメーターを指定する必要はありません。

アップグレードモード。SwitchOver が true に設定されている場合、このパラメーターを指定する必要があります。有効値：

• inPlaceUpgrade：新しいインスタンスを作成せずに、元のインスタンスでメジャーバージョンをアップグレードします。アップグレード後、元のインスタンスは新しいメジャーバージョンを実行し、元の注文、インスタンス名、タグ、CloudMonitor アラートルール、およびバックアップルールを保持します。

• blueGreenDeployment：元のインスタンスを保持し、新しいメジャーバージョンで新しいインスタンスを作成します。新しいインスタンスは作成中は課金されませんが、アップグレード完了後は両方のインスタンスが課金されます。新しいインスタンスの課金方法は元のインスタンスと異なる場合があり、割引は継承されません。

• zeroDownTimeUpgrade：ゼロダウンタイムアップグレードを実行します。システムは pg_upgrade を使用して元のインスタンスをターゲットバージョンにアップグレードし、増分更新にはネイティブの論理レプリケーションを使用します。アップグレードプロセスは手動切り替えをサポートし、切り替え前に新しいバージョンを検証できます。元のインスタンスは手動切り替えまで完全に稼働 (読み取り/書き込み) します。切り替え中、インスタンスは数秒間読み取り専用になります。