云数据库 RDS：UpgradeDBInstanceMajorVersion - 升级RDS PostgreSQL数据库大版本

升级后实例规格。CPU 和内存配置必须大于等于原实例规格。当 UpgradeMode（升级模式）取值为 inPlaceUpgrade 时，无需配置该参数。

例如，原实例规格pg.n2.small.2c的 CPU 为 1 核，内存为 2GB，可升级为pg.n2.medium.2c，CPU 为 2 核，内存为 4 GB。

升级后实例存储空间。单位：GB。当 UpgradeMode（升级模式）取值为 inPlaceUpgrade 时，无需配置该参数。

取值范围：

• ESSD PL1 云盘：20 GB ~ 3200 GB
• ESSD PL2 云盘：500 GB ~ 3200 GB
• ESSD PL3 云盘：1500 GB ~ 3200 GB
• 通用云盘：40 GB ~ 2000 GB

计费方式。固定配置为按量付费，取值 Postpaid。

升级后实例网络类型。固定配置为 VPC，当前只支持专有网络实例进行大版本升级。

如果网络类型为经典网络，请先切换为专有网络。关于如何查看或切换网络类型，请参见切换网络类型。

该参数与 SwitchOver 配合使用，只有 SwitchOver 参数取值为 true 时有效。表示割接时间。

取值范围：

• Immediate：立即生效。
• MaintainTime：在可运维时间段内生效，可调用 ModifyDBInstanceMaintainTime 接口修改可运维时间段。

预留参数，无需配置。

割接配置，根据实际需求选择是否将流量切换到新版本实例上。

取值范围：

• true：割接，自动切换。此选项一般用于在确认业务可以稳定运行在新版本之后执行正式升级。
• false：不割接，不自动切换。此选项一般用于正式升级之前测试当前业务在新版本中的兼容性。

选择在哪个时间点对数据库执行统计信息收集。

• Before：表示割接前收集，可以保证业务稳定性。如果实例数据量太大可能会导致升级时间较久。
• After：表示割接后收集，实例升级速度较快。升级后访问未生成统计信息的表可能导致执行计划不准确，业务高峰期还可能导致数据库宕机。

升级后实例目标大版本。必须与执行升级前检查时设置的目标版本一致。

原实例 ID。

VPC ID。当 UpgradeMode（升级模式）取值为 inPlaceUpgrade 时，无需配置该参数。

可以通过 DescribeDBInstanceAttribute 接口查看原实例的 VPC ID。

目标实例交换机 ID。当 UpgradeMode（升级模式）取值为 inPlaceUpgrade 时，无需配置该参数。

• 当原实例为基础系列实例时，配置目标实例交换机 ID。
• 当原实例为高可用系列实例时，可以配置目标主备实例交换机 ID，使用逗号（,）分隔。

无需配置，表示目标实例的内网 IP。系统默认通过 VPCId 和 vSwitchId 自动分配。

预留参数，无需配置。

预留参数，无需配置。

表示升级后实例的存储类型。

取值范围：

• cloud_ssd：SSD 云盘
• cloud_essd：ESSD PL1 云盘
• cloud_essd2：ESSD PL2 云盘
• cloud_essd3：ESSD PL3 云盘
• general_essd：通用云盘

版本升级功能基于云盘快照，当前升级后支持选择的存储类型如下。

• 当原实例为 SSD 云盘时，可选 SSD 云盘。
• 当原实例为 ESSD 云盘时，可选 ESSD PL1 云盘、ESSD PL2 云盘、ESSD PL3 云盘、通用云盘。
• 当原实例为本地 SSD 盘时，可选 ESSD PL1 云盘、ESSD PL2 云盘、ESSD PL3 云盘、通用云盘。

目标主可用区 ID。当 UpgradeMode（升级模式）取值为 inPlaceUpgrade 时，无需配置该参数。

可以通过 DescribeRegions 接口查看可用区 ID。

RDS PostgreSQL 支持升级后将新的实例配置到与原实例同一地域的其他可用区。

仅当原实例为高可用系列时，该参数可配置，表示目标实例备可用区 ID。当 UpgradeMode（升级模式）取值为 inPlaceUpgrade 时，无需配置该参数。

RDS PostgreSQL 支持升级后将新的备实例配置到与原实例同一地域的其他可用区。

可以通过 DescribeRegions 接口查看可用区 ID。

预留参数，无需配置。

升级模式。当 SwitchOver（割接配置）取值为 true 时，需要配置该参数。取值：

• inPlaceUpgrade：本地升级。大版本升级任务将在原实例上进行，不会创建新版本实例。升级后的原实例大版本提升，并将继承原有的订单、实例名称、标签、云监控报警规则及备份规则。
• blueGreenDeployment 蓝绿部署：蓝绿部署。大版本升级会保留原实例，并创建一个新版本的实例，新实例在创建中不收费，创建成功后将会产生费用，并且计费方式可能会发生变化。升级完成后，原实例和新实例将同时产生费用，且新实例暂不享受原实例的优惠。