[comment]: # translation:outdated

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

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

[comment]: # ({9ff01301-002826bb})
### Описание

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

Метод позволяет получить записи журнала аудита в соответствии с заданными
параметрами.

::: noteclassic
Этот метод доступен только пользователю с типом доступа *Супер-администратор*.
Разрешения на вызов метода можно отозвать в настройках ролей пользователя.
Дополнительную информацию см. в разделе [Роли пользователей](/manual/web_interface/frontend_sections/users/user_roles).
:::

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

[comment]: # ({c51dee7e-c9891e0d})
### Параметры

`(объект)` Параметры, определяющие желаемый результат.

Метод поддерживает следующие параметры.

|Параметр|[Тип](/manual/api/reference_commentary#data_types)|Описание|
|--|--|------|
|auditids|string/array|Возвращает только журнал аудита с указанными идентификаторами.|
|userids|string/array|Возвращает только журнал аудита созданный указанными пользователями.|
|time\_from|timestamp|Возвращает только те записи журнала аудита, которые были созданы после или в указанное время.|
|time\_till|timestamp|Возвращает только те записи журнала аудита, которые были созданы до или в указанное время.|
|sortfield|string/array|Сортировать результат по заданным свойствам.<br><br>Возможные значения: `auditid`, `userid`, `clock`.|
|filter|object|Возвращает только те результаты, которые точно соответствуют заданному фильтру.<br><br>Принимает массив где ключами являются имена свойств, а значениями являются либо одно значение, либо массив значений для сопоставления.<br><br>Дополнительно поддерживает фильтрацию по полям свойств деталей: `table_name`, `field_name`.|
|search|object|Нечувствительный к регистру поиск подстроки в содержимом полей: `username`, `ip`, `resourcename`, `details`.|
|countOutput|boolean|Эти параметры являются общими для всех методов `get` и описаны в [справочном комментарии](/manual/api/reference_commentary#common_get_method_parameters).|
|excludeSearch|boolean|^|
|limit|integer|^|
|output|query|^|
|preservekeys|boolean|^|
|searchByAny|boolean|^|
|searchWildcardsEnabled|boolean|^|
|sortorder|string/array|^|
|startSearch|boolean|^|

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

[comment]: # ({7223bab1-7223bab1})
### Возвращаемые значения

`(integer/array)` Возвращает:

- · массив объектов;
- · количество извлеченных объектов, если использовался параметр `countOutput`.

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

[comment]: # ({b41637d2-b41637d2})
### Примеры

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

[comment]: # ({c629770d-66670b26})
#### Получить audit log

Получить две последние записи журнала аудита.

Request:

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

Response:

```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]: # ({/c629770d-66670b26})

[comment]: # ({e2b9a859-e2b9a859})
### Смотрите также

- · [Audit log object](/manual/api/reference/auditlog/object)

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

[comment]: # ({11b31975-11b31975})
### Источник

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

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