Assign User Groups


给用户分配用户组,可一次分配多个用户组。

前提条件


应用需拥有“在本 OU 给用户授权”的权限。如有需要,联系 OU 管理员获取权限。

请求格式


POST https://{apigw-address}/app-portal-service/v2.2/userGroup/appendUserGroups

请求参数(Body)


名称

必需/可选

数据类型

描述

organizationId

必需

String

OU ID。如何获取 organizationId 信息 >>

userId

必需

String

用户 ID。如何获取 userId 信息 >>

userGroupIds

必需

List

要给用户分配的用户组 ID 列表。

响应参数


名称

数据类型

描述

data

Boolean

用户组是否分配成功。true 表示分配成功,false 表示分配失败。

错误码


代码

描述

31400

参数错误,长度错误,不能为空等。

31403

应用未被授予“在本 OU 给用户授权”的权限。

31404

未找到 OU。

示例

请求示例


url: https://{apigw-address}/app-portal-service/v2.2/userGroup/appendUserGroups

method: POST

requestBody:
{"organizationId":"yourOrgId", "userId":"yourUserId","userGroupIds": ["ug1","ug2","ug3"]}

返回示例


{
  "code": 0,
  "message": "OK",
  "data": true
}