UpgradeCDCVersion - PolarDB

調試

您可以在OpenAPI Explorer中直接運行該介面，免去您計算簽名的困擾。運行成功後，OpenAPI Explorer可以自動產生SDK程式碼範例。

調試

授權資訊

下表是API對應的授權資訊，可以在RAM權限原則語句的Action元素中使用，用來給RAM使用者或RAM角色授予調用此API的許可權。具體說明如下：

操作：是指具體的許可權點。
存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。
資源類型：是指操作中支援授權的資源類型。具體說明如下：
- 對於必選的資源類型，用前面加 * 表示。
- 對於不支援資源級授權的操作，用全部資源表示。
條件關鍵字：是指雲產品自身定義的條件關鍵字。
關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

操作

存取層級

資源類型

條件關鍵字

關聯操作

polardbx:UpgradeCDCVersion

none

*全部資源。

*

無

請求參數

名稱	類型	必填	描述	樣本值
DBInstanceName	string	否	執行個體 ID。>您可以呼叫 describedbinstances 介面檢視目標地域下所有執行個體的詳細資訊，包括執行個體 ID。	pxc-hzrp****3p72fi
CdcMinorVersion	string	否	需要升級的目標版本號碼。	polarx-cdc-kernel-5.4.19-20240928_17274884
CdcDbVersion	string	否	需要升級的目標資料庫版本。>您可以呼叫 describedbclusterversion 介面檢視目標地域下所有資料庫版本的升級說明。	2.343
RegionId	string	否	執行個體所在地域。>您可以呼叫 describeregions 介面檢視 PolarDB-X 支援的地域詳細資訊，包括地域 ID。	cn-hangzhou
InstanceName	string	否	執行個體名稱。	pxc-shrvdc****wtf5uk-cdc
SwitchMode	string	否	切換模式。取值： 0：立即切換。 1：在可維運時間段內切換。	0

返回參數

名稱	類型	描述	樣本值
	object	Schema of Response
RequestId	string	Id of the request	CB4307F5-3D04-51E8-ABAD-49E0B3F962FC
Message	string	請求返回訊息。	success
Success	boolean	請求是否成功。	True
Data	object	返回結果。
MinorVersion	string	目標版本號碼。	polardb-2.4.0_5.4.19-20250116_xcluster5.4.20-20241213
TaskList	array<object>	升級任務清單。
	object	升級任務清單。
DbInstanceName	string	實例 id。	rm-uf68f345****88zf8
TaskId	integer	目標任務 id。	1861190497624654848

樣本

正常返回樣本

JSON格式

{
  "RequestId": "CB4307F5-3D04-51E8-ABAD-49E0B3F962FC",
  "Message": "success",
  "Success": true,
  "Data": {
    "MinorVersion": "polardb-2.4.0_5.4.19-20250116_xcluster5.4.20-20241213",
    "TaskList": [
      {
        "DbInstanceName": "rm-uf68f345****88zf8",
        "TaskId": 1861190497624654800
      }
    ]
  }
}

錯誤碼

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

變更歷史

更多資訊，參考變更詳情。