调用ModifyDBNodeClass接口变更PolarDB集群节点规格。

调试

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

请求参数

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

系统规定参数，取值为ModifyDBNodeClass。

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

集群ID。
DBNodeTargetClass String 是 polar.mysql.x4.large

所有节点的目标规格，请参见计算节点规格。

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：通用规格

返回数据

名称 类型 示例值 描述
DBClusterId String pc-*************

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

订单ID。
RequestId String 685F028C-4FCD-407D-A559-072D63******

请求ID。

示例

请求示例

http(s)://polardb.aliyuncs.com/?Action=ModifyDBNodeClass
&DBClusterId=pc-*************
&DBNodeTargetClass=polar.mysql.x4.large
&ModifyType=Upgrade
&<公共请求参数>

正常返回示例

XML格式 

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

JSON格式 

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

错误码

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