Skip to main content

GetUser

Retrieves information about the specified IAM user, including the user's creation date, path, unique ID, and ARN.

Permissions​

ActionDescriptionResource
GetUserGrants permission to retrieve information about the specified IAM user, including the user's creation date, path, unique ID, and ARNuser

Request Parameters​

For information about the parameters that are common to all actions, see Common Parameters.

UserName

The email of the user to get information about.

Type: String

Length Constraints: Minimum length of 1. Maximum length of 128.

Pattern: [\w+=,.@-]+

Required: No

Response Elements​

The following element is returned by the service.

User

A structure containing details about the IAM user.

Type: User object

Errors​

NoSuchEntity

The request was rejected because it referenced a resource entity that does not exist. The error message describes the resource.

HTTP Status Code: 404

ServiceFailure

The request processing has failed because of an unknown error, exception or failure.

HTTP Status Code: 500

Examples​

Example​

This example illustrates one usage of GetUser.

https://<partition>.iam.astran.io/?Action=GetUser
&UserName=Bob
&Version=2010-05-08
&AUTHPARAMS
<GetUserResponse xmlns="https://iam.amazonaws.com/doc/2010-05-08/">
  <GetUserResult>
    <User>
      <UserId>AIDACKCEVSQ6C2EXAMPLE</UserId>
      <Path>/division_abc/subdivision_xyz/</Path>
      <UserName>Bob</UserName>
      <Arn>arn:aws:iam::123456789012:user/division_abc/subdivision_xyz/Bob</Arn>
      <CreateDate>2013-10-02T17:01:44Z</CreateDate>
      <PasswordLastUsed>2014-10-10T14:37:51Z</PasswordLastUsed>
    </User>
  </GetUserResult>
  <ResponseMetadata>
    <RequestId>7a62c49f-347e-4fc4-9331-6e8eEXAMPLE</RequestId>
  </ResponseMetadata>
</GetUserResponse>

See Also​

For more information about using this API in one of the language-specific AWS SDKs, see the following: