调用TempModifyDBNode为集群临时升配或增加节点。

调试

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

请求参数

名称 类型 是否必选 示例值 描述
ClientToken String 6000170000591aed949d0f5********************

该参数用于保证请求的幂等性。由客户端生成该参数值,保证在不同请求间该参数值的唯一性。该参数区分大小写、长度不超过64个ASCII字符。

Action String TempModifyDBNode

系统规定参数。取值:TempModifyDBNode

DBClusterId String pc-xxxxxxxxxx

集群ID。

OperationType String Modify

操作类型。取值:

  • Add:增加节点
  • Modify:临时升配
ModifyType String TempUpgrade

变更类型。当前取值固定为TempUpgrade

RestoreTime String 2021-09-23 18:16:00

临时升配还原时间。格式为YYYY-MM-DD hh:mm:ss。

说明 还原时间不能早于当前时间往后推1小时,不能晚于集群到期时间的前1天。
DBNode.N.TargetClass String polar.mysql.x4.medium

新增节点的规格。需要与原有节点保持一致。

DBNode.N.ZoneId String cn-hangzhou-i

新增节点的可用区。需要与原有节点保持一致。

返回数据

名称 类型 示例值 描述
DBNodeIds Array of String pi-***************

节点列表。

说明OperationType取值为Add时,该参数返回值不为空;当OperationType取值为Modify时,该参数返回值为空。
RequestId String 69A85BAF-1089-4CDF-A82F-0A140F******

请求ID。

DBClusterId String pc-xxxxxxxxxxxxxxxxx

集群ID。

OrderId String 2035638*******

订单ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?ClientToken=6000170000591aed949d0f5********************
&Action=TempModifyDBNode
&DBClusterId=pc-xxxxxxxxxx
&OperationType=Modify
&ModifyType=TempUpgrade
&DBNode=[{"TargetClass":"polar.mysql.x4.medium","ZoneId":"cn-hangzhou-i"}]
&RestoreTime=2021-09-23 18:16:00
&公共请求参数

正常返回示例

XML格式

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

<TempModifyDBNodeResponse>
    <DBNodeIds>pi-***************</DBNodeIds>
    <RequestId>69A85BAF-1089-4CDF-A82F-0A140F******</RequestId>
    <DBClusterId>pc-xxxxxxxxxxxxxxxxx</DBClusterId>
    <OrderId>2035638*******</OrderId>
</TempModifyDBNodeResponse>

JSON格式

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

{
  "DBNodeIds" : [ "pi-***************" ],
  "RequestId" : "69A85BAF-1089-4CDF-A82F-0A140F******",
  "DBClusterId" : "pc-xxxxxxxxxxxxxxxxx",
  "OrderId" : "2035638*******"
}

错误码

HttpCode 错误码 错误信息 描述
404 InvalidDBCluster.NotFound The specified DBClusterId is not found. 指定的集群实例ID不存在

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