更新时间：2025-10-20 GMT+08:00
获取调用者身份信息
功能介绍
获取调用者（用户，委托等）身份信息。
调试
您可以在API Explorer中调试该接口，支持自动认证鉴权。API Explorer可以自动生成SDK代码示例，并提供SDK代码示例调试功能。
URI
GET /v5/caller-identity
请求参数
|
参数 |
是否必选 |
参数类型 |
描述 |
|---|---|---|---|
|
X-Security-Token |
否 |
String |
通过临时安全凭证调用接口时，需要提供“X-Security-Token”Http头，取值为临时安全凭证的security_token字段。 |
响应参数
状态码：200
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
account_id |
String |
账号ID。 最大长度：64 |
|
principal_urn |
String |
主体URN。 最小长度：4 最大长度：1024 |
|
principal_id |
String |
主体ID。 最小长度：2 最大长度：256 |
状态码：500
|
参数 |
参数类型 |
描述 |
|---|---|---|
|
error_code |
String |
错误码。 |
|
error_msg |
String |
错误信息。 |
请求示例
获取调用者身份信息。
GET https://{endpoint}/v5/caller-identity
响应示例
状态码：200
请求成功。
{
"account_id" : "27680d67da6b47eb82d00a1a118be145",
"principal_urn" : "iam::27680d67da6b47eb82d00a1a118be145:user:user-name",
"principal_id" : "user-id"
}
状态码
|
状态码 |
描述 |
|---|---|
|
200 |
请求成功。 |
|
500 |
服务端异常。 |
错误码
请参见错误码。
父主题： 调用者信息查询
