List Users¶
获取 OU 内的内部用户、LDAP 用户和 SSO 用户列表,以及用户最近登录时间。
请求参数(URI)¶
名称 | 位置(Path/Query) | 必需/可选 | 数据类型 | 描述 |
---|---|---|---|---|
orgId | Query | 必需 | String | 用户所属的 OU ID。如何获取 orgId 信息 >> |
fromTime | Query | 可选 | String | 指定用户最近登录时间范围的起始时间,格式为 YYYY-MM-DD HH:mm:ss 。 |
toTime | Query | 可选 | String | 指定用户最近登录时间范围的结束时间,格式为 YYYY-MM-DD HH:mm:ss 。 |
响应参数¶
名称 | 数据类型 | 描述 |
---|---|---|
userWithLoginTime | User 结构体数组 | 用户列表,参见 User 结构体。 |
User 结构体 ¶
名称 | 数据类型 | 描述 |
---|---|---|
id | String | 用户 ID。 |
name | String | 用户的用户名。 |
String | 用户的邮箱。 | |
emailVerified | Boolean | 邮箱是否绑定。 |
phoneArea | String | 用户的手机号码的国码。 |
phone | String | 用户的手机号码。 |
phoneVerified | Boolean | 手机号码是否绑定。 |
organizationId | String | 用户所属 OU。 |
state | Integer | 账号状态。
|
domain | String | 配置的 SSO 身份供应商名称。仅支持 SSO 用户。 |
authType | Integer | 用户类型。
|
createTime | String | 用户的创建时间。 |
description | String | 用户的描述。 |
passwordExpireTime | Long | 密码过期时间。SSO 用户固定为 0。 |
lastLoginTime | String | 用户最近登录时间。 |
updateTime | String | 用户信息最近更新时间。 |
示例¶
请求示例¶
url: https://{apigw-address}/enos-iam-service/v2.4/open/user/logintime/list?orgId=yourOrgId
method: GET
返回示例¶
{
"fail": false,
"userWithLoginTime": [
{
"id": "u16xxxxxxxxxxxxxx7",
"name": "xxxxxx",
"email": "xxxx@enos.com",
"phone": "",
"state": 0,
"domain": "",
"authType": 0,
"phoneArea": "",
"createTime": "2022-02-25 09:48:59",
"updateTime": "2022-10-10 03:20:33",
"description": "",
"emailVerified": true,
"lastLoginTime": "2023-12-01 09:51:56",
"phoneVerified": false,
"organizationId": "o16xxxxxxxxxxx",
"passwordExpireTime": 0
}
],
"success": true,
"failed": false,
"message": "",
"status": 0,
"successful": true
}