QueryUserInfoByAccount - 根据账号查询用户信息

根据阿里云ID或阿里云账户名查询用户信息。

调试

您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。

授权信息

当前API暂无授权信息透出。

请求参数

名称类型必填描述示例值
Accountstring

输入待查询的阿里云账号名或阿里云 ID。

  • 当输入账号名时:
    • 如果组织用户是主账号(例如 main_account),则查询账号格式为主账号。即,要输入的主账号 main_account。
    • 如果组织用户是子账号(例如 zhangsan@test.onaliyun.com),则查询账号格式为子账号的头部,即,要输入的子账号为 zhangsan。
  • 当输入阿里云 ID 时:
    • 输入完整的账号 UID,即可查询到对应的账号信息。
1386587****@163.com
ParentAccountNamestring

当查询子账号出现重复报错时,输入主账号的账号名, 例如 zhangsan@test.onaliyun.com。

zhangsan@test.onaliyun.com

返回参数

名称类型描述示例值
object
Successboolean

是否请求成功。取值范围:

  • true:请求成功
  • false:请求失败
true
RequestIdstring

请求 ID。

D787E1A3-A93C-424A-B626-C2B05DF8D885
Resultobject

返回的组织用户信息。

UserTypeinteger

组织成员的用户类型。取值范围:

  • 1 :开发者
  • 2 :访问者
  • 3 :分析师
1
Emailstring

邮箱。

1386587****@163.com
UserIdstring

Quick BI 中的 UserID。

fe67f61a35a94b7da1a34ba174a7****
AuthAdminUserboolean

是否绑定了权限管理员角色。取值范围:

  • true:是
  • false:否

注意 参数已过期不推荐使用,以 RoleIdList 参数为准

true
AccountIdstring

阿里云账号 ID。非 Ram 自助读取添加的用户,需要登录后才能获取到阿里云 ID。

135****5848
NickNamestring

昵称。

测试用户
AdminUserboolean

是否绑定了组织管理员角色。取值范围:

  • true:是
  • false:否

注意 参数已过期不推荐使用,以 RoleIdList 参数为准

true
Phonestring

手机号码。

1386587****
AccountNamestring

阿里云账号名称。(子账号会去除@后面的域名信息,例如 test@test.com,会返回 test)

1386587****@163.com
RoleIdListarray

用户绑定的组织角色 ID 列表。

RoleIdListlong

组织角色 ID,最多 3 个,包括但不限于组织预置角色:

  • 组织管理员(预置角色):111111111
  • 权限管理员(预置角色):111111112
  • 普通用户(预置角色):111111113
111111111

示例

正常返回示例

JSON格式

{
  "Success": true,
  "RequestId": "D787E1A3-A93C-424A-B626-C2B05DF8D885",
  "Result": {
    "UserType": 1,
    "Email": "1386587****@163.com",
    "UserId": "fe67f61a35a94b7da1a34ba174a7****",
    "AuthAdminUser": true,
    "AccountId": "135****5848",
    "NickName": "测试用户",
    "AdminUser": true,
    "Phone": "1386587****",
    "AccountName": "1386587****@163.com",
    "RoleIdList": [
      111111111
    ]
  }
}

错误码

HTTP status code错误码错误信息描述
400UserInfo.ErrorThe personal information is invalid.个人信息不合法。
400Internal.System.ErrorAn internal system error occurred.系统内部异常。
400User.DuplicativeDuplicate users found with account name : %s.查询到重复的用户,账号名为:%s,。

访问错误中心查看更多错误码。

变更历史

变更时间变更内容概要操作
2024-06-27OpenAPI 错误码发生变更查看变更详情
2024-02-26OpenAPI 错误码发生变更、OpenAPI 入参发生变更、OpenAPI 返回结构发生变更查看变更详情