查詢待處理事件的詳情。
調(diào)試
您可以在OpenAPI Explorer中直接運行該接口,免去您計算簽名的困擾。運行成功后,OpenAPI Explorer可以自動生成SDK代碼示例。
授權(quán)信息
下表是API對應(yīng)的授權(quán)信息,可以在RAM權(quán)限策略語句的Action
元素中使用,用來給RAM用戶或RAM角色授予調(diào)用此API的權(quán)限。具體說明如下:
- 操作:是指具體的權(quán)限點。
- 訪問級別:是指每個操作的訪問級別,取值為寫入(Write)、讀取(Read)或列出(List)。
- 資源類型:是指操作中支持授權(quán)的資源類型。具體說明如下:
- 對于必選的資源類型,用背景高亮的方式表示。
- 對于不支持資源級授權(quán)的操作,用
全部資源
表示。
- 條件關(guān)鍵字:是指云產(chǎn)品自身定義的條件關(guān)鍵字。
- 關(guān)聯(lián)操作:是指成功執(zhí)行操作所需要的其他權(quán)限。操作者必須同時具備關(guān)聯(lián)操作的權(quán)限,操作才能成功。
操作 | 訪問級別 | 資源類型 | 條件關(guān)鍵字 | 關(guān)聯(lián)操作 |
---|---|---|---|---|
polardb:DescribePendingMaintenanceAction | Read |
|
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
Region | string | 是 | 待處理事件所在地域的地域 ID,您可以調(diào)用 DescribeRegions 接口查看 PolarDB 支持的地域和可用區(qū)。 說明
Region 設(shè)置為 all 時,TaskType 也必須設(shè)置為 all。 | all |
TaskType | string | 是 | 待處理事件的任務(wù)類型,取值范圍如下:
說明
當(dāng) Region 設(shè)置為 all 時,TaskType 也必須設(shè)置為 all。
| all |
IsHistory | integer | 否 | 是否返回歷史任務(wù),取值范圍如下:
默認(rèn)取值為 0。 | 0 |
PageSize | integer | 否 | 每頁記錄數(shù),取值為 30、50 或 100。 默認(rèn)值為 30。 | 30 |
PageNumber | integer | 否 | 頁碼,取值為大于 0 且不超過 Integer 數(shù)據(jù)類型的最大值,默認(rèn)值為 1。 | 1 |
ResourceGroupId | string | 否 | 資源組 ID。 | rg-************ |
返回參數(shù)
示例
正常返回示例
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. | 所需的輸入?yún)?shù)不存在。 |
訪問錯誤中心查看更多錯誤碼。