Assign User Roles

不登录 EnOS 应用门户的状态下给用户分配角色。

调用此 API 更新用户角色时,将覆盖用户的已有角色,如有需要,可先使用 `Get User Roles </docs/app-portal-api/zh_CN/dev/user_and_ou/get_user_roles.html>`__API 查询用户的已有角色。

操作权限

需要在 EnOS 应用门户给应用授权“在本 OU 给用户授权”的权限。

请求格式

POST https://{apigw-address}/app-portal-service/v2.2/role/appendRoles

请求参数(Body)

名称

必需/可选

数据类型

描述

organizationId

必需

String

组织 ID。如何获取 organizationId 信息>>

userId

必需

String

用户 ID。

roleIds

必需

List

要给用户分配的角色 ID。

响应参数

名称

数据类型

描述

data

Boolean

true 表示分配成功,false 表示分配失败。

错误码

代码

描述

31400

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

31403

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

31404

未找到组织

示例

请求示例

url: https://{apigw-address}/app-portal-service/v2.2/role/appendRoles

method: POST

requestBody:
{"organizationId":"yourOrgId", "userId":"yourUserId","roleIds": ["role1","role2","role3"]}

返回示例

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