API ini memungkinkan Anda mengkueri log alarm audit data untuk menemukan dan menangani alarm.
Deskripsi operasi
Sebelum memanggil API ini, pastikan Anda memenuhi prasyarat berikut:
-
Kami merekomendasikan penggunaan SDK Alibaba Cloud atau DAS versi terbaru.
-
Saat menggunakan SDK untuk memanggil layanan DAS, atur region ke cn-shanghai.
Coba sekarang
Test
RAM authorization
Parameter permintaan
|
Parameter |
Type |
Required |
Description |
Example |
| Lang |
string |
No |
Bahasa permintaan dan respons. Nilai default: zh-CN. Nilai yang valid:
|
zh-CN |
| UserName |
string |
No |
Nama pengguna. |
admin |
| ClientIp |
string |
No |
Alamat IP klien. |
11.26.118.7 |
| ClientUa |
string |
No |
Jenis klien. |
mysql |
| InstanceName |
string |
No |
Nama instans. |
rm-t4ni1cezz5y3xxxx |
| DatabaseName |
string |
No |
Nama basis data. |
TestDB |
| StartTime |
integer |
No |
Waktu mulai kueri, ditentukan sebagai stempel waktu UNIX dalam milidetik. |
1608888296000 |
| EndTime |
integer |
No |
Waktu berakhir kueri, ditentukan sebagai stempel waktu UNIX dalam milidetik. |
15682887991222 |
| ProductCode |
string |
No |
Nama layanan basis data tempat aset data berada. Contoh: RDS, PolarDB, dan PolarDB-X. |
RDS |
| ProductId |
integer |
No |
ID layanan basis data. Nilai yang valid:
|
5 |
| SqlText |
string |
No |
Konten pernyataan SQL. |
SELECT * FROM test where name = 'das' |
| ExecuteTimeRange |
string |
No |
Rentang waktu eksekusi, dalam milidetik. |
in[1000 2000] |
| EffectRowRange |
string |
No |
Rentang jumlah baris yang terpengaruh. |
in[1 33] |
| RuleID |
string |
No |
ID aturan. |
9953411 |
| RuleName |
string |
No |
Nama aturan. |
test_rule |
| OperateType |
string |
No |
Jenis operasi. |
Insert |
| OssObjectKey |
string |
No |
Kunci objek OSS. |
N.A |
| AsyncRequestId |
string |
No |
ID permintaan. |
2c548e83-1473-4fda-b3dc-5a189074ead5 |
| PageSize |
integer |
No |
Jumlah maksimum entri yang dikembalikan per halaman. Nilai default adalah 10. |
30 |
| CurrentPage |
integer |
No |
Nomor halaman yang dikembalikan. |
3 |
| RuleCategory |
string |
No |
Jenis aturan. |
10 |
| LoadWhiteList |
boolean |
No |
Menentukan apakah akan mengambil status whitelist. |
false |
| IpType |
string |
No |
Jenis jaringan. Nilai yang valid:
|
aliyun |
| LogSource |
string |
No |
Sumber data. |
SLOW_SQL |
| RuleAggQuery |
boolean |
No |
Apakah akan melakukan kueri agregat. |
true |
| RuleId |
string |
No |
ID aturan. |
867028 |
Elemen respons
|
Element |
Type |
Description |
Example |
|
object |
Parameter respons. |
||
| AsyncRequestId |
string |
ID permintaan. |
3926fba5-1774-44f4-af2d-ac7b33e86c3b |
| CurrentPage |
integer |
Nomor halaman saat ini. |
1 |
| PageSize |
integer |
Jumlah entri per halaman. |
10 |
| RequestId |
string |
ID permintaan. |
A7021857-AFD9-5AD6-979D-AA7DFC5AFADF |
| TotalCount |
integer |
Jumlah total entri. Parameter ini hanya valid untuk Redis. |
12 |
| Items |
array<object> |
Detail log audit. |
|
|
object |
Entri log audit. |
||
| CreationTime |
integer |
Waktu peringatan dibuat, sebagai stempel waktu UNIX dalam milidetik. |
1536751124000 |
| WarnLevel |
string |
Tingkat risiko. Nilai yang valid:
|
1 |
| ClientPort |
string |
Nomor port klien. |
53815 |
| TableName |
string |
Nama tabel. |
it_table |
| EffectRow |
integer |
Jumlah baris yang terpengaruh. |
10 |
| PackageName |
string |
Nama paket MaxCompute. |
test01 |
| UserId |
string |
ID pengguna (UID). |
19********94 |
| Message |
string |
Konten log mentah. |
success |
| RuleId |
string |
ID aturan audit. |
9953411 |
| OperateType |
string |
Jenis operasi. |
Drop |
| LogTime |
integer |
Waktu operasi dieksekusi, sebagai stempel waktu UNIX dalam milidetik. |
1751870592000 |
| WarnLevelName |
string |
Nama tingkat risiko.
|
1 |
| InstanceName |
string |
Alias instans. |
test-instance-003 |
| DatabaseName |
string |
Nama basis data. |
chngc_b2b_migration_sh |
| OssObjectKey |
string |
Kunci objek OSS. |
N.A |
| ExecuteStatus |
integer |
Status eksekusi, di mana 0 menunjukkan kegagalan dan 1 menunjukkan keberhasilan. |
1 |
| ProductId |
integer |
ID layanan basis data. Nilai yang valid:
|
5 |
| ExecuteTime |
integer |
Durasi eksekusi, dalam milidetik. |
1751870592000 |
| UserName |
string |
Nama pengguna. |
admin |
| InstanceDescription |
string |
Deskripsi instans. |
instance dscription |
| RuleName |
string |
Nama aturan audit. |
name |
| ColumnName |
string |
Nama kolom. |
ds |
| ClientIp |
string |
Alamat IP klien. |
100.104.16.251 |
| ClientUa |
string |
Agen pengguna klien. |
mysql |
| Id |
integer |
Kunci utama entri log. |
1 |
| ProductCode |
string |
Nama layanan basis data, seperti RDS, PolarDB, dan PolarDB-X 2.0. |
RDS |
| SqlText |
string |
Pernyataan SQL. |
select * from test03 |
| InWhiteList |
boolean |
Menunjukkan apakah peringatan ada di whitelist. |
True |
| IpType |
string |
Jenis jaringan. Nilai yang valid: default: Layanan non-Alibaba Cloud. Ini adalah default. aliyun: Layanan Alibaba Cloud. |
aliyun |
| RuleCategory |
string |
Kategori aturan. |
10 |
| LogSource |
string |
Sumber data. |
SLOW_SQL |
| InstanceAuditStatus |
string |
Status audit instans. |
2 |
Contoh
Respons sukses
JSONformat
{
"AsyncRequestId": "3926fba5-1774-44f4-af2d-ac7b33e86c3b",
"CurrentPage": 1,
"PageSize": 10,
"RequestId": "A7021857-AFD9-5AD6-979D-AA7DFC5AFADF",
"TotalCount": 12,
"Items": [
{
"CreationTime": 1536751124000,
"WarnLevel": "1",
"ClientPort": "53815",
"TableName": "it_table",
"EffectRow": 10,
"PackageName": "test01",
"UserId": "19********94",
"Message": "success",
"RuleId": "9953411",
"OperateType": "Drop",
"LogTime": 1751870592000,
"WarnLevelName": "1",
"InstanceName": "test-instance-003",
"DatabaseName": "chngc_b2b_migration_sh",
"OssObjectKey": "N.A",
"ExecuteStatus": 1,
"ProductId": 5,
"ExecuteTime": 1751870592000,
"UserName": "admin",
"InstanceDescription": "instance dscription",
"RuleName": "name",
"ColumnName": "ds",
"ClientIp": "100.104.16.251",
"ClientUa": "mysql",
"Id": 1,
"ProductCode": "RDS",
"SqlText": "select * from test03",
"InWhiteList": true,
"IpType": "aliyun",
"RuleCategory": "10",
"LogSource": "SLOW_SQL",
"InstanceAuditStatus": "2"
}
]
}
Kode kesalahan
|
HTTP status code |
Error code |
Error message |
Description |
|---|---|---|---|
| 400 | InvalidParams | The request parameters are invalid. | |
| 403 | NoPermission | You are not authorized to do this action. |
Lihat Error Codes untuk daftar lengkap.
Catatan rilis
Lihat Release Notes untuk daftar lengkap.