DescribePendingMaintenanceAction - 查詢待處理事件的詳情 -

查詢待處理事件的詳情。

調試

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

調試

授權資訊

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

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

操作

存取層級

資源類型

條件關鍵字

關聯操作

polardb:DescribePendingMaintenanceAction

get

*全部資源

*

無

請求參數

名稱	類型	必填	描述	樣本值
Region	string	是	待處理事件所在地區的地區 ID，您可以調用 DescribeRegions 介面查看 PolarDB 支援的地區和可用性區域。說明您可以輸入 all 查看您賬戶下所有的待處理事件。當`Region`設定為 all 時，`TaskType`也必須設定為 all。	all
TaskType	string	是	待處理事件的任務類型，取值範圍如下： DatabaseSoftwareUpgrading：資料庫軟體升級 DatabaseHardwareMaintenance：硬體維護與升級 DatabaseStorageUpgrading：資料庫儲存升級 DatabaseProxyUpgrading：代理小版本升級 all：表示查詢上述所有類型的待處理事件詳情說明當`Region`設定為 all 時，`TaskType`也必須設定為 all。	all
IsHistory	integer	否	是否返回歷史任務，取值範圍如下： 0：返回當前任務 1：返回歷史任務預設取值為 0。	0
PageSize	integer	否	每頁記錄數，取值為 30、50 或 100。預設值為 30。	30
PageNumber	integer	否	頁碼，取值為大於 0 且不超過整數資料類型的最大值，預設值為 1。	1
ResourceGroupId	string	否	資源群組 ID。	rg-************

返回參數

名稱	類型	描述	樣本值
	object
TotalRecordCount	integer	總記錄數。	1
RequestId	string	請求 ID。	2F029645-FED9-4FE8-A6D3-488954******
PageSize	integer	每頁記錄數。	30
PageNumber	integer	頁碼。	1
Items	array<object>	工作清單。
	object
Status	integer	任務狀態。若您設定`IsHistory`為 0，則返回待處理任務狀態的詳情，取值範圍如下： 2：等待使用者佈建任務開始時間 3：等待處理 4：任務正在處理中（不支援在該狀態下修改任務執行時間）若您設定`IsHistory`為 1，則返回歷史任務狀態的詳情，取值範圍如下： 5：任務結束且執行成功 6：任務結束但執行失敗 7：任務已取消	3
PrepareInterval	string	待處理事件切換之前所需的準備時間，格式為`HH:mm:ss`。	04:00:00
Deadline	string	任務執行時間可調整範圍的最晚期限，格式為`yyyy-MM-ddTHH:mm:ssZ`（UTC 時間）。	2020-06-11T15:59:59Z
DBType	string	資料庫引擎類型，取值範圍如下： MySQL PostgreSQL Oracle	MySQL
TaskType	string	待處理事件的任務類型。	DatabaseSoftwareUpgrading
StartTime	string	後台執行該任務的時間點，格式為`yyyy-MM-ddTHH:mm:ssZ`（UTC 時間）。	2020-06-09T18:00:00Z
DBVersion	string	資料庫引擎版本號碼。 MySQL 版本號碼取值範圍如下： 5.6 5.7 8.0 PostgreSQL 版本號碼取值範圍如下： 11 14 Oracle 版本號碼取值範圍如下： 11 14	8.0
ModifiedTime	string	修改時間，格式為`yyyy-MM-ddTHH:mm:ssZ`（UTC 時間）。	2020-06-09T22:00:42Z
DBClusterId	string	叢集 ID。	pc-************
Region	string	任務所在地區的地區 ID。	cn-hangzhou
ResultInfo	string	任務執行結果，取值範圍如下： manualCancel：手動取消任務 paramCheckNotPass：參數檢查未通過說明僅當`Status`（任務狀態）取值為 6（任務結束但執行失敗）或 7（任務已取消）時，返回該參數。	manualCancel
CreatedTime	string	建立任務的時間點，格式為`yyyy-MM-ddTHH:mm:ssZ`（UTC 時間）。	2020-06-09T22:00:42Z
Id	integer	目標任務 ID。	111111
SwitchTime	string	待處理事件預計的切換時間，格式為`yyyy-MM-ddTHH:mm:ssZ`（UTC 時間）。	2020-06-09T22:00:00Z

樣本

正常返回樣本

JSON格式

{
  "TotalRecordCount": 1,
  "RequestId": "2F029645-FED9-4FE8-A6D3-488954******",
  "PageSize": 30,
  "PageNumber": 1,
  "Items": [
    {
      "Status": 3,
      "PrepareInterval": "04:00:00",
      "Deadline": "2020-06-11T15:59:59Z",
      "DBType": "MySQL",
      "TaskType": "DatabaseSoftwareUpgrading",
      "StartTime": "2020-06-09T18:00:00Z",
      "DBVersion": "8.0",
      "ModifiedTime": "2020-06-09T22:00:42Z",
      "DBClusterId": "pc-************",
      "Region": "cn-hangzhou",
      "ResultInfo": "manualCancel",
      "CreatedTime": "2020-06-09T22:00:42Z",
      "Id": 111111,
      "SwitchTime": "2020-06-09T22:00:00Z"
    }
  ]
}

錯誤碼

HTTP status code	錯誤碼	錯誤資訊	描述
400	RequiredParam.NotFound	Required input param is not found.	所需的輸入參數不存在。

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

變更歷史

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