调用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分钟。例如当设置PlannedStartTime2021-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******"
}

错误码

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