调用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

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

说明 原有节点规格请参见DescribeDBClusters。
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不存在。

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