接口说明
查询当前租户的用户列表信息。列表按照用户创建时间降序排列。分页查询支持模糊查询用户账号等。若不存在用户，则返回空列表。
URL
POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/console/tenantConsole/usermgr/list
请求参数
Header
|
参数名称
|
类型
|
必填
|
描述
|
|
pool
|
string
|
是
|
资源池ID |
Body
|
参数名称
|
类型
|
必填
|
描述
|
|
req
|
OpenapiUserListReq
|
是
|
req |
|
currentPage
|
integer(int32)
|
否
|
页码，默认为1 |
|
hasAssign
|
boolean
|
否
|
是否分配,可传,传入就作为条件搜索，传入0:否，1:是 |
|
name
|
string
|
否
|
姓名,可传,传入就进行模糊搜索 |
|
namePrefix
|
string
|
否
|
用户名称前缀。如“苏州移动” |
|
pageSize
|
integer(int32)
|
否
|
每页条数，默认为10 |
|
prepareType
|
string
|
是
|
用户类型,必传,1：政企版 2：公众版 4:专属版 5:尊享版 6:云车机版 9-矩阵版用户 |
|
tenantBid
|
string
|
否
|
租户id |
|
tenantName
|
string
|
否
|
租户名 |
|
userAccount
|
string
|
否
|
用户账号,可传,手机号,传入就进行模糊搜索 |
|
userId
|
string
|
否
|
用户id,可传,格式：CPH-uuid,传入就进行模糊搜索 |
|
userSource
|
string
|
否
|
用户来源,可传,传入就作为条件搜索,传入00:政企版，40:专属版，50:专属版 60:云车机版 90:矩阵版 |
请求示例
POST https://ecloud.10086.cn/api/openapi-cloudphone/api/v1/zycloudphone/console/tenantConsole/usermgr/list{
"currentPage":1,
"pageSize":10,
"prepareType":"4"
}返回参数
返回码：200
OK
|
参数名称
|
类型
|
描述
|
|
body
|
EPage«OpenapiUserListResp»
|
响应体 |
|
list
|
<OpenapiUserListResp> array
|
|
|
assignCount
|
integer(int32)
|
实例数量 |
|
canDelete
|
string
|
用户是否可以删除 |
|
canJump
|
string
|
当前资源池下是否有云机 |
|
createTime
|
string(date-time)
|
创建时间 |
|
email
|
string
|
邮箱 |
|
exUserId
|
string
|
|
|
hasAssign
|
boolean
|
是否分配 |
|
id
|
string
|
主键id |
|
isLocked
|
integer(int32)
|
用户是否锁定,0: 未锁定, 1: 已锁定 |
|
name
|
string
|
姓名 |
|
phone
|
string
|
手机号 |
|
tenantId
|
string
|
租户账号 |
|
tenantName
|
string
|
租户名称 |
|
userAccount
|
string
|
用户账号 |
|
userId
|
string
|
用户ID |
|
userSource
|
string
|
用户来源 |
|
total
|
integer(int64)
|
结果总数量 |
|
totalPage
|
integer(int32)
|
结果总页数 |
|
errorCode
|
string
|
错误编码 |
|
errorMessage
|
string
|
错误信息 |
|
requestId
|
string
|
请求id |
|
state
|
string
|
状态值 |
返回示例
返回码：200
OK
{
"errorCode":"00000000",
"errorMessage":"请求成功",
"requestId":"bac53f87-20d6-4a96-8c3e-c6a0b4017228",
"state":"OK",
"body":{
"total":11,
"totalPage":11,
"list":[
{
"id":"1955208606740148225",
"tenantId":"CIDC-U-7f6c924f68c34fefa0d02f6f0b8cbbc4",
"tenantName":"csy_saas_ghyy1_lvlei_01",
"userId":"CPH-1247fdff6e884221931450a69bf5a77d",
"userAccount":"136****9999",
"phone":"136****9999",
"name":"张*",
"email":"4****@qq.com",
"userSource":"40",
"hasAssign":false,
"assignCount":0,
"createTime":"2025-08-16 20:13:35",
"exUserId":null,
"isLocked":0,
"canDelete":"1",
"canJump":"0"
}
]
}
}