调用UpgradeDBInstance变更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节点数量。不同实例资源类型和实例系列支持的节点数量不同,具体情况如下:
|
InstanceSpec | String | 否 | 4C16G |
Segment节点规格。支持的节点规格,请参见规格及选型。 说明 该参数仅支持存储弹性模式实例。
|
StorageSize | String | 否 | 100 |
Segment节点存储空间的大小,单位为GB。存储容量范围为50 GB~4000 GB,步长为50。 说明 该参数仅支持存储弹性模式实例。
|
UpgradeType | Long | 否 | 0 |
实例规格变更类型,取值说明:
说明
|
返回数据
名称 | 类型 | 示例值 | 描述 |
---|---|---|---|
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" : "*********"
}
错误码
访问错误中心查看更多错误码。