升級(jí)PolarDB MySQL版集群的內(nèi)核版本。
接口說(shuō)明
調(diào)試
您可以在OpenAPI Explorer中直接運(yùn)行該接口,免去您計(jì)算簽名的困擾。運(yùn)行成功后,OpenAPI Explorer可以自動(dòng)生成SDK代碼示例。
授權(quán)信息
下表是API對(duì)應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語(yǔ)句的Action
元素中使用,用來(lái)給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說(shuō)明如下:
- 操作:是指具體的權(quán)限點(diǎn)。
- 訪問(wèn)級(jí)別:是指每個(gè)操作的訪問(wèn)級(jí)別,取值為寫(xiě)入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說(shuō)明如下:
- 對(duì)于必選的資源類型,用背景高亮的方式表示。
- 對(duì)于不支持資源級(jí)授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時(shí)具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問(wèn)級(jí)別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
polardb:UpgradeDBClusterVersion | update |
|
| 無(wú) |
請(qǐng)求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
DBClusterId | string | 是 | 集群 ID。 說(shuō)明
您可以通過(guò) DescribeDBClusters 接口查看賬號(hào)下所有集群的詳細(xì)信息(如集群 ID)。
| pc-**************** |
UpgradePolicy | string | 否 | 內(nèi)核版本升級(jí)策略。取值范圍如下:
| HOT |
UpgradeLabel | string | 否 | 內(nèi)核版本升級(jí)標(biāo)簽。取值固定為 INNOVATE。 說(shuō)明
UpgradePolicy 必須傳入 COLD。 | INNOVATE |
PlannedStartTime | string | 否 | 開(kāi)始執(zhí)行定時(shí)(即在目標(biāo)時(shí)間段內(nèi)執(zhí)行)內(nèi)核版本升級(jí)任務(wù)的最早時(shí)間。格式為 說(shuō)明
2021-01-14T09:00:00Z ,此處允許填入的開(kāi)始時(shí)間范圍為2021-01-14T09:00:00Z ~2021-01-15T09:00:00Z 。 | 2021-01-14T09:00:00Z |
PlannedEndTime | string | 否 | 開(kāi)始執(zhí)行目標(biāo)定時(shí)任務(wù)的最晚時(shí)間。格式為 說(shuō)明
PlannedStartTime 但未指定該參數(shù),執(zhí)行目標(biāo)任務(wù)的最晚時(shí)間默認(rèn)為開(kāi)始時(shí)間+30 分鐘 。例如當(dāng)設(shè)置PlannedStartTime 為2021-01-14T09:00:00Z 且該參數(shù)留空時(shí),目標(biāo)任務(wù)最晚將于2021-01-14T09:30:00Z 開(kāi)始執(zhí)行。 | 2021-01-14T09:30:00Z |
FromTimeService | boolean | 否 | 立即執(zhí)行或定時(shí)執(zhí)行內(nèi)核版本升級(jí)。取值范圍如下:
說(shuō)明
調(diào)用該接口時(shí)無(wú)需使用該參數(shù)。
| false |
UpgradeType | string | 否 | 升級(jí)類型。取值范圍如下:
| PROXY |
TargetDBRevisionVersionCode | string | 否 | 目標(biāo)版本的 VersionCode,參數(shù)取值可從 DescribeDBClusterVersion 接口獲取。 | 20230707 |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"RequestId": "CAE6755F-B79A-4861-B227-801FE8******"
}
錯(cuò)誤碼
HTTP status code | 錯(cuò)誤碼 | 錯(cuò)誤信息 | 描述 |
---|---|---|---|
400 | ScheduleTaskExist | The specified dbCluster already has a scheduled task. | 指定的實(shí)例已經(jīng)存在定時(shí)任務(wù)。 |
400 | InvalidUpgradeLabel.Malformed | The specified parameter UpgradeLabel is not valid. | 指定 UpgradeLabel 參數(shù)無(wú)效 |
400 | InvalidEngine.Unsupported | The specified Engine does not support this feature. | 指定的引擎不支持此功能 |
400 | InvalidEngineMinorVersion.Malformed | The specified parameter MinorVersion is not valid. | 指定的參數(shù)MinorVersion無(wú)效。 |
400 | InvalidEngineVersion.Unsupported | The specified engineVersion is not supported. | 不支持指定的engineVersion。 |
400 | InvalidUpgradePolicy.Malformed | The specified parameter UpgradePolicy is not valid. | 指定的參數(shù)UpgradePolicy無(wú)效 |
400 | InvalidSwitchTimeMode.Malformed | The specified parameter SwitchTimeMode is not valid. | 指定的參數(shù)SwitchTimeMode無(wú)效。 |
403 | OperationDenied.UpgradeType | The operation is not permitted due to gdn limit | 由于 GDN 限制,當(dāng)前升級(jí)操作并不支持 |
403 | IncorrectGdnStandbyDBVersion | Current gdn standby cluster is not the latest db version. | 當(dāng)前gdn備用集群不是最新的db版本 |
404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | 當(dāng)前的記錄中不存在提供的DBClusterId。 |
404 | InvalidDBClusterId.Malformed | The specified parameter DBClusterId is not valid. | 指定的參數(shù)DBClusterId無(wú)效 |
訪問(wèn)錯(cuò)誤中心查看更多錯(cuò)誤碼。
變更歷史
變更時(shí)間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-05-28 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2023-09-12 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
2023-07-25 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |
2022-07-14 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
2022-07-06 | OpenAPI 錯(cuò)誤碼發(fā)生變更 | 查看變更詳情 |
2022-07-04 | OpenAPI 錯(cuò)誤碼發(fā)生變更、OpenAPI 入?yún)l(fā)生變更 | 查看變更詳情 |