# 获取调用者身份信息 - GetCallerIdentity
#### 功能介绍
获取调用者（用户，委托等）身份信息。
#### 调试
您可以在[API Explorer](https://console.huaweicloud.com/apiexplorer/#/openapi/STS/doc?api=GetCallerIdentity&version=v1)中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
#### 授权信息
当前API调用无需身份策略权限。
#### URI
GET /v5/caller-identity
#### 请求参数
表1请求Header参数 
| 参数               | 是否必选 | 参数类型   | 描述                                                                                                                                                                                                                                                                                                                                                                                       |
|:---|:---|:---|:---|
| X-Security-Token | 否    | String | **参数解释**： 临时安全凭证的security_token字段。 **约束限制**： 通过临时安全凭证调用接口时，需要提供"X-Security-Token"Http头。 **取值范围**： 不涉及。 **默认取值**： 不涉及。 |
   
#### 响应参数
**状态码：200**
表2响应Body参数 
| 参数            | 参数类型   | 描述                                                                                                                                                                                                                                                                 |
|:---|:---|:---|
| account_id    | String | **参数解释**： 账号ID。 **取值范围**： 不涉及。                                                                                                                      |
| principal_urn | String | **参数解释**： URN(Uniform Resource Name)统一资源名称, [参考链接](https://support.huaweicloud.com/usermanual-iam5/iam_01_1275.html)。该参数用于唯一标识调用者身份。 **取值范围**： 不涉及。 |
| principal_id  | String | **参数解释**： 主体ID。 **取值范围**： 不涉及。                                                                                                                      |
   
**状态码：500**
表3响应Body参数 
| 参数         | 参数类型   | 描述                                                                                                                                                                                                                                   |
|:---|:---|:---|
| error_code | String | **参数解释**： 错误码，请参见[错误码](https://support.huaweicloud.com/api-iam5/ErrorCode.html)。 **取值范围**： 格式为STS5.XXXX，例如 STS5.1001。 |
| error_msg  | String | **参数解释**： 错误信息，请参见[错误信息](https://support.huaweicloud.com/api-iam5/ErrorCode.html)。 **取值范围**： 不涉及。                     |
   
#### 请求示例
获取调用者身份信息。
```
GET https://{endpoint}/v5/caller-identity
```
#### 响应示例
**状态码：200**
```
{
  "account_id" : "27680d67da6b47eb82d00a1a118be145",
  "principal_urn" : "iam::27680d67da6b47eb82d00a1a118be145:user:user-name",
  "principal_id" : "user-id"
}
```
#### 状态码
| 状态码 | 描述     |
|:---|:---|
| 200 | 请求成功。  |
| 500 | 服务端异常。 |
   
#### 错误码
请参见[错误码](https://support.huaweicloud.com/api-iam5/ErrorCode.html)。