全部產品
Search

搜尋本產品

    Data Management：ListSQLExecAuditLog - 擷取SQL審計日誌列表

    文件中心

    Data Management：ListSQLExecAuditLog - 擷取SQL審計日誌列表

    更新時間：Mar 21, 2026

    擷取在DMS進行SQL操作的審計日誌列表。

    調試

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

    調試

    授權資訊

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

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

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

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

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

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

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

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

    操作

    存取層級

    資源類型

    條件關鍵字

    關聯操作

    dms:ListSQLExecAuditLog

    list

    *全部資源

    *

    		 無 無

    請求參數

    名稱

    類型

    必填

    描述

    樣本值
    StartTime

    string

    是

    開始操作的時間。

    說明

    開始時間可模糊輸入，時間格式為 YYYY-MM-DD hh:mm:ss。

    2021-11-08 11:04:00
    EndTime

    string

    是

    結束操作的時間。

    說明

    結束時間可模糊輸入，時間格式為 YYYY-MM-DD hh:mm:ss，建議您輸入的開始時間和結束時間間隔不要超過一天，方便分頁拉取，提升效率。

    2021-11-08 11:00:00
    SearchName

    string

    否

    搜尋名稱。

    說明

    此處的搜尋名稱可輸入資料庫名，如果是執行個體層級的 SQL 操作，則可輸入執行個體名稱。

    test_SearchName
    OpUserName

    string

    否

    操作人暱稱。

    test_OpUserName
    SqlType

    string

    否

    SQL 類型，常見 SQL 類型取值說明如下：

    • SELECT：查詢

    • INSERT：插入

    • DELETE：刪除

    • CREATE_TABLE：建立表

    說明

    您可以在控制台頁面上方Action Trail->SQL 類型中查看更多 SQL 類型取值。

    SELECT
    ExecState

    string

    否

    執行狀態，取值說明如下：

    • -1：執行失敗

    • 0：暫未執行

    • 2：執行中

    • -2：取消執行

    • 1：執行成功

    1
    PageSize

    integer

    否

    每頁資料量。最大值不超過 100。

    20
    PageNumber

    integer

    否

    開始頁碼。請輸入合理的頁碼，若頁碼填寫超過日誌總頁數，可能會操作總記錄數不為 0，但是Action Trail日誌列表資訊為空白的情況。

    1
    Tid

    integer

    否

    租戶 ID，可通過調用介面 GetUserActiveTenant 擷取該參數的值。

    3***

    返回參數

    名稱

    類型

    描述

    樣本值

    object

    TotalCount

    integer

    操作總記錄數。

    1
    RequestId

    string

    請求 ID。

    39BC9C86-95AE-58F2-9862-A7C3D896****
    ErrorCode

    string

    錯誤碼。

    MissingStartTime
    ErrorMessage

    string

    錯誤資訊。

    StartTime is mandatory for this action.
    Success

    boolean

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

    • true：請求成功

    • false：請求失敗

    true
    SQLExecAuditLogList

    object

    SQLExecAuditLog

    array<object>

    SQL Action Trail列表。

    object

    SQL Action Trail資訊。

    OpTime

    string

    操作時間。

    2021-11-08 11:04:27
    UserName

    string

    操作人暱稱。

    test_UserName
    UserId

    integer

    操作人 ID。

    12****
    InstanceName

    string

    資料庫名稱。

    說明

    如果此處為執行個體層級的操作，則返回執行個體名稱。

    polar123@pc-bp1h9tgq4st9g****.mysql.polardb.rds.aliyuncs.com:3306【polar_qw_測試】
    InstanceId

    integer

    執行個體 ID。

    185***
    SchemaName

    string

    資料庫名稱。

    polar123
    DbId

    integer

    資料庫 ID。

    2157****
    Logic

    boolean

    是否為邏輯庫，傳回值說明如下：

    • true：邏輯庫

    • false：物理庫

    false
    SQLType

    string

    SQL 類型，常見 SQL 類型傳回值說明如下：

    • SELECT：查詢

    • INSERT：插入

    • DELETE：刪除

    • CREATE_TABLE：建立表

    說明

    您可以在控制台頁面上方Action Trail->SQL 類型中查看更多 SQL 類型傳回值。

    SELECT
    SQL

    string

    已執行的 SQL 陳述式。

    SELECT * FROM `polar123`.`p_qw` ORDER BY `id` DESC
    ExecState

    string

    執行狀態，傳回值說明如下：

    • FAIL：執行失敗

    • NOEXE：暫未執行

    • RUNNING：執行中

    • CANCEL：取消執行

    • SUCCESS：執行成功

    SUCCESS
    AffectRows

    integer

    表示執行 SQL 陳述式後返回的總行數。比如，SQL 陳述式為查詢語句，此參數返回的是查詢資料的總行數。

    2
    ElapsedTime

    integer

    操作耗時，單位為毫秒。

    18
    Remark

    string

    備忘資訊。

    success

    樣本

    正常返回樣本

    JSON格式

    {
  "TotalCount": 1,
  "RequestId": "39BC9C86-95AE-58F2-9862-A7C3D896****",
  "ErrorCode": "MissingStartTime",
  "ErrorMessage": "StartTime is mandatory for this action.",
  "Success": true,
  "SQLExecAuditLogList": {
    "SQLExecAuditLog": [
      {
        "OpTime": "2021-11-08 11:04:27",
        "UserName": "test_UserName",
        "UserId": 0,
        "InstanceName": "polar123@pc-bp1h9tgq4st9g****.mysql.polardb.rds.aliyuncs.com:3306【polar_qw_測試】",
        "InstanceId": 0,
        "SchemaName": "polar123",
        "DbId": 0,
        "Logic": false,
        "SQLType": "SELECT",
        "SQL": "SELECT * FROM `polar123`.`p_qw` ORDER BY `id` DESC",
        "ExecState": "SUCCESS",
        "AffectRows": 2,
        "ElapsedTime": 18,
        "Remark": "success"
      }
    ]
  }
}

    錯誤碼

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

    變更歷史

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