调用UpgradeDBInstance变更实例的节点与存储规格-云原生数据仓库AnalyticDB-阿里云-云原生数据仓库AnalyticDB(AnalyticDB)-阿里云帮助中心

变更AnalyticDB PostgreSQL版实例的规格。

接口说明

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

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

调试

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

调试

授权信息

下表是API对应的授权信息，可以在RAM权限策略语句的Action元素中使用，用来给RAM用户或RAM角色授予调用此API的权限。具体说明如下：

操作：是指具体的权限点。
访问级别：是指每个操作的访问级别，取值为写入（Write）、读取（Read）或列出（List）。
资源类型：是指操作中支持授权的资源类型。具体说明如下：
- 对于必选的资源类型，用前面加 * 表示。
- 对于不支持资源级授权的操作，用全部资源表示。
条件关键字：是指云产品自身定义的条件关键字。
关联操作：是指成功执行操作所需要的其他权限。操作者必须同时具备关联操作的权限，操作才能成功。

操作

访问级别

资源类型

条件关键字

关联操作

gpdb:UpgradeDBInstance

update

*DBInstance

acs:gpdb:{#regionId}:{#accountId}:dbinstance/{#DBInstanceId}

无

请求参数

名称	类型	必填	描述	示例值
ResourceGroupId	string	否	实例当前所属的资源组 ID。如何获取资源组 ID，请参见查看资源组基本信息。	rg-bp67acfmxazb4p****
RegionId	string	否	地域 ID。说明您可以调用 DescribeRegions 接口查看可用的地域 ID。	cn-hangzhou
DBInstanceClass	string	否	该参数已废弃，无需传入该参数。	null
DBInstanceGroupCount	string	否	该参数已废弃，无需传入该参数。	null
DBInstanceId	string	是	实例 ID。说明您可以调用 DescribeDBInstances 接口查看目标地域下所有的 AnalyticDB PostgreSQL 实例的实例 ID。	gp-rj***************
PayType	string	否	该参数已废弃，无需传入该参数。	null
MasterNodeNum	string	否	该参数已废弃，无需传入该参数。	null
SegNodeNum	string	否	Segment 节点数量。不同实例资源类型和实例系列支持的节点数量不同，具体情况如下：存储弹性模式高可用版：取值范围为 4~512 个，步长为 4。存储弹性模式高性能版：取值范围为 2~512 个，步长为 2。 Serverless 手动调度模式：取值范围为 2~512 个，步长为 2。	2
InstanceSpec	string	否	Segment 节点规格。支持的节点规格，请参见规格及选型。说明该参数仅支持存储弹性模式实例。	4C16G
StorageSize	string	否	Segment 节点存储空间的大小，单位为 GB。存储容量范围为 50 GB~8000 GB，步长为 50。说明该参数仅支持存储弹性模式实例。	100
SegDiskPerformanceLevel	string	否	磁盘的性能级别 PL（Performance Level），取值说明： pl0：PL0 级别。 pl1：PL1 级别。 pl2：PL2 级别。	pl1
SegStorageType	string	否	变更后的磁盘存储类型，目前仅支持变更为 ESSD 云盘，取值为cloud_essd。	cloud_essd
UpgradeType	integer	否	实例规格变更类型，取值说明： 0（默认）：变更 Segment 节点数量。SegNodeNum 为必填参数，其他参数不生效。 1：变更 Segment 节点规格和存储空间大小。InstanceSpec 为必填参数，StorageSize 为选填参数，且必须大于等于当前实例存储空间。 2：变更 Master 节点数量。MasterNodeNum 为必填参数，其他参数不生效。 3：变更磁盘存储类型和性能级别。SegDiskPerformanceLevel 和 SegStorageType 为必填参数，其他参数不生效。说明不同的实例资源类型对计算节点变配的支持程度不一样，具体信息，请参见注意事项。选择对应的变更类型后，仅对应的参数生效，其他参数不会生效。例如，UpgradeType 参数为 0 的情况下，如果同时传入了变更 Segment 节点数量和 Master 节点数量的参数，仅变更 Segment 节点数量的参数会生效。仅中国站支持变更 Master 节点数量。仅支持将磁盘存储类型从高效云盘变更为 ESSD 云盘。	0
ServerlessResource	string	否	Serverless 实例：计算资源阈值。取值范围 8~32，步长为 8，单位为 ACU。默认值为 32。 Serverless Pro 实例：预留计算资源。取值范围 16～1024。单位为 ACU。默认值为 16。步长规则：区间 16-32：步长 4；区间 32-64：步长 8；区间 64-128：步长 16；区间 128-256：步长 32；区间大于 256：步长 64。说明仅 Serverless 自动调度模式和 Serverless Pro 实例需传入该参数。	16
CacheStorageSize	string	否	Serverless 缓存空间，单位为 GB。说明仅 Serverless Pro 实例需传入该参数。	800

返回参数

名称	类型	描述	示例值
	object
RequestId	string	请求 ID。	25C11EE5-B7E8-481A-A07C-BD**********
DBInstanceId	string	实例 ID。	gp-rj***************
OrderId	string	订单 ID。	*********

示例

正常返回示例

JSON格式

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

错误码

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

变更历史

更多信息，参考变更详情。