變更PolarDB集群節點規格。
調試
您可以在OpenAPI Explorer中直接運行該接口，免去您計算簽名的困擾。運行成功后，OpenAPI Explorer可以自動生成SDK代碼示例。
授權信息
當前API暫無授權信息透出。
請求參數
| 名稱 | 類型 | 必填 | 描述 | 示例值 |
|---|---|---|---|---|
| DBClusterId | string | 是 | 集群 ID。 | pc-************* |
| ModifyType | string | 是 | 變更類型，取值范圍如下：
| Upgrade |
| DBNodeTargetClass | string | 是 | 所有節點的目標規格，請參見計算節點規格。 | polar.mysql.x4.large |
| ClientToken | string | 否 | 用于保證請求的冪等性，防止重復提交請求。由客戶端生成該參數值，保證在不同請求間唯一，大小寫敏感、不超過 64 個 ASCII 字符。 | 6000170000591aed949d0f54a343f1a4233c1e7d1c5c****** |
| PlannedStartTime | string | 否 | 開始執行定時（即在目標時間段內執行）升降級配置任務的最早時間。格式為 說明
ModifyType取值為Upgrade或Downgrade時，該參數生效。2021-01-14T09:00:00Z，此處允許填入的開始時間范圍為2021-01-14T09:00:00Z~2021-01-15T09:00:00Z。 | 2021-01-14T09:00:00Z |
| PlannedEndTime | string | 否 | 開始執行目標定時任務的最晚時間。格式為 說明
PlannedStartTime但未指定該參數，執行目標任務的最晚時間默認為開始時間+30 分鐘。例如當設置PlannedStartTime為2021-01-14T09:00:00Z且該參數留空時，目標任務最晚將于2021-01-14T09:30:00Z開始執行。 | 2021-01-14T09:30:00Z |
| SubCategory | string | 否 | 集群子系列。取值范圍如下：
若獨享共享之間規格相互變配，subcategory 這個字段為必填項 | normal_general |
| DBNodeType | string | 否 | 節點類型。固定取值為 DLNode。 枚舉值：
| DLNode |
返回參數
示例
正常返回示例
JSON格式
{
"RequestId": "685F028C-4FCD-407D-A559-072D63******",
"DBClusterId": "pc-*************",
"OrderId": "2035629******"
}錯誤碼
| HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
|---|---|---|---|
| 400 | ORDER.ARREARAGE | 您有欠費賬單，不符合購買條件，請先結清賬單后再購買 | 您有欠費賬單，不符合購買條件，請先結清賬單后再購買 |
| 400 | InsufficientResourceCapacity | The resource is insufficient. | 資源不足。 |
| 400 | InvalidModifyType.Malformed | The specified parameter ModifyType is not valid. | 指定的參數ModifyType無效。 |
| 403 | OperationDenied.RoEqualSpec | must exist at least ro class equal with rw | 必須至少存在與rw相等的ro類 |
| 403 | OperationDenied.DBClusterStatus | The operation is not permitted due to status of cluster. | PolarDB集群當前狀態下不允許執行該操作。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
| 變更時間 | 變更內容概要 | 操作 |
|---|---|---|
| 2023-09-13 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |
| 2023-09-12 | OpenAPI 錯誤碼發生變更、OpenAPI 入參發生變更 | 查看變更詳情 |
| 2023-06-12 | OpenAPI 錯誤碼發生變更 | 查看變更詳情 |