獲取審計日志熱數(shù)據(jù)。
接口說明
使用該接口需滿足以下前提條件:
- 使用阿里云或 DAS 的 SDK 時,建議使用最新版本。
- 在使用 SDK 調(diào)用 DAS 服務(wù)時,需要將地域指定為 cn-shanghai。
- 適用于 Polar MySQL、RDS MYSQL、RDS PostgreSQL、RDS SQLServer。
調(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)操作 |
---|---|---|---|---|
hdm:GetDasSQLLogHotData | get | *全部資源 * |
| 無 |
請求參數(shù)
名稱 | 類型 | 必填 | 描述 | 示例值 |
---|---|---|---|---|
InstanceId | string | 是 | 數(shù)據(jù)庫實例 ID。 | rm-2ze1jdv45i7l6**** |
Start | long | 是 | 查詢開始時間,格式為 Unix 時間戳,單位為毫秒。 說明
只能查詢開啟 DAS 企業(yè)版后的數(shù)據(jù),查詢開始時間最大不能早于當(dāng)前時間 7 天。
| 1684734297000 |
End | long | 是 | 查詢結(jié)束時間,格式為 Unix 時間戳,單位為毫秒。 說明
查詢結(jié)束時間需晚于查詢開始時間,且查詢開始時間和查詢結(jié)束時間的間隔不能超過 1 天。
| 1684820697000 |
QueryKeyword | string | 否 | 關(guān)鍵字。 說明
不支持模糊查詢;支持多個關(guān)鍵字組合查詢,關(guān)鍵字間以空格分隔。
| test |
AccountName | string | 否 | 數(shù)據(jù)庫賬號。 說明
支持多個數(shù)據(jù)庫賬號組合查詢,數(shù)據(jù)庫賬號間以空格分隔,例如: user1 user2 user3 。
| testuser |
DBName | string | 否 | 數(shù)據(jù)庫名。 說明
支持多個數(shù)據(jù)庫名組合查詢,數(shù)據(jù)庫名間以空格分隔,例如: DB1 DB2 DB3 。
| testDB |
HostAddress | string | 否 | 客戶端 IP 地址。 說明
支持多個客戶端 IP 地址組合查詢,客戶端 IP 地址間以空格分隔,例如: IP1 IP2 IP3 。
| 47.100.XX.XX |
LogicalOperator | string | 否 | 多個關(guān)鍵字的邏輯關(guān)系。
| or |
MaxLatancy | long | 否 | 最大執(zhí)行耗時 ,單位為微秒。查詢執(zhí)行耗時小于該參數(shù)值的 SQL 語句。 | 100 |
MaxScanRows | long | 否 | 最大掃描行數(shù) ,查詢掃描行數(shù)小于該參數(shù)值的 SQL 語句。 | 10000 |
MinLatancy | long | 否 | 最小執(zhí)行耗時 ,單位為微秒。查詢執(zhí)行耗時大于等于該參數(shù)值的 SQL 語句。 | 10 |
MinScanRows | long | 否 | 最小掃描行數(shù) ,查詢掃描行數(shù)大于等于該參數(shù)值的 SQL 語句。 | 10 |
SqlType | string | 否 | SQL 語句的類型。取值:
枚舉值:
| SELECT |
State | string | 否 | 執(zhí)行結(jié)果,輸入 0 時表示查詢執(zhí)行成功的 SQL,您也可以輸入具體的錯誤碼,查詢對應(yīng)的 SQL。 | 0 |
ThreadID | string | 否 | 線程 ID。 說明
支持多個線程 ID 組合查詢,線程 ID 間以空格分隔,例如: 線程 ID1 線程 ID2 線程 ID3 。
| 657 |
PageNumbers | long | 否 | 分頁查詢的頁碼,從 1 開始,默認為 1。 | 2 |
MaxRecordsPerPage | long | 否 | 分頁查詢每頁最大記錄數(shù)。取值范圍:5~100。 | 10 |
SortKey | string | 否 | 排序依據(jù)。
| SCAN_ROWS |
SortMethod | string | 否 | 排序方式。
| ase |
ChildDBInstanceIDs | string | 否 | 節(jié)點 ID。 說明
對于 PolarDB MySQL 版實例,需要提供節(jié)點 ID。
| pi-bp179lg03445l**** |
Role | string | 否 | 預(yù)留參數(shù),暫不支持。 | None |
TraceId | string | 否 | 預(yù)留參數(shù),暫不支持。 | None |
MinRows | long | 否 | 預(yù)留參數(shù),暫不支持。 | None |
MaxRows | long | 否 | 預(yù)留參數(shù),暫不支持。 | None |
MinSpillCnt | long | 否 | 預(yù)留參數(shù),暫不支持。 | None |
MaxSpillCnt | long | 否 | 預(yù)留參數(shù),暫不支持。 | None |
TransactionId | string | 否 | 事務(wù) ID。 | 0 |
Fail | string | 否 | SQL 執(zhí)行錯誤碼,您可以調(diào)用 GetAsyncErrorRequestStatByCode 獲取錯誤碼。 | 1064 |
返回參數(shù)
示例
正常返回示例
JSON
格式
{
"Code": "200",
"Message": "Successful",
"RequestId": "0A74B755-98B7-59DB-8724-1321B394****",
"Success": "true",
"Data": {
"List": [
{
"Latancy": 10000,
"Ext": "None",
"ExecuteTime": "2023-05-23 T12:11:20Z",
"OriginTime": "2023-05-23 T12:11:20.999Z",
"HostAddress": "47.100.XX.XX",
"UpdateRows": 30,
"LogicRead": 12,
"SQLText": "select 1",
"LockTime": 1,
"ScanRows": 29,
"ThreadID": 657,
"State": "0",
"DBName": "testDB",
"SqlType": "SELECT",
"AccountName": "testuser",
"PhysicSyncRead": 0,
"PhysicAsyncRead": 0,
"TransactionId": "0",
"ReturnRows": 1
}
],
"Total": 20,
"PageNo": 2,
"PageSize": 10,
"Extra": "None"
}
}
錯誤碼
HTTP status code | 錯誤碼 | 錯誤信息 | 描述 |
---|---|---|---|
400 | InvalidParams | The request parameters are invalid. | 請求參數(shù)錯誤 |
403 | NoPermission | You are not authorized to do this action. | 沒有權(quán)限執(zhí)行該操作 |
訪問錯誤中心查看更多錯誤碼。
變更歷史
變更時間 | 變更內(nèi)容概要 | 操作 |
---|---|---|
2024-06-04 | OpenAPI 錯誤碼發(fā)生變更 | 查看變更詳情 |