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

错误码

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