調用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-**************"
}

錯誤碼

訪問錯誤中心查看更多錯誤碼。