---
canonical: https://docs.ideco.ru/v22/ru/ngfw/api/admin-ald-api
---


# Администраторы ALD

::: page-constructor
blocks:
  - type: content-layout-block
    textContent:
      buttons:
        - text: Классический VCE
          theme: action
          width: 'auto'
        - text: Документация
          theme: outlined
          url: https://docs.ideco.ru/v22/ru/ngfw/settings/server-management/admins
          width: 'auto'
    resetPaddings: false
    textWidth: l
    size: m
    centered: false
:::

{% cut "Получение списка правил" %}

```
GET /web/admins/ald?format_type=JSON|CSV&columns=["id","enabled",...]
```

**Параметры запроса:**

* `format_type` - поддерживается `CSV` и `JSON`, по умолчанию `JSON`;
* `columns` - список столбцов, которые попадут в `CSV` отчет, по умолчанию пустой список.

**Ответ на успешный запрос:**

```json5
[
    {
        "id": "string",
        "enabled": true | false,
        "role": "integer",
        "group_alias": "string",
        "comment": "string"
    },
    ...
]
```

* `id` - идентификатор правила;
* `enabled` - правило включено/выключено (можно/нельзя по нему зайти в систему);
* `role` - идентификатор уровня доступа администратора;
* `group_alias` - группа безопасности;
* `comment` - комментарий.

{% endcut %}

{% cut "Добавление правил" %}

```
POST /web/admins/ald
```

**Json-тело запроса:**

```json5
{
    "enabled": true | false,
    "role": "integer",
    "group_alias": "string",
    "comment": "string"
}
```

* `enabled` - правило включено/выключено (можно/нельзя по нему зайти в систему);
* `role` - идентификатор уровня доступа администратора;
* `group_alias` - группа безопасности. Тип группы должен соответствовать типу домена;
* `comment` - комментарий, максимальная длина - 255 символов. Может быть пустым.

**Ответ на успешный запрос:**

```json5
{
    "id": "string"
}
```

{% endcut %}

{% cut "Изменение правил" %}

```
PATCH /web/admins/ald/<id правила>
```

**Json-тело запроса:**

```json5
{
    "enabled": true | false,
    "role": "integer",
    "group_alias": "string",
    "comment": "string"
}
```

* `enabled` - правило включено/выключено (можно/нельзя по нему зайти в систему);
* `role` - идентификатор уровня доступа администратора;
* `group_alias` - группа безопасности. Тип группы должен соответствовать типу домена;
* `comment` - комментарий, максимальная длина - 255 символов. Может быть пустым.

**Ответ на успешный запрос:** 200 OK

{% endcut %}

{% cut "Удаление правил" %}

```
DELETE /web/admins/ald/<id правила>
```

**Ответ на успешный запрос:** 200 OK

{% endcut %}
