获取调用者身份信息 - GetCallerIdentity

功能介绍

获取调用者（用户，委托等）身份信息。

调试

您可以在API Explorer中调试该接口，支持自动认证鉴权。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)统一资源名称, 参考链接。取值范围：不涉及。
principal_id	String	参数解释：主体ID。取值范围：不涉及。

状态码：500

表3 响应Body参数
参数	参数类型	描述
error_code	String	参数解释：错误码，请参见错误码。取值范围：格式为STS5.XXXX，例如 STS5.1001。
error_msg	String	参数解释：错误信息，请参见错误信息。取值范围：不涉及。

请求示例

获取调用者身份信息。

GET https://{endpoint}/v5/caller-identity

响应示例

状态码：200

请求成功。

{
  "account_id" : "27680d67da6b47eb82d00a1a118be145",
  "principal_urn" : "iam::27680d67da6b47eb82d00a1a118be145:user:user-name",
  "principal_id" : "user-id"
}