调用ModifyDBNodesClass接口变更PolarDB集群单个节点的规格。

调试

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

请求参数

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

系统规定参数。取值：ModifyDBNodesClass。

DBClusterId String 是 pc-*************

集群ID。
ModifyType String 是 Upgrade

变更类型，取值范围如下：

  • Upgrade：升级规格
  • Downgrade：降级规格
ClientToken String 否 6000170000591aed949d0f54a343f1a4233c1e7d1c5c******

用于保证请求的幂等性，防止重复提交请求。由客户端生成该参数值，保证在不同请求间唯一，大小写敏感、不超过64个ASCII字符。
PlannedStartTime String 否 2021-01-14T09:00:00Z

开始执行定时（即在目标时间段内执行）升级配置任务的最早时间。格式为YYYY-MM-DDThh:mm:ssZ（UTC）。

说明
  • 仅当ModifyType取值为Upgrade时，该参数生效。
  • 开始时间的取值范围为未来24小时内的任意时间点。例如当前时间为2021-01-14T09:00:00Z，此处允许填入的开始时间范围为2021-01-14T09:00:00Z~2021-01-15T09:00:00Z。
  • 若该参数留空，默认立即执行升级配置任务。
PlannedEndTime String 否 2021-01-14T09:30:00Z

开始执行目标定时任务的最晚时间。格式为YYYY-MM-DDThh:mm:ssZ（UTC）。

说明
  • 最晚时间需晚于开始时间的30分钟或以上。
  • 若设置了PlannedStartTime但未指定该参数，执行目标任务的最晚时间默认为开始时间+30分钟。例如当设置PlannedStartTime为2021-01-14T09:00:00Z且该参数留空时，目标任务最晚将于2021-01-14T09:30:00Z开始执行。
SubCategory String 否 normal_general

集群子系列。取值范围如下：

  • normal_exclusive：独享规格
  • normal_general：通用规格
DBNode.N.DBNodeId String 否 pi-*************

集群节点ID。

说明 如果该参数传入后，DBNode.N.TargetClass必填。N为从1开始的整数，最大值=16-当前节点数。
DBNode.N.TargetClass String 否 polar.mysql.x4.medium

变配节点的规格。关于节点规格，请参见计算节点规格。

说明 如果该参数传入后，DBNode.N.DBNodeId必填。N为从1开始的整数，最大值=16-当前节点数。

返回数据

名称 类型 示例值 描述
RequestId String 685F028C-4FCD-407D-A559-072D63******

请求ID。
DBClusterId String pc-*************

数据库集群ID。
OrderId String 2035629******

订单ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=ModifyDBNodesClass
&DBClusterId=pc-*************
&ModifyType=Upgrade
&DBNode=[{"DBNodeId":"pi-*************","TargetClass":"polar.mysql.x4.medium"}]
&ClientToken=6000170000591aed949d0f54a343f1a4233c1e7d1c5c******
&PlannedStartTime=2021-01-14T09:00:00Z
&PlannedEndTime=2021-01-14T09:30:00Z
&公共请求参数

正常返回示例

XML格式 

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

<ModifyDBNodesClassResponse>
    <RequestId>685F028C-4FCD-407D-A559-072D63******</RequestId>
    <DBClusterId>pc-*************</DBClusterId>
    <OrderId>2035629******</OrderId>
</ModifyDBNodesClassResponse>

JSON格式 

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

{
  "RequestId" : "685F028C-4FCD-407D-A559-072D63******",
  "DBClusterId" : "pc-*************",
  "OrderId" : "2035629******"
}

错误码

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