List User Groups by User¶

获取用户在当前 OU 加入的用户组列表。

操作权限¶

应用被授权 OU 的 administrator 策略。

请求格式¶

GET https://{apigw-address}/enos-iam-service/v2.3/user/usergroup/list

请求参数（URI）¶

名称	位置（Path/Query）	必需/可选	数据类型	描述
orgId	Query	必需	String	用户所属的 OU ID。如何获取 orgId 信息>>
id	Query	必需	String	用户 ID。

响应参数¶

名称	数据类型	描述
data	UserGroupInfo 结构体数组	用户加入的用户组信息列表，参见 UserGroupInfo 结构体。

UserGroupInfo 结构体 ¶

名称	数据类型	描述
id	String	用户组 ID。
name	String	用户组名称。
users	User 结构体数组	一般为空（不用的字段）。
policys	Policy 结构体数组	策略信息列表，参见 Policy 结构体。
user_num	Integer	用户组中包含的用户数量。
created_by	String	用户组创建者用户名。

Policy 结构体 ¶

名称	数据类型	描述
id	String	策略 ID。
code	String	策略 code。
desc	String	策略描述。
name	String	策略名称。
type	Integer	策略类型。 1：预置的管理员策略 2：自定义策略 8：预置策略
created_by	String	策略创建者的用户名。
permissions	Map	一般为空（不用的字段）。
updated_at	String	一般为 null（不用的字段）。

示例¶

请求示例¶

url: https://{apigw-address}/enos-iam-service/v2.3/user/usergroup/list?orgId=yourOrgId&id=yourRequestedUserId
method: GET

返回示例¶

{
  "fail": false,
  "data": [
    {
      "id": "userGroupId1",
      "name": "Admin group 1",
      "users": [],
      "policys": [],
      "user_num": 1,
      "created_by": "testUser"
    },
    {
      "id": "userGroupId2",
      "name": "Admin group 2",
      "users": [],
      "policys": [
        {
          "id": "289",
          "code": "",
          "desc": "Policy description",
          "name": "Policy Name",
          "type": 2,
          "created_by": "john.doe",
          "permissions": {}
        }
      ],
      "user_num": 2,
      "created_by": "john.doe"
    }
  ],
  "success": true,
  "status": 0
}