[comment]: # ({668456d1-668456d1})
# auditlog.get

[comment]: # ({/668456d1-668456d1})

[comment]: # ({9ff01301-002826bb})
### Descripción

`integer/array auditlog.get(object parameters)`

El método permite recuperar registros de auditoría de acuerdo con los
parámetros suministrados.

::: noteclassic
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](/manual/web_interface/frontend_sections/users/user_roles).
:::

[comment]: # ({/9ff01301-002826bb})

[comment]: # ({003418b4-c9891e0d})
### Parámetros

`(objeto)` Parámetros que definen la salida deseada.

El método admite los siguientes parámetros.

|Parámetro|[Tipo](/manual/api/reference_commentary#data_types)|Descripción|
|--|--|------|
|auditids|cadena/matriz|Devuelve solo el registro de auditoría con los ID proporcionados.|
|userids|cadena/matriz|Devuelve solo el registro de auditoría creado por los usuarios indicados.|
|time\_from|timestamp|Devuelve sólo las entradas del registro de auditoría que se han creado después o en el momento indicado.|
|time\_till|timestamp|Devuelve sólo 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.<br><br>Valores posibles: `auditid`, `userid`, `clock`.|
|filter|objeto|Devuelve sólo resultados que coincidan exactamente con el filtro dado.<br><br>Acepta una matriz, donde las claves son nombres de propiedades y los valores son un valor único o una matriz de valores con los que comparar.|
|search|objeto|Búsqueda de subcadenas que no distingue entre mayúsculas y minúsculas en el contenido de los campos: `username`, `ip`, `resourcename`, `details`excludeSearch.|
|countOutput|boolean|Estos parámetros, que son comunes para todos los métodos `get`, se describen en el [comentario de referencia](/manual/api/reference_commentary#common_get_method_parameters).|
|excludeSearch|booleano|^|
|limit|entero|^|
|output|consulta|^|
|preservekeys|booleano|^|
|searchByAny|booleano|^|
|searchWildcardsEnabled|booleano|^|
|sortorderstartSearch|cadena/matriz|^|
|sortorder|booleano|^|

[comment]: # ({/003418b4-c9891e0d})

[comment]: # ({7223bab1-7223bab1})
### 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`.

[comment]: # ({/7223bab1-7223bab1})

[comment]: # ({b41637d2-b41637d2})
### Ejemplos

[comment]: # ({/b41637d2-b41637d2})

[comment]: # ({b5488298-66670b26})
#### Recuperar registro de auditoría

Recupere los dos registros de auditoría más recientes.

[Solicitud](/manual/api#performing-requests):

```json
{
"jsonrpc": "2.0",
"method": "auditlog.get",
"params": {
"output": "extend",
"sortfield": "clock",
"sortorder": "DESC",
"limit": 2
},
"id": 1
}
```

Respuesta:

```json
{
"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\",\"support123@company.com\"]}"
},
{
"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
}
```

[comment]: # ({/b5488298-66670b26})

[comment]: # ({e2b9a859-e2b9a859})
### Ver también

-   [Objeto de Log de Auditoría](/manual/api/reference/auditlog/object)

[comment]: # ({/e2b9a859-e2b9a859})

[comment]: # ({11b31975-11b31975})
### Fuente

CAuditLog::get() en *ui/include/classes/api/services/CAuditLog.php*.

[comment]: # ({/11b31975-11b31975})