员工身份(EIAM)
 修改应用机构
   接口
 # 权限
身份管理API是以应用维度授权的,在调用接口前需为不同的应用设置接口权限,详情请参考API权限。
| 权限代码 | 描述 | 
|---|---|
| app_org_all | 应用机构管理接口的读写权限 | 
| all | 全部接口读写权限 | 
# 请求说明
PUT https://{your_domain}/api/v2/tenant/applications/{app_id}/organizations/{app_org_id}
# 请求头
| 参数名 | 中文名称 | 必须 | 类型 | 描述 | 
|---|---|---|---|---|
| Authorization | 授权 | 是 | String | 格式:Bearer {access_token} | 
| Content-Type | 内容类型 | 是 | String | 固定值:application/json; charset=utf-8 | 
# 请求示例
{
    "name": "虚拟机构2",
    "parent_id": ""
}
1
2
3
4
2
3
4
# 请求参数
| 参数名 | 中文名称 | 必须 | 类型 | 描述 | 
|---|---|---|---|---|
| app_id | 应用ID | 是 | String | 目标应用ID | 
| app_org_id | 应用机构ID | 是 | String | 目标应用机构ID | 
| name | 应用机构名称 | 否 | String | |
| parent_id | 父节点ID | 否 | String | 
# 返回示例
正确示例:
HTTP/1.1 200 OK
{
    "org_id": "20220414151855146-A153-62C1A994C"
}
错误示例:
HTTP/1.1 400 Bad Request
{
    "error_code": " APP.ORG.0040,
    "error_msg": "父机构不存在"
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
# 返回参数
| 参数名 | 中文名称 | 类型 | 描述 | 
|---|---|---|---|
| org_id | 应用机构ID | String | 
# 错误码
| 状态码 | 错误码 | 错误信息 | 处理措施 | 
|---|---|---|---|
| 400 | APP.ORG.0040 | 父机构不存在 | 请检查父机构是否已被删除 | 
| The parent application organization does not exist | |||
| 400 | APP.0001 | 应用不存在 | 请检查应用是否已被删除 | 
| App does not exist | |||
| 400 | APP.ORG.0024 | 应用机构不存在 | 请检查应用机构是否已被删除 | 
| The application organization does not exist | |||
| 400 | APP.ORG.0041 | 只能修改创建的虚拟组织 | 请修改虚拟组织 | 
| Only created virtual organizations can be modified | |||
| 400 | APP.ORG.0025 | 父机构不能指向自己 | 请修改父机构为其它机构 | 
| The parent organization cannot point to itself | 
