全部產品
Search

搜尋本產品

    ApsaraDB for MongoDB：DescribeActiveOperationTask - 查詢營運任務詳情

    文件中心

    ApsaraDB for MongoDB：DescribeActiveOperationTask - 查詢營運任務詳情

    更新時間：Apr 21, 2026

    查詢營運任務詳情。

    調試

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

    調試

    授權資訊

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

    • 操作：是指具體的許可權點。

    • 存取層級：是指每個操作的存取層級，取值為寫入（Write）、讀取（Read）或列出（List）。

    • 資源類型：是指操作中支援授權的資源類型。具體說明如下：

      • 對於必選的資源類型，用前面加 * 表示。

      • 對於不支援資源級授權的操作，用全部資源表示。

    • 條件關鍵字：是指雲產品自身定義的條件關鍵字。

    • 關聯操作：是指成功執行操作所需要的其他許可權。操作者必須同時具備關聯操作的許可權，操作才能成功。

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dds:DescribeActiveOperationTask

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    Region

    string

    是

    待處理事件所屬的地區 ID，可通過 DescribeRegions 查詢。all 代表查詢該使用者下所有的任務，此參數為 all， taskType 也必須為 all。

    cn-shanghai
    TaskType

    string

    是

    任務類型，取值：

    • rds_apsaradb_ha：主從節點切換。

    • rds_apsaradb_transfer：執行個體遷移。

    • rds_apsaradb_upgrade：小版本升級。

    取值來源 DescribeHistoryTasks 。

    傳入 all 代表查詢該使用者下所有的任務，此參數為 all 時， region 也必須為 all。

    rds_apsaradb_ha
    IsHistory

    integer

    否

    是否返回歷史任務，取值：

    • 0：預設值，返回當前任務。

    • 1：返回歷史任務。

    0
    PageSize

    integer

    否

    每頁可展示的最大記錄數，取值需大於 10，預設值為 30。

    30
    PageNumber

    integer

    否

    頁碼，大於 0 且不超過 整數資料類型的最大值，預設值為 1。

    1
    ProductId

    string

    否

    產品識別碼。

    MongoDB

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    TotalRecordCount

    integer

    總記錄數。

    0
    RequestId

    string

    請求 ID。

    6FD47DC4-0750-5524-A89E-E7D559Cxxxxx
    PageSize

    integer

    每頁記錄數，預設值為 30。

    30
    PageNumber

    integer

    頁碼，預設值為 1。

    1
    Items

    array<object>

    工作清單。

    object

    Status

    integer

    任務狀態，傳回值：

    • 2：等待使用者指定時間。

    • 3：等待處理。

    • 4：處理中。進入此狀態後，不可修改計劃切換時間。

    • 5：成功。

    • 6：失敗。

    • 7：已取消。

    2
    TaskParams

    string

    任務參數。

    ""
    PrepareInterval

    string

    營運任務開始時間到切換時間之間所需的準備時間，格式為 HH:mm:ss。

    14:00:00
    Deadline

    string

    營運任務執行時間可調整範圍的最晚期時間，格式為yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2023-03-29T13:59:59Z
    StartTime

    string

    營運任務執行的時間，格式為yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2023-03-20T02:40:00Z
    TaskType

    string

    任務類型，傳回值：

    • rds_apsaradb_ha：主從節點切換。

    • rds_apsaradb_transfer：執行個體遷移。

    • rds_apsaradb_upgrade：小版本升級。

    rds_apsaradb_ha
    ModifiedTime

    string

    營運任務修改時間，格式為yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2023-02-24T08:18:53Z
    InsName

    string

    執行個體 ID。

    dds-bp12721xxxx9b914
    DbType

    string

    資料庫類型。

    mongodb
    Region

    string

    地區 ID。

    cn-beijing
    ResultInfo

    string

    執行結果資訊。

    ""
    CreatedTime

    string

    營運任務建立時間，格式為yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2024-11-06T13:11:08Z
    Id

    integer

    任務 ID。

    50xx
    SwitchTime

    string

    營運任務切換時間，格式為yyyy-MM-ddTHH:mm:ssZ（UTC 時間）。

    2024-11-06T14:11:08Z

    樣本

    正常返回樣本

    JSON格式

    {
  "TotalRecordCount": 0,
  "RequestId": "6FD47DC4-0750-5524-A89E-E7D559Cxxxxx",
  "PageSize": 30,
  "PageNumber": 1,
  "Items": [
    {
      "Status": 2,
      "TaskParams": "\"\"",
      "PrepareInterval": "14:00:00",
      "Deadline": "2023-03-29T13:59:59Z",
      "StartTime": "2023-03-20T02:40:00Z",
      "TaskType": "rds_apsaradb_ha",
      "ModifiedTime": "2023-02-24T08:18:53Z",
      "InsName": "dds-bp12721xxxx9b914",
      "DbType": "mongodb",
      "Region": "cn-beijing",
      "ResultInfo": "\"\"",
      "CreatedTime": "2024-11-06T13:11:08Z",
      "Id": 0,
      "SwitchTime": "2024-11-06T14:11:08Z\n"
    }
  ]
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    400 RequiredParam.NotFound Required input param is not found.

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

    變更歷史

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