全部產品
Search

搜尋本產品

    Data Management：DescribeIncrementBackupList - 查看增量備份工作清單

    文件中心

    Data Management：DescribeIncrementBackupList - 查看增量備份工作清單

    更新時間：Jan 13, 2026

    該介面用於查看DBS增量備份工作清單。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dbs:DescribeIncrementBackupList

    get

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    BackupPlanId

    string

    是

    備份計劃 ID，可通過調用 DescribeBackupPlanList 介面擷取該參數的值。

    dbsqdss5tmh****
    PageSize

    integer

    否

    每頁的記錄數，取值 30、50、100。

    說明

    預設每頁記錄數為 30。

    30
    PageNum

    integer

    否

    頁碼，大於等於 0 且不超過 Integer 的最大值，預設值為 0。

    1
    ClientToken

    string

    否

    任一字元串，用於保證請求的等冪性，防止重複提交請求。

    ETnLKlblzczshOTUbOCzxxxxxxx
    ShowStorageType

    boolean

    否

    是否顯示儲存類型，取值如下：

    • true

    • false

    說明

    預設 true。

    true
    StartTimestamp

    integer

    否

    開始備份時間戳記。

    1570701361528
    EndTimestamp

    integer

    否

    結束備份時間戳記。

    1570701361600

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    HttpStatusCode

    integer

    HTTP 狀態代碼。

    200
    PageNum

    integer

    頁碼。

    0
    RequestId

    string

    請求 ID。

    A5D52069-E8AA-5056-8C5C-654C3610****
    ErrCode

    string

    錯誤碼。

    Param.NotFound
    Success

    boolean

    請求是否成功，傳回值如下：

    • true：請求成功

    • false：請求失敗

    true
    ErrMessage

    string

    錯誤資訊。

    The specified parameter %s value is not valid.

    TotalPages

    integer

    總頁數。

    1
    TotalElements

    integer

    增量備份任務總數。

    1
    PageSize

    integer

    每頁的記錄數。

    30
    Items

    object

    IncrementBackupFile

    array<object>

    增量備份任務詳情。

    object

    增量備份任務詳情資訊如下。

    EndTime

    integer

    備份結束時間戳記。

    1648434713000
    BackupSetExpiredTime

    integer

    備份組保留到期時間戳記。

    1711506719000
    StartTime

    integer

    備份開始時間戳。

    1648433764000
    StorageMethod

    string

    儲存類型，傳回值如下：

    • Standard：標準儲存

    • IA：低頻訪問儲存

    • Archive：Archive Storage

    • UNKNOWN：未知，通常是任務未完成時的狀態

    Standard
    BackupSetJobId

    string

    備份組任務 ID。

    1hv5g9wk4****
    BackupSetId

    string

    備份組 ID。

    mysql-bin.00****
    BackupStatus

    string

    備份任務狀態，傳回值如下：

    • INIT：未啟動

    • FILLING：備份中

    • COMPLETED：完成

    • UNCOMPLETED：未完成

    FILLING
    SourceEndpointIpPort

    string

    資料庫連接地址。

    172.1XX.103.1:4XXX
    BackupSize

    integer

    備份大小。

    18535

    樣本

    正常返回樣本

    JSON格式

    {
  "HttpStatusCode": 200,
  "PageNum": 0,
  "RequestId": "A5D52069-E8AA-5056-8C5C-654C3610****",
  "ErrCode": "Param.NotFound",
  "Success": true,
  "ErrMessage": "The specified parameter %s value is not valid.     ",
  "TotalPages": 1,
  "TotalElements": 1,
  "PageSize": 30,
  "Items": {
    "IncrementBackupFile": [
      {
        "EndTime": 1648434713000,
        "BackupSetExpiredTime": 1711506719000,
        "StartTime": 1648433764000,
        "StorageMethod": "Standard",
        "BackupSetJobId": "1hv5g9wk4****",
        "BackupSetId": "mysql-bin.00****",
        "BackupStatus": "FILLING",
        "SourceEndpointIpPort": "172.1XX.103.1:4XXX",
        "BackupSize": 18535
      }
    ]
  }
}

    錯誤碼

    HTTP status code

    錯誤碼

    錯誤資訊

    描述
    403 Request.Forbidden Have no Permissions 當前操作未被授權，請聯絡主帳號在RAM控制台進行授權後再執行操作

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

    變更歷史

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