# 查询用户详情 - DescribeUser #### 功能介绍 根据用户ID，查询对应IAM身份中心用户的详情信息。此操作只能由组织的管理账号或作为服务委托管理员的成员账号调用。 #### 授权信息 账号根用户具备所有API的调用权限，如果使用账号下的IAM用户调用当前API，该IAM用户需具备如下身份策略权限，更多的权限说明请参见[权限和授权项](https://support.huaweicloud.com/api-identitycenter/iic_04_0028.html)。 | 授权项 | 访问级别 | 资源类型（\*为必须） | 条件键 | 别名 | 依赖的授权项 | |:---|:---|:---|:---|:---|:---| | 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 | 包含用户工作相关信息的对象。 | 表4addresses | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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** | 表5emails | 参数 | 参数类型 | 描述 | |:---|:---|:---| | primary | Boolean | 一个布尔值，表示这是否为用户的主电子邮箱。 | | type | String | 表示电子邮箱类型的字符串。 最小长度：**1** 最大长度：**1024** | | value | String | 包含电子邮箱地址的字符串。 最小长度：**1** 最大长度：**1024** | | verification_status | String | 电子邮箱地址的验证状态。 枚举值： - **NOT_VERIFIED**：未验证。 - **VERIFIED**：已验证。 | 表6external_ids | 参数 | 参数类型 | 描述 | |:---|:---|:---| | id | String | 外部身份提供商颁发给此资源的标识符。 最小长度：**1** 最大长度：**256** | | issuer | String | 外部标识符的颁发者。 最小长度：**1** 最大长度：**100** | 表7name | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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** | 表8phone_numbers | 参数 | 参数类型 | 描述 | |:---|:---|:---| | primary | Boolean | 一个布尔值，表示这是否为用户的主电话号码。 | | type | String | 表示电话号码类型的字符串。 最小长度：**1** 最大长度：**1024** | | value | String | 包含电话号码的字符串。 最小长度：**1** 最大长度：**1024** | 表9enterprise | 参数 | 参数类型 | 描述 | |:---|:---|:---| | cost_center | String | 成本中心。 最小长度：**1** 最大长度：**1024** | | department | String | 部门。 最小长度：**1** 最大长度：**1024** | | division | String | 分部。 最小长度：**1** 最大长度：**1024** | | employee_number | String | 员工编号。 最小长度：**1** 最大长度：**1024** | | [manager] | Object | 经理。 | | organization | String | 组织。 最小长度：**1** 最大长度：**1024** | 表10manager | 参数 | 参数类型 | 描述 | |:---|:---|:---| | 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 } ``` #### 状态码 请参见[状态码](https://support.huaweicloud.com/api-identitycenter/iic_04_0030.html)。 #### 错误码 请参见[错误码](https://support.huaweicloud.com/api-identitycenter/ErrorCode.html)。