Documentation
Table of Contents
auditlog.get
Descripción
integer/array auditlog.get(object parameters)
El método permite recuperar registros de auditoría de acuerdo con los parámetros suministrados.
Este método solo está disponible para el tipo de usuario Super administrador. Los permisos para llamar al método se pueden revocar en la configuración de roles de usuario. Para más información, ver Roles de usuario.
Parámetros
(objeto) Parámetros que definen la salida deseada.
El método admite los siguientes parámetros.
| Parámetro | Tipo | Descripción |
|---|---|---|
| auditids | ID/array | Devolver solo el registro de auditoría con los IDs dados. |
| userids | ID/array | Devolver solo el registro de auditoría que fue creado por los usuarios dados. |
| time_from | timestamp | Devuelve solo las entradas del registro de auditoría que se hayan creado después o en el momento dado. |
| time_till | timestamp | Devuelve solo las entradas del registro de auditoría que se hayan creado antes o en el momento dado. |
| sortfield | string/array | Ordena el resultado por las propiedades dadas. Valores posibles: auditid, userid, clock. |
| countOutput | booleano | Estos parámetros se describen en el comentario de referencia. |
| excludeSearch | booleano | |
| filter | objeto | |
| limit | entero | |
| output | consulta | |
| preservekeys | booleano | |
| search | objeto | |
| searchByAny | booleano | |
| searchWildcardsEnabled | booleano | |
| sortorder | string/array | |
| startSearch | booleano |
Valores devueltos
(integer/array) Devuelve cualquiera de los dos:
- Una matriz (array) de objetos;
- El número de objetos devueltos, si se ha usado el parámetro
countOutput.
Ejemplos
Recuperar registro de auditoría
Recupere los dos registros de auditoría más recientes.
{
"jsonrpc": "2.0",
"method": "auditlog.get",
"params": {
"output": "extend",
"sortfield": "clock",
"sortorder": "DESC",
"limit": 2
},
"id": 1
}Respuesta:
{
"jsonrpc": "2.0",
"result": [
{
"auditid": "cksstgfam0001yhdcc41y20q2",
"userid": "1",
"username": "Admin",
"clock": "1629975715",
"ip": "127.0.0.1",
"action": "1",
"resourcetype": "0",
"resourceid": "0",
"resourcename": "Jim",
"recordsetid": "cksstgfal0000yhdcso67ondl",
"details": "{\"user.name\":[\"update\",\"Jim\",\"\"],\"user.medias[37]\":[\"add\"],\"user.medias[37].\":[\"add\"],\"user.medias[37].mediatypeid\":[\"add\",\"1\"],\"user.medias[37].sendto\":[\"add\",\"[email protected]\"]}"
},
{
"auditid": "ckssofl0p0001yhdcqxclsg8r",
"userid": "1",
"username": "Admin",
"clock": "1629967278",
"ip": "127.0.0.1",
"action": "0",
"resourcetype": "0",
"resourceid": "20",
"resourcename": "John",
"recordsetid": "ckssofl0p0000yhdcpxyo1jgo",
"details": "{\"user.username\":[\"add\",\"John\"], \"user.userid:\":[\"add\",\"20\"],\"user.usrgrps[28]\":[\"add\"],\"user.usrgrps[28].usrgrpid\":[\"add\", \"7\"]}"
}
],
"id": 1
}Ver también
Fuente
CAuditLog::get() en ui/include/classes/api/services/CAuditLog.php.