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

使用说明

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

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

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

QPS限制

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

本文档中的QPS仅为默认参考值,准确信息请参见API速率配额列表

调试

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

请求参数

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

系统规定参数。取值:UpgradeDBInstance

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~4000 GB,步长为50。

说明 该参数仅支持存储弹性模式实例。
UpgradeType Long 0

实例规格变更类型,取值说明:

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

返回数据

名称 类型 示例值 描述
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" : "*********"
}

错误码

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