调用UpgradeDBInstance变更AnalyticDB PostgreSQL版实例的规格。

使用说明

本接口用于变更AnalyticDB PostgreSQL版实例的规格和节点数。

说明 本接口不支持变更存储预留模式实例。

请确保在使用该接口前，已充分了解AnalyticDB PostgreSQL版产品的收费方式和价格。

QPS限制

本接口的单用户QPS限制默认为1000次/秒。超过限制，API调用会被限流，这可能会影响您的业务，请合理调用。

调试

您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。

请求参数

名称 类型 是否必选 示例值 描述
Action String 是 UpgradeDBInstance

系统规定参数。取值：UpgradeDBInstance。
ResourceGroupId String 否 rg-bp67acfmxazb4p****

实例当前所属的资源组ID。如何获取资源组ID，请参见查看资源组基本信息。
RegionId String 否 cn-hangzhou

地域ID。

说明 您可以调用DescribeRegions接口查看可用的地域ID。
DBInstanceClass String 否 null

该参数已废弃，无需传入该参数。
DBInstanceGroupCount String 否 null

该参数已废弃，无需传入该参数。
DBInstanceId String 是 gp-rj***************

实例ID。

说明 您可以调用DescribeDBInstances接口查看目标地域下所有的AnalyticDB PostgreSQL实例的实例ID。
PayType String 否 null

该参数已废弃，无需传入该参数。
MasterNodeNum String 否 2

Master节点数量。取值范围为1~2。

说明 该参数仅支持中国站。
SegNodeNum String 否 2

Segment节点数量。不同实例资源类型和实例系列支持的节点数量不同，具体情况如下：

  • 存储弹性模式高可用版：取值范围为4~512个，步长为4。
  • 存储弹性模式高性能版：取值范围为2~512个，步长为2。
  • Serverless手动调度模式：取值范围为2~512个，步长为2。
InstanceSpec String 否 4C16G

Segment节点规格。支持的节点规格，请参见规格及选型。

说明 该参数仅支持存储弹性模式实例。
StorageSize String 否 100

Segment节点存储空间的大小，单位为GB。存储容量范围为50 GB~6000 GB，步长为50。

说明 该参数仅支持存储弹性模式实例。
SegDiskPerformanceLevel String 否 pl1

磁盘的性能级别PL（Performance Level），取值说明：

  • pl0：PL0级别。
  • pl1：PL1级别。
  • pl2：PL2级别。
SegStorageType String 否 cloud_essd

变更后的磁盘存储类型，目前仅支持变更为ESSD云盘，取值为cloud_essd。
UpgradeType Long 否 0

实例规格变更类型，取值说明：

  • 0（默认）：变更Segment节点数量。
  • 1：变更Segment节点规格和存储空间大小。
  • 2：变更Master节点数量。
  • 3：变更磁盘存储类型和性能级别。
说明
  • 不同的实例资源类型对计算节点变配的支持程度不一样，具体信息，请参见注意事项。
  • 选择对应的变更类型后，仅对应的参数生效，其他参数不会生效。例如，UpgradeType参数为0的情况下，如果同时传入了变更Segment节点数量和Master节点数量的参数，仅变更Segment节点数量的参数会生效。
  • 仅中国站支持变更Master节点数量。
  • 仅支持将磁盘存储类型从高效云盘变更为ESSD云盘。

返回数据

名称 类型 示例值 描述
RequestId String 25C11EE5-B7E8-481A-A07C-BD**********

请求ID。
DBInstanceId String gp-rj***************

实例ID。
OrderId String *********

订单ID。

示例

请求示例

http(s)://gpdb.aliyuncs.com/?Action=UpgradeDBInstance
&RegionId=cn-hangzhou
&DBInstanceId=gp-rj***************
&SegNodeNum=2
&UpgradeType=0
&公共请求参数

正常返回示例

XML格式

HTTP/1.1 200 OK
Content-Type:application/xml

<UpgradeDBInstanceResponse>
    <RequestId>25C11EE5-B7E8-481A-A07C-BD**********</RequestId>
    <DBInstanceId>gp-rj***************</DBInstanceId>
    <OrderId>*********</OrderId>
</UpgradeDBInstanceResponse>

JSON格式

HTTP/1.1 200 OK
Content-Type:application/json

{
  "RequestId" : "25C11EE5-B7E8-481A-A07C-BD**********",
  "DBInstanceId" : "gp-rj***************",
  "OrderId" : "*********"
}

错误码

访问错误中心查看更多错误码。