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/matriz Devuelve solo el registro de auditoría con los ID proporcionados.
userids ID/matriz Devuelve solo el registro de auditoría creado por los usuarios indicados.
time_from marca de tiempo Devuelve sólo las entradas del registro de auditoría que se han creado después o en el momento indicado.
time_till marca de tiempo Devuelve solo las entradas del registro de auditoría que se han creado antes o en el momento dado.
sortfield cadena/matriz Ordena el resultado según las propiedades dadas.

Valores posibles: auditid, userid, clock.
countOutput booleano Estos parámetros, que son comunes para todos los métodos get, se describen en el comentario de referencia.
excludeSearch booleano
filter objeto
limit entero
output consulta
preservekeys booleano
search objeto
searchByAny booleano
searchWildcardsEnabled booleano
sortorder cadena/matriz
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.

Solicitud:

{
       "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.