ApsaraDB for MongoDB örneğinin denetim günlüklerindeki kayıtları sorgular.
Bu işlemi çağırırken örneğin denetim günlüğü özelliğinin etkinleştirildiğinden emin olun. Aksi takdirde, işlem boş bir denetim günlüğü döndürür.
Bu işlem yalnızca genel amaçlı yerel disk ve özel yerel disk örnekleri için geçerlidir.
Bu işlemi dakikada en fazla 30 kez çağırabilirsiniz. Daha yüksek bir sıklıkta çağırmak için Logstore kullanın. Daha fazla bilgi için bkz. Logstore Yönetimi.
Hata Ayıklama
İstek parametreleri
| Parametre | Tür | Gerekli | Örnek | Açıklama |
| Action | String | Evet | DescribeAuditRecords | Gerçekleştirmek istediğiniz işlem. Değeri DescribeAuditRecords olarak ayarlayın. |
| RegionId | String | Hayır | cn-hangzhou | Örneğin bölge kimliği. Örneğin bölge kimliğini sorgulamak için DescribeDBInstanceAttribute işlemini çağırabilirsiniz. |
| DBInstanceId | String | Evet | dds-bp12c5b040dc**** | Örneğin kimliği. Not Bu parametreyi parçalı küme örneğinin kimliğine ayarlarsanız NodeId parametresini de belirtmeniz gerekir. |
| NodeId | String | Hayır | d-bp128a003436**** | Denetim günlüklerini sorgulamak istediğiniz mongos düğümünün veya parça düğümünün örnek içindeki kimliği. Örnek bir parçalı küme örneği ise bu parametreyi belirtmeniz gerekir. Not Bu parametre yalnızca DBInstanceId parametresi bir parçalı küme örneğinin kimliğine ayarlandığında geçerlidir. |
| StartTime | String | Evet | 2019-03-13T12:11:14Z | Sorgulanacak zaman aralığının başlangıcı. Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin. Zaman UTC cinsinden olmalıdır. |
| EndTime | String | Evet | 2019-03-13T13:11:14Z | Denetim günlüğünü sorgulamak için belirtilen zaman aralığının bitişi. Bitiş zamanı başlangıç zamanından sonra olmalıdır. Zamanı yyyy-MM-ddTHH:mm:ssZ biçiminde belirtin. Zaman UTC cinsinden olmalıdır. Not Bitiş zamanı, başlangıç zamanından itibaren 24 saat içinde olmalıdır. Aksi takdirde sorgu başarısız olur. |
| Database | String | Hayır | testdatabase | Sorgulanacak veritabanının adı. Varsayılan olarak tüm veritabanları sorgulanır. |
| User | String | Hayır | root | Veritabanı kullanıcısı. Bu parametreyi belirtmezseniz bu işlem tüm kullanıcıların kayıtlarını döndürür. |
| Form | String | Hayır | Stream | İşlemin döndürdüğü denetim günlüğünün biçimi. Geçerli değerler:
Varsayılan değer: Stream. |
| QueryKeywords | String | Hayır | slow | Sorgular için kullanılan anahtar sözcükler. Birden fazla anahtar sözcüğü boşlukla ayırın. Maksimum anahtar sözcük sayısı 10'dur. |
| PageSize | Integer | Hayır | 30 | Her sayfada döndürülecek kayıt sayısı. Geçerli değerler: 30, 50 ve 100. Varsayılan değer: 30. |
| PageNumber | Integer | Hayır | 1 | Döndürülecek sayfanın numarası. Değer 0'dan büyük bir tamsayı olmalıdır. Varsayılan değer: 1. |
| OrderType | String | Hayır | asc | Döndürülecek günlük kayıtlarının sıralandığı zaman düzeni. Geçerli değerler:
|
Yanıt parametreleri
| Parametre | Tür | Örnek | Açıklama |
| TotalRecordCount | Integer | 40 |
|
| PageRecordCount | Integer | 30 |
|
| RequestId | String | 3278BEB8-503B-4E46-8F7E-D26E040C9769 |
|
| PageNumber | Integer | 1 |
|
| Items | SQLRecord dizisi |
|
|
| SQLRecord | |||
| HostAddress | String | 11.xxx.xxx.xxx |
|
| TableName | String | C1 |
|
| ReturnRowCounts | Long | 2 |
|
| DBName | String | test123 |
|
| ExecuteTime | String | 2019-03-11T03:30:27Z |
|
| ThreadID | String | 140682188297984 |
|
| TotalExecutionTimes | Long | 700 |
|
| Syntax | String | { \"atype\" : \"createCollection\", \"param\" : { \"ns\" : \"123.test1\" }, \"result\": \"OK\" } |
|
| AccountName | String | root |
|
Örnekler
Örnek istekler
http(s)://mongodb.aliyuncs.com/?Action=DescribeAuditRecords
&StartTime=2019-03-13T12:11:14Z
&EndTime=2019-03-13T13:11:14Z
&DBInstanceId=dds-bp12c5b040dc****
&<Common request parameters>
Başarılı yanıt örnekleri
XML biçimi
HTTP/1.1 200 OK
Content-Type:application/xml
<?xml version="1.0" encoding="UTF-8" ?>
<DescribeAuditRecordsResponse>
<Items>
<SQLRecord>
<TotalExecutionTimes>703</TotalExecutionTimes>
<Syntax>{ "atype" : "command", "param" : { "command" : "find", "ns" : "123.test1", "args" : { "find" : "test1", "filter" : { "x" : 1, "y" : 2 }, "shardVersion" : [ { "$timestamp" : { "t" : 0, "i" : 0 } }, { "$oid" : "000000000000000000000000" } ], "$clusterTime" : { "clusterTime" : { "$timestamp" : { "t" : 1552275017, "i" : 2 } }, "signature" : { "hash" : { "$binary" : "9qfygDs61fKCvdXJqjq+f0zML0E=", "$type" : "00" }, "keyId" : { "$numberLong" : "6666955498811555841" } } }, "$client" : { "application" : { "name" : "MongoDB Shell" }, "driver" : { "name" : "MongoDB Internal Client", "version" : "3.4.10" }, "os" : { "type" : "Linux", "name" : "Ubuntu", "architecture" : "x86_64", "version" : "16.04" }, "mongos" : { "host" : "rxxxxxx.cloud.cm10:3074", "client" : "47.xxx.xxx.xx:53854", "version" : "4.0.0" } }, "$configServerState" : { "opTime" : { "ts" : { "$timestamp" : { "t" : 1552275017, "i" : 2 } }, "t" : { "$numberLong" : "3" } } }, "$db" : "123" } }, "result": "OK" }</Syntax>
<HostAddress>11.xxx.xxx.xx</HostAddress>
<ExecuteTime>2019-03-11T03:30:27Z</ExecuteTime>
<ThreadID>139xxxxxxxx</ThreadID>
<AccountName>__system;</AccountName>
<DBName>local;</DBName>
</SQLRecord>
<SQLRecord>
<TotalExecutionTimes>0</TotalExecutionTimes>
<Syntax>{ "atype" : "createIndex", "param" : { "ns" : "123.test1", "indexName" : "y_1", "indexSpec" : { "v" : 2, "key" : { "y" : 1 }, "name" : "y_1", "ns" : "123.test1" } }, "result": "OK" }</Syntax>
<HostAddress></HostAddress>
<ExecuteTime>2019-03-11T03:30:06Z</ExecuteTime>
<ThreadID>140xxxxxxxx</ThreadID>
<AccountName>__system;</AccountName>
<DBName>local;</DBName>
</SQLRecord>
</Items>
<PageNumber>1</PageNumber>
<TotalRecordCount>2</TotalRecordCount>
<RequestId>3278BEB8-503B-4E46-8F7E-D26E040C9769</RequestId>
<PageRecordCount>30</PageRecordCount>
</DescribeAuditRecordsResponse>
JSON biçimi
HTTP/1.1 200 OK
Content-Type:application/json
{
"Items" : {
"SQLRecord" : [ {
"TotalExecutionTimes" : 703,
"Syntax" : "{ \"atype\" : \"command\", \"param\" : { \"command\" : \"find\", \"ns\" : \"123.test1\", \"args\" : { \"find\" : \"test1\", \"filter\" : { \"x\" : 1, \"y\" : 2 }, \"shardVersion\" : [ { \"$timestamp\" : { \"t\" : 0, \"i\" : 0 } }, { \"$oid\" : \"000000000000000000000000\" } ], \"$clusterTime\" : { \"clusterTime\" : { \"$timestamp\" : { \"t\" : 1552275017, \"i\" : 2 } }, \"signature\" : { \"hash\" : { \"$binary\" : \"9qfygDs61fKCvdXJqjq+f0zML0E=\", \"$type\" : \"00\" }, \"keyId\" : { \"$numberLong\" : \"6666955498811555841\" } } }, \"$client\" : { \"application\" : { \"name\" : \"MongoDB Shell\" }, \"driver\" : { \"name\" : \"MongoDB Internal Client\", \"version\" : \"3.4.10\" }, \"os\" : { \"type\" : \"Linux\", \"name\" : \"Ubuntu\", \"architecture\" : \"x86_64\", \"version\" : \"16.04\" }, \"mongos\" : { \"host\" : \"rxxxxxx.cloud.cm10:3074\", \"client\" : \"47.xxx.xxx.xx:53854\", \"version\" : \"4.0.0\" } }, \"$configServerState\" : { \"opTime\" : { \"ts\" : { \"$timestamp\" : { \"t\" : 1552275017, \"i\" : 2 } }, \"t\" : { \"$numberLong\" : \"3\" } } }, \"$db\" : \"123\" } }, \"result\": \"OK\" }",
"HostAddress" : "11.xxx.xxx.xxx",
"ExecuteTime" : "2019-03-11T03:30:27Z",
"ThreadID" : "139xxxxxxxx",
"AccountName" : "__system;",
"DBName" : "local;"
}, {
"TotalExecutionTimes" : 0,
"Syntax" : "{ \"atype\" : \"createIndex\", \"param\" : { \"ns\" : \"123.test1\", \"indexName\" : \"y_1\", \"indexSpec\" : { \"v\" : 2, \"key\" : { \"y\" : 1 }, \"name\" : \"y_1\", \"ns\" : \"123.test1\" } }, \"result\": \"OK\" }",
"HostAddress" : "",
"ExecuteTime" : "2019-03-11T03:30:06Z",
"ThreadID" : "140xxxxxxxx",
"AccountName" : "__system;",
"DBName" : "local;"
} ]
},
"PageNumber" : 1,
"TotalRecordCount" : 2,
"RequestId" : "3278BEB8-503B-4E46-8F7E-D26E040C9769",
"PageRecordCount" : 30
}
Hata kodları
| Http Kodu | Hata Kodları | Hata Mesajı | Açıklama |
| 400 | InvalidEndTime.Format | Specified end time is not valid. | Belirtilen EndTime parametresi geçersiz olduğu için döndürülen hata mesajı. Zamanı yyyy-MM-ddTHH:mmZ biçiminde belirtin. Zaman UTC cinsinden olmalıdır. Bitiş zamanı başlangıç zamanından sonra olmalıdır. |
Hata kodlarının listesi için API Hata Merkezi adresini ziyaret edin.