全部產品
Search

搜尋本產品

    PolarDB：DescribeBinaryLogList

    文件中心

    PolarDB：DescribeBinaryLogList

    更新時間：Sep 10, 2026

    呼叫 DescribeBinaryLogList 介面查詢 Binlog 日誌。

    介面說明

    • binlog 檔案預設儲存 15 天。

    • 返回的日誌清單中包含日誌記錄結束時間在查詢開始時間之後，並且日誌記錄開始時間在查詢結束時間之前的所有日誌。

    • 當 DownloadLink 不為 NULL 時，使用者可以根據此 URL 下載備份檔案，此 URL 自產生後 2 天內有效，請在過期時間之前下載。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    polardbx:DescribeBinaryLogList

    none

    *全部資源。

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    RegionId

    string

    是

    執行個體所在地域 ID。

    cn-hangzhou
    PageNumber

    integer

    否

    分頁取得目前 binlog 清單時，需填寫目前頁碼，預設從第 1 頁開始。

    1
    PageSize

    integer

    否

    每頁取得 binlog 數量，預設填寫 30。

    30
    DBInstanceName

    string

    是

    目前執行個體名稱。

    pxc-hz1fds
    StartTime

    string

    是

    查詢 binlog 清單開始時間。

    2021-09-09 10:27:46
    EndTime

    string

    是

    查詢 binlog 清單結束時間。

    2021-11-09 10:27:46
    InstanceName

    string

    否

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    RequestId

    string

    請求 ID。

    2DFF784E-DC31-5BBC-9B25-9261CD9E0AA9
    PageNumber

    integer

    目前查詢的頁碼。

    1
    PageSize

    integer

    目前頁面顯示的 binlog 數量。

    30
    TotalNumber

    integer

    查詢到的 binlog 檔案總數。

    100
    LogList

    array<object>

    binlog 檔案清單。

    object

    EndTime

    string

    目前 binlog 結束時間。

    2021-11-09 10:27:46
    ModifiedTime

    string

    最後更新時間。

    2021-11-09 10:27:46
    UploadHost

    string

    備份 host。

    10.110.88.9
    UploadStatus

    integer

    備份狀態：

    • 0：未備份；

    • 1：備份中；

    • 2：已備份。

    2
    BeginTime

    string

    日誌開始時間。

    2021-09-09 10:27:46
    LogSize

    integer

    目前日誌檔案大小。

    536870912
    FileName

    string

    binlog 檔案名稱。

    binlog.000001
    CreatedTime

    string

    檔案建立時間。

    2021-09-09 10:27:46
    PurgeStatus

    integer

    清理狀態：

    • 0：未刪除；

    • 1：已刪除。

    0
    Id

    integer

    目前記錄的唯一 ID。

    100

    樣本

    正常返回樣本

    JSON格式

    {
  "RequestId": "2DFF784E-DC31-5BBC-9B25-9261CD9E0AA9",
  "PageNumber": 1,
  "PageSize": 30,
  "TotalNumber": 100,
  "LogList": [
    {
      "EndTime": "2021-11-09 10:27:46",
      "ModifiedTime": "2021-11-09 10:27:46",
      "UploadHost": "10.110.88.9",
      "UploadStatus": 2,
      "DownloadLink": "http://polarx-cdc-binlog-cn-hangzhou.oss-cn-hangzhou.aliyuncs.com/polardbx_cdc/pxc-hzfd132143sfds1/binlog.000001?Expires=1636469502&OSSAccessKeyId=LT13fds12dsafddsf&Signature=fdpm%bdsfadsa%2F%bdsafdsaf%3D",
      "BeginTime": "2021-09-09 10:27:46",
      "LogSize": 536870912,
      "FileName": "binlog.000001",
      "CreatedTime": "2021-09-09 10:27:46",
      "PurgeStatus": 0,
      "Id": 100
    }
  ]
}

    錯誤碼

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

    變更歷史

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