• 文档
• 用户
• List Users

List Users

获取 OU 内的内部用户、LDAP 用户和 SSO 用户列表，以及用户最近登录时间。

操作权限

应用被授权 OU 的 administrator 策略。

请求格式

GET https://{apigw-address}/enos-iam-service/v2.4/open/user/logintime/list

请求参数（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	用户的用户名。
email	String	用户的邮箱。
emailVerified	Boolean	邮箱是否绑定。
phoneArea	String	用户的手机号码的国码。
phone	String	用户的手机号码。
phoneVerified	Boolean	手机号码是否绑定。
organizationId	String	用户所属 OU。
state	Integer	账号状态。 0：启用 1：禁用
domain	String	配置的 SSO 身份供应商名称。仅支持 SSO 用户。
authType	Integer	用户类型。 0：内部用户 1：LDAP 用户 2：SSO 用户
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
}