> User group object

The following objects are directly related to the usergroup API.

User group

The user group object has the following properties.

PropertyTypeDescription
usrgrpidstringID of the user group.

Property behavior:
- read-only
- required for update operations
namestringName of the user group.

Property behavior:
- required for create operations
debug_modeintegerWhether debug mode is enabled or disabled.

Possible values:
0 - (default) disabled;
1 - enabled.
gui_accessintegerFrontend authentication method of the users in the group.

Possible values:
0 - (default) use the system default authentication method;
1 - use internal authentication;
2 - use LDAP authentication;
3 - disable access to the frontend.
users_statusintegerWhether the user group is enabled or disabled.
For deprovisioned users, the user group cannot be enabled.

Possible values:
0 - (default) enabled;
1 - disabled.
userdirectoryidstringUser directory used for authentication.

Property behavior:
- supported if gui_access is set to “use the system default authentication method” or “use LDAP authentication”

Permission

The permission object has the following properties.

PropertyTypeDescription
idstringID of the host group or template group to add permission to.

Property behavior:
- required
permissionintegerAccess level to the host group or template group.

Possible values:
0 - access denied;
2 - read-only access;
3 - read-write access.

Property behavior:
- required for create operations

Tag-based permission

The tag-based permission object has the following properties.

PropertyTypeDescription
groupidstringID of the host group to add permission to.

Property behavior:
- required
tagstringTag name.
valuestringTag value.