[comment]: # aside: 1

[comment]: # ({4ed090ac-119c5103})
# Объект группы пользователей

Следующие объекты напрямую связаны с API `usergroup`.

[comment]: # ({/4ed090ac-119c5103})

[comment]: # ({88416027-3c2622e5})
### Группа пользователей

Объект группы пользователей имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|usrgrpid|ID|ID группы пользователей.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *только для чтения*<br>- *обязательно* для операций обновления|
|name|string|Имя группы пользователей.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *обязательно* для операций создания|
|debug\_mode|integer|Включен или отключен режим отладки.<br><br>Возможные значения:<br>0 - *(по умолчанию)* отключен;<br>1 - включен.|
|gui\_access|integer|Метод аутентификации веб-интерфейса для пользователей в группе.<br><br>Возможные значения:<br>0 - *(по умолчанию)* использовать метод аутентификации по умолчанию системы;<br>1 - использовать внутреннюю аутентификацию;<br>2 - использовать аутентификацию LDAP;<br>3 - запретить доступ к веб-интерфейсу.|
|mfa\_status|integer|Включена или отключена MFA для пользователей в группе.<br><br>Возможные значения:<br>0 - отключена (для всех настроенных методов MFA);<br>1 - включена (для всех настроенных методов MFA).|
|mfaid|ID|[Метод MFA](/manual/api/reference/mfa/object), используемый для пользователей в группе.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *поддерживается* для пользователей типа *Super admin*<br>- *поддерживается*, если `mfa_status` [объекта аутентификации](/manual/api/reference/authentication/object#authentication) установлен в "Enabled"|
|users\_status|integer|Включена или отключена группа пользователей.<br>Для пользователей, [deprovisioned](/manual/web_interface/frontend_sections/users/authentication#configuration), группу пользователей нельзя включить.<br><br>Возможные значения:<br>0 - *(по умолчанию)* включена;<br>1 - отключена.|
|userdirectoryid|ID|ID каталога пользователей, используемого для аутентификации.<br><br>[Поведение свойства](/manual/api/reference_commentary#property-behavior):<br>- *поддерживается* для пользователей типа *Super admin*<br>- *поддерживается*, если `gui_access` установлен в "use the system default authentication method" или "use LDAP authentication"|

[comment]: # ({/88416027-3c2622e5})

[comment]: # ({28634bb8-ba46c802})
### Разрешение

Объект разрешения имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|id|ID|ID группы узлов сети или группы шаблонов, к которой нужно добавить разрешение.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|permission|integer|Уровень доступа к группе узлов сети или группе шаблонов.<br><br>Возможные значения:<br>0 - доступ запрещен;<br>2 - доступ только для чтения;<br>3 - доступ для чтения и записи.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required* для операций создания|

[comment]: # ({/28634bb8-ba46c802})

[comment]: # ({fe7438fa-33ad932c})
### Разрешение на основе тегов

Объект разрешения на основе тегов имеет следующие свойства.

|Property|[Type](/manual/api/reference_commentary#data-types)|Description|
|--|--|------|
|groupid|ID|ID группы узлов сети, для которой нужно добавить разрешение.<br><br>[Property behavior](/manual/api/reference_commentary#property-behavior):<br>- *required*|
|tag|string|Имя тега.|
|value|string|Значение тега.|

[comment]: # ({/fe7438fa-33ad932c})