文档首页/IAM 身份中心/API参考/API/用户管理/查询用户详情 - DescribeUser
更新时间：2025-12-12 GMT+08:00
在线调试
CLI示例
查看PDF
分享

查询用户详情 - DescribeUser

功能介绍

根据用户ID，查询对应IAM身份中心用户的详情信息。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。

授权信息

账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见权限和授权项。

授权项

访问级别

资源类型（*为必须）

条件键

别名

依赖的授权项

IdentityCenter:user:listSessions

List

-

-

-

organizations:delegatedAdministrators:list

URI

GET /v1/identity-stores/{identity_store_id}/users/{user_id}

表1 路径参数

参数

是否必选

参数类型

描述

identity_store_id

是

String

身份源的全局唯一标识符（ID）。

最小长度：12

最大长度：12

user_id

是

String

身份源中IAM身份中心用户的全局唯一标识符（ID）。

最小长度：1

最大长度：64

请求参数

表2 请求Header参数

参数

是否必选

参数类型

描述

X-Security-Token

否

String

如果正在使用临时安全凭据，则此header是必需的，该值是临时安全凭据的安全令牌（会话令牌）。

最大长度：2048

响应参数

状态码： 200

表3 响应Body参数

参数

参数类型

描述

addresses

Array of objects

用户的地址信息列表。

数组长度：1-1

display_name

String

用户的显示名称。

最小长度：1

最大长度：1024

emails

Array of objects

用户的电子邮箱信息列表。

数组长度：1-1

external_id

String

外部身份源分配给此资源的标识符。

external_ids

Array of objects

用户的外部标识符信息列表。

数组长度：1-10

identity_store_id

String

身份源的全局唯一标识符（ID）。

最小长度：1

最大长度：36

locale

String

用户的地理区域或位置信息。

最小长度：1

最大长度：1024

name

Object

包含用户姓名信息的对象。

nickname

String

用户昵称。

最小长度：1

最大长度：1024

phone_numbers

Array of objects

用户的电话号码信息列表。

数组长度：1-1

preferred_language

String

用户语言首选项。

最小长度：1

最大长度：1024

profile_url

String

与用户关联的URL。

最小长度：1

最大长度：1024

timezone

String

用户时区。

最小长度：1

最大长度：1024

title

String

用户头衔。

最小长度：1

最大长度：1024

user_id

String

身份源中IAM身份中心用户的全局唯一标识符（ID）。

最小长度：1

最大长度：47

user_name

String

用户名，用于标识用户的唯一字符串。

最小长度：2

最大长度：128

user_type

String

用户类型。

最小长度：1

最大长度：1024

created_at

Long

创建用户时的时间戳。

created_by

String

创建者。

updated_at

Long

更新用户时的时间戳。

updated_by

String

更新者。

email_verified

Boolean

一个布尔值，表示用户主的电子邮箱是否验证。

enabled

Boolean

一个布尔值，表示用户是否启用。

enterprise

Object

包含用户工作相关信息的对象。

表4 addresses

参数

参数类型

描述

country

String

国家/地区。

最小长度：1

最大长度：1024

formatted

String

包含要显示的地址的格式化版本的字符串。

最小长度：1

最大长度：1024

locality

String

地址位置。

最小长度：1

最大长度：1024

postal_code

String

邮政编码。

最小长度：1

最大长度：1024

primary

Boolean

一个布尔值，表示这是否为用户的主地址。

region

String

区域。

最小长度：1

最大长度：1024

street_address

String

街道。

最小长度：1

最大长度：1024

type

String

表示地址类型的字符串。

最小长度：1

最大长度：1024

表5 emails

参数

参数类型

描述

primary

Boolean

一个布尔值，表示这是否为用户的主电子邮箱。

type

String

表示电子邮箱类型的字符串。

最小长度：1

最大长度：1024

value

String

包含电子邮箱地址的字符串。

最小长度：1

最大长度：1024

verification_status

String

电子邮箱地址的验证状态。

枚举值：

  • NOT_VERIFIED：未验证。
  • VERIFIED：已验证。
表6 external_ids

参数

参数类型

描述

id

String

外部身份提供商颁发给此资源的标识符。

最小长度：1

最大长度：256

issuer

String

外部标识符的颁发者。

最小长度：1

最大长度：100

表7 name

参数

参数类型

描述

family_name

String

用户的姓氏。

最小长度：1

最大长度：1024

formatted

String

包含要显示的名称的格式化版本的字符串。

最小长度：1

最大长度：1024

given_name

String

用户的名字。

最小长度：1

最大长度：1024

honorific_prefix

String

用户的尊称前缀。

最小长度：1

最大长度：1024

honorific_suffix

String

用户的尊称后缀。

最小长度：1

最大长度：1024

middle_name

String

用户的中间名。

最小长度：1

最大长度：1024

表8 phone_numbers

参数

参数类型

描述

primary

Boolean

一个布尔值，表示这是否为用户的主电话号码。

type

String

表示电话号码类型的字符串。

最小长度：1

最大长度：1024

value

String

包含电话号码的字符串。

最小长度：1

最大长度：1024

表9 enterprise

参数

参数类型

描述

cost_center

String

成本中心。

最小长度：1

最大长度：1024

department

String

部门。

最小长度：1

最大长度：1024

division

String

分部。

最小长度：1

最大长度：1024

employee_number

String

员工编号。

最小长度：1

最大长度：1024

manager

Object

经理。

organization

String

组织。

最小长度：1

最大长度：1024

表10 manager

参数

参数类型

描述

value

String

经理。

最小长度：1

最大长度：1024

状态码： 400

表11 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息。

request_id

String

请求ID。

状态码： 403

表12 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息。

request_id

String

请求ID。

encoded_authorization_message

String

加密的错误信息。

状态码： 404

表13 响应Body参数

参数

参数类型

描述

error_code

String

错误码。

error_msg

String

错误信息。

request_id

String

请求ID。

请求示例

根据用户ID，查询对应IAM身份中心用户的详情信息。

GET https://{hostname}/v1/identity-stores/{identity_store_id}/users/{user_id}

响应示例

状态码： 200

Successful

{
  "addresses" : null,
  "display_name" : "用户显示名",
  "emails" : [ {
    "primary" : true,
    "type" : "Work",
    "value" : "email@example.com"
  } ],
  "external_ids" : null,
  "identity_store_id" : "d-a00aaaa33f",
  "locale" : null,
  "name" : {
    "family_name" : "姓氏",
    "formatted" : null,
    "given_name" : "名字",
    "honorific_prefix" : null,
    "honorific_suffix" : null,
    "middle_name" : null
  },
  "nickname" : null,
  "phone_numbers" : null,
  "preferred_language" : null,
  "profile_url" : null,
  "timezone" : null,
  "title" : null,
  "user_id" : "ac6aa714-daa7-1aaa-aaa2-6715aaaa4dd9",
  "user_name" : "用户名u1",
  "user_type" : null,
  "created_at" : 1687184129925,
  "created_by" : "5146d03d8aaaaaaaaaaaabbae60620a5",
  "updated_at" : 1687184129926,
  "updated_by" : "5146d03d8aaaaaaaaaaaabbae60620a5",
  "email_verified" : true,
  "enabled" : true
}

状态码

请参见状态码。

错误码

请参见错误码。

父主题：用户管理