---
canonical: https://docs.ideco.ru/v22/ru/ngfw/api/application-control-api
---



# Профили контроля приложений

::: page-constructor
blocks:
  - type: content-layout-block
    textContent:
      buttons:
        - text: Классический VCE
          theme: action
          width: 'auto'
        - text: Высокопроизводительный VCE
          theme: outlined
          url: https://docs.ideco.ru/api/vpp-v22/ru/ngfw/application-control/
          width: 'auto'
        - text: Документация
          theme: outlined
          url: https://docs.ideco.ru/v22/ru/ngfw/settings/security-profiles/application-control/
          width: 'auto'
    resetPaddings: false
    textWidth: l
    size: m
    centered: false
:::

{% cut "Получение статуса службы" %}{#app-status}

#|
|| GET | `/api/application_control/status` ||
|#

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

```json5
{
    "name": "string",
    "status": "active" | "activating" | "deactivating" | "failed" | "inactive" | "reloading",
    "msg": [ "string" ]
}
```

#|
|| **Параметр** | **Тип** | **Описание** ||
|| `name` | string | Название службы ||
|| `status` | string | Текущий статус модуля:

- `active` - включен
- `activating` - включается
- `deactivating` - выключается
- `failed` - произошла ошибка
- `inactive` - выключен
- `reloading` - перезагрузка

||
|| `msg` | string | Список строк, поясняющих текущее состояние службы. Может быть пустым ||
|#

{% endcut %}

{% cut "Получение состояния модуля" %}{#app-state}

#|
|| GET | `/api/application_control/state` ||
|#

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

{% include [состояние модуля](state.md) %}

{% endcut %}

{% cut "Управление состоянием модуля" %}{#app-state-edit}

#|
|| PATCH | `/api/application_control/state` ||
|#

### Json-тело запроса

{% include [состояние модуля](state.md) %}

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

```json5
{
     "enabled": true | false
}
```

{% endcut %}

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

```
GET /api/application_control/profiles
```

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

```json5
[
  {
    "id": "string",
    "name": "string",
    "comment": "string",
    "protocols": [
      {
        "id": "string",
        "action": "deny" | "allow"
      },
      ...
    ],
    "from_central_console": true | false
  }
]
```

* `id` - идентификатор профиля;
* `name` - название профиля;
* `comment` - комментарий к профилю;
* `protocols` - список протоколов, выбранных для профиля:
  * `id` - идентификатор алиаса протокола с префиксом `id.l7`. Например, `id.l7.ftp_protocol`;
  * `action` - действие, применяемое к протоколу:
    * `deny` - запретить;
    * `allow` - разрешить.
* `from_central_console` - профиль создан в Ideco Center и доступен только для чтения:
  * `true` - создан;
  * `false` - не создан.

{% endcut %}

{% cut "Создание профиля" %}

```
POST /api/application_control/profiles
```

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

```json5

{
  "name": "string",
  "comment": "string",
  "protocols": [
    {
      "id": "string",
      "action": "deny" | "allow"
    },
    ...
    ],
  "from_central_console": true | false
}
```

* `name` - название профиля;
* `comment` - комментарий к профилю;
* `protocols` - список протоколов, выбранных для профиля:
  * `id` - идентификатор алиаса протокола с префиксом `id.l7`. Например, `id.l7.ftp_protocol`;
  * `action` - действие, применяемое к протоколу:
    * `deny` - запретить,
    * `allow` - разрешить.
* `from_central_console` - профиль создан в Ideco Center и доступен только для чтения:
  * `true` - создан;
  * `false` - не создан.

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

```json5
[
  {
    "id": "string",
    "name": "string",
    "comment": "string",
    "protocols": [
      {
        "id": "string",
        "action": "deny" | "allow"
      },
      ...
      ],
    "from_central_console": true | false
  }
]
```

* `id` - идентификатор профиля;
* `name` - название профиля;
* `comment` - комментарий к профилю;
* `protocols` - список протоколов, выбранных для профиля:
  * `id` - идентификатор алиаса протокола с префиксом `id.l7`. Например, `id.l7.ftp_protocol`;
  * `action` - действие, применяемое к протоколу:
    * `deny` - запретить;
    * `allow` - разрешить.
* `from_central_console` - профиль создан в Ideco Center и доступен только для чтения:
  * `true` - создан;
  * `false` - не создан.

{% endcut %}

{% cut "Копирование профиля" %}

```
POST /api/application_control/profiles/<id профиля>/copy
```

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

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

* `id` - идентификатор копии профиля.

{% endcut %}

{% cut "Редактирование профиля" %}

```
PATCH /api/application_control/profiles/<id профиля>
```

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

```json5
[
  {
    "name": "string",
    "comment": "string",
    "protocols": [
      {
        "id": "string",
        "action": "deny" | "allow"
      },
      ...
      ],
    "from_central_console": true | false
  }
]
```

* `name` - название профиля;
* `comment` - комментарий к профилю;
* `protocols` - список протоколов, выбранных для профиля:
  * `id` - идентификатор алиаса протокола с префиксом `id.l7`. Например, `id.l7.ftp_protocol`;
  * `action` - действие, применяемое к протоколу:
    * `deny` - запретить;
    * `allow` - разрешить.
* `from_central_console` - профиль создан в Ideco Center и доступен только для чтения:
  * `true` - создан;
  * `false` - не создан.

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

{% endcut %}

{% cut "Удаление профиля" %}

```
DELETE /api/application_control/profiles/<id профиля>
```

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

{% endcut %}
