[comment]: # translation:outdated

[comment]: # ({119c5103-119c5103})
# > 用户组对象

以下对象与`usergroup` 接口相关.

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

[comment]: # ({3c2e0412-3c2622e5})
### 用户组

用户组对象具有以下属性.

|属性|[类型](/manual/api/reference_commentary#data_types)|描述|
|--------|---------------------------------------------------|-----------|
|usrgrpid|string|*(只读)* 用户组ID.|
|**name**<br>(必需)|string|用户组名称.|
|debug\_mode|integer|是否启用或禁用调试模式.<br><br>可用值:<br>0 - *(default)* 禁用;<br>1 - 启用.|
|gui\_access|integer|组内用户的前端身份验证方法.<br><br>可用值:<br>0 - *(default)* 使用系统默认身份验证方法;<br>1 - 使用内部认证;<br>2 - 使用LDAP认证;<br>3 - 禁止访问前端.|
|users\_status|integer|用户组是启用还是禁用.<br><br>可用值:<br>0 - *(default)* 启用;<br>1 - 禁用.|	

注意，对于某些方法（更新、删除），必需/可选参数组合是不同的。

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

[comment]: # ({fed80d09-ba46c802})
### 权限

权限对象具有以下属性.

|属性|[类型](/manual/api/reference_commentary#data_types)|描述|
|--------|---------------------------------------------------|-----------|
|**id**<br>(required)|string|需要添加权限的主机组的ID.|
|**permission**<br>(required)|integer|对主机组的访问权限级别.<br><br>可用值:<br>0 - 禁止访问权限;<br>2 - 只读访问权限;<br>3 - 读写访问权限.|

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

[comment]: # ({a3618f86-33ad932c})
### 基于标签的权限

基于标签的权限对象具有以下属性.

|属性|[类型](/manual/api/reference_commentary#data_types)|描述|
|--------|---------------------------------------------------|-----------|
|**groupid**<br>(required)|string|要添加权限的主机组的ID.|
|**tag**|string|标签名.|
|**value**|string|标签值.|

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