Create User and Choose Organization¶
创建用户并为该用户分配组织。
操作权限¶
需要在 EnOS 应用门户给应用授权“在本 OU 创建或删除用户账号”的权限。
请求格式¶
POST https://{apigw-address}/app-portal-service/v2.3/user/createAndJoinOrg
请求参数(Query)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
orgId |
必需 |
String |
组织 ID。 |
请求参数(Body)¶
名称 |
必需/可选 |
数据类型 |
描述 |
---|---|---|---|
name |
必需 |
String |
用户名。 |
domain |
必需 |
String |
域账号对应的域在 EnOS 应用门户里注册的名称。 - 如需创建域账号,为该参数指定一个域 - 如需创建非域账号,为该参数输入空字符串 |
必需 |
String |
用户的邮箱。 |
|
organizationId |
必需 |
String |
给用户分配的组织的 ID。如何获取 organizationId 信息>>。 |
locale |
可选 |
String |
语言代码。默认为中文。
|
nickName |
可选 |
String |
用户的昵称。 |
响应参数¶
名称 |
数据类型 |
描述 |
---|---|---|
userId |
String |
新建用户的 ID。 |
错误码¶
代码 |
描述 |
---|---|
31400 |
组织 ID 为空,用户名为空,邮箱为空,应用无效等。 |
31403 |
应用未被授予“在本 OU 创建或删除用户账号”的权限。 |
31404 |
组织或域不存在。 |
示例¶
请求示例¶
url: https://{apigw-address}/app-portal-service/v2.3/user/createAndJoinOrg?orgId=your_org_id
method: POST
requestBody:
{
"organizationId": "your_structure_id",
"nickName": "your_nickname",
"domain": "your_domain",
"name": "your_user_name",
"locale": "en_US",
"email": "your_email"
}
返回示例¶
{
"code": 0,
"message": "OK",
"data": {
"userId": "your_user_id"
}
}