查询用户信息

最近更新时间: 2026-10-12 00:11:05

1. 接口描述

接口请求域名： cic.api3.fincloud.tencent.com。

查询用户信息

默认接口请求频率限制：20次/秒。

接口更新时间：2024-12-11 12:17:58。

接口既验签名又鉴权。

2. 输入参数

以下请求参数列表仅列出了接口请求参数和部分公共参数，完整公共参数列表见公共请求参数。

参数名称	必选	允许NULL	类型	描述
Action	是	否	String	公共参数，本接口取值：GetUser
Version	是	否	String	公共参数，本接口取值：2021-03-31
Region	是	否	String	公共参数，地域信息本接口不需要传递此参数。
ZoneId	是	是	String	空间 ID。示例值： z-2d8shd8***
UserId	是	是	String	用户 ID。示例值： u-34nesn3u

3. 输出参数

参数名称	类型	描述
UserInfo	UserInfo	用户信息。示例值：查看
RequestId	String	唯一请求 ID，每次请求都会返回。定位问题时需要提供该次请求的 RequestId。

4. 错误码

以下仅列出了接口业务逻辑相关的错误码，其他错误码详见公共错误码。

错误码	描述
ResourceNotFound.UserNotExist
FailedOperation.IdentityCenterNotOpen
FailedOperation.ZoneIdNotExist

5. 示例

示例1 查询用户信息

输入示例

{
  "UserId": "u-4i293bf3indh",
  "ZoneId": "z-hfp2qqncf343"
}

输出示例

{
  "Response": {
    "UserInfo": {
      "UserName": "user1",
      "FirstName": "john",
      "LastName": "smith",
      "DisplayName": "john",
      "Description": "this is user",
      "Email": "test@example.com",
      "UserStatus": "Enabled",
      "UserType": "Manual",
      "UserId": "u-2jsal3jdxk",
      "CreateTime": "2024-03-12 12:12:12",
      "UpdateTime": "2024-03-12 12:12:12"
    },
    "RequestId": "e297543a-80de-4039-83c8-34545s45"
  }
}