調(diào)用DescribeAuditLogRecords接口查詢數(shù)倉版集群的SQL審計日志。
接口說明
調(diào)用本接口查看 AnalyticDB MySQL 集群的 SQL 審計日志前,需要開啟 SQL 審計。您可以調(diào)用 DescribeAuditLogConfig 接口查詢 SQL 審計的開啟狀態(tài),如未開啟,可調(diào)用 ModifyAuditLogConfig 接口開啟 SQL 審計。
僅當(dāng) SQL 審計狀態(tài)為開啟時,才能查詢到 SQL 審計日志,且只支持查詢 30 天內(nèi)的 SQL 審計日志。如果中途關(guān)閉了 SQL 審計,再次打開時,僅能查詢到再次打開后的 SQL 審計日志。SQL 審計日志不記錄INSERT INTO VALUES、REPLACE INTO VALUES和UPSERT INTO VALUES操作。
調(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)操作 |
---|---|---|---|---|
adb:DescribeAuditLogRecords | get | *DBCluster acs:adb:{#regionId}:{#accountId}:dbcluster/{#DBClusterId} |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
DBClusterId | string | 是 | 數(shù)倉版集群 ID。 說明
您可以調(diào)用 DescribeDBClusters 接口查看目標(biāo)地域下所有數(shù)倉版集群的集群 ID。
| am-t4nj8619bz2w3**** |
RegionId | string | 是 | 地域 ID。 說明
您可以調(diào)用 DescribeRegions 接口查看 AnalyticDB MySQL 版支持的地域和可用區(qū)信息,包括地域 ID。
| cn-hangzhou |
StartTime | string | 是 | 查詢開始時間,UTC 時間,格式為:yyyy-MM-ddTHH:mmZ。 說明
僅當(dāng) SQL 審計狀態(tài)為開啟時,才能查詢到 SQL 審計日志,且只支持查詢 30 天內(nèi)的 SQL 審計日志。如果中途關(guān)閉了 SQL 審計,再次打開時,僅能查詢到再次打開后的 SQL 審計日志。
| 2022-01-23T02:18Z |
EndTime | string | 是 | 查詢結(jié)束時間,UTC 時間,格式為:yyyy-MM-ddTHH:mmZ。 說明
| 2022-01-23T22:18Z |
DBName | string | 否 | 執(zhí)行 SQL 的數(shù)據(jù)庫名稱。 | adb_demo |
QueryKeyword | string | 否 | 對查詢包含目標(biāo)關(guān)鍵字的 SQL 進行查詢。 | adb |
SqlType | string | 否 | SQL 類型,取值:
說明
每次僅允許傳入一種類型查詢,若該參數(shù)為空,默認查詢所有類型。
| SELECT |
Succeed | string | 否 | 目標(biāo) SQL 是否執(zhí)行成功,取值說明:
| true |
HostAddress | string | 否 | 執(zhí)行目標(biāo) SQL 的客戶端 IP 地址和端口號。 | 100.104.XX.XX:43908 |
OrderType | string | 否 | 按 SQL 執(zhí)行時間進行正序或倒序排序,取值說明:
| asc |
User | string | 否 | 執(zhí)行目標(biāo) SQL 的用戶名。 | test_user |
Order | string | 否 | 根據(jù)指定字段進行排序,格式為 JSON,是一個有序 JSON 數(shù)組,按輸入數(shù)組的順序進行復(fù)合排序,包含 Field 和 Type 兩個字段。
| [{"Field":"ExecuteTime","Type":"Desc"},{"Field":"HostAddress","Type":"Asc"}] |
PageSize | integer | 否 | 每頁記錄數(shù),取值:
說明
本參數(shù)不填寫時,默認為 10。
| 10 |
PageNumber | integer | 否 | 頁碼,取值為大于 0 且不超過 Integer 數(shù)據(jù)類型的最大值。默認值為 1。 | 1 |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"TotalCount": "1",
"PageSize": "10",
"RequestId": "8A564B7F-8C00-43C0-8EC5-919FBB70573",
"PageNumber": "1",
"DBClusterId": "am-t4nj8619bz2w3****",
"Items": [
{
"HostAddress": "100.104.XX.XX:43908",
"Succeed": "true",
"SQLText": "SELECT * FROM tb_courses",
"TotalTime": "216",
"ConnId": "無",
"DBName": "adb_test",
"SQLType": "SELECT",
"ExecuteTime": "2022-01-23 16:05:08",
"ProcessID": "202106081752021720161662490345362390",
"User": "test_user"
}
]
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
404 | InvalidDBCluster.NotFound | The DBClusterId provided does not exist in our records. | 您指定的 DBClusterId 不存在,請確認 DBClusterId 值是否正確。 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-01-05 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |