Copyright	(c) 2013-2021 Brendan Hay
License	Mozilla Public License, v. 2.0.
Maintainer	Brendan Hay <brendan.g.hay+amazonka@gmail.com>
Stability	auto-generated
Portability	non-portable (GHC extensions)
Safe Haskell	None

Amazonka.IAM.GetUser

Contents

Creating a Request
Request Lenses
Destructuring the Response
Response Lenses

Description

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

If you do not specify a user name, IAM determines the user name implicitly based on the Amazon Web Services access key ID used to sign the request to this operation.

Synopsis

data GetUser = GetUser' {
- userName :: Maybe Text
}
newGetUser :: GetUser
getUser_userName :: Lens' GetUser (Maybe Text)
data GetUserResponse = GetUserResponse' {
- httpStatus :: Int
- user :: User
}
newGetUserResponse :: Int -> User -> GetUserResponse
getUserResponse_httpStatus :: Lens' GetUserResponse Int
getUserResponse_user :: Lens' GetUserResponse User

Creating a Request

data GetUser Source #

See: newGetUser smart constructor.

Constructors

GetUser'
Fields userName :: Maybe Text The name of the user to get information about. This parameter is optional. If it is not included, it defaults to the user making the request. This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

Instances

Instances details

Eq GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser Methods (==) :: GetUser -> GetUser -> Bool # (/=) :: GetUser -> GetUser -> Bool #
Read GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser Methods readsPrec :: Int -> ReadS GetUser # readList :: ReadS [GetUser] # readPrec :: ReadPrec GetUser # readListPrec :: ReadPrec [GetUser] #
Show GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser Methods showsPrec :: Int -> GetUser -> ShowS # show :: GetUser -> String # showList :: [GetUser] -> ShowS #
Generic GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser Associated Types type Rep GetUser :: Type -> Type # Methods from :: GetUser -> Rep GetUser x # to :: Rep GetUser x -> GetUser #
NFData GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser Methods rnf :: GetUser -> () #
Hashable GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser Methods hashWithSalt :: Int -> GetUser -> Int # hash :: GetUser -> Int #
AWSRequest GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser Associated Types type AWSResponse GetUser # Methods request :: GetUser -> Request GetUser # response :: MonadResource m => Logger -> Service -> Proxy GetUser -> ClientResponse ClientBody -> m (Either Error (ClientResponse (AWSResponse GetUser))) #
ToHeaders GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser Methods toHeaders :: GetUser -> [Header] #
ToPath GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser Methods toPath :: GetUser -> ByteString #
ToQuery GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser Methods toQuery :: GetUser -> QueryString #
type Rep GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser type Rep GetUser = D1 ('MetaData "GetUser" "Amazonka.IAM.GetUser" "libZSservicesZSamazonka-iamZSamazonka-iam" 'False) (C1 ('MetaCons "GetUser'" 'PrefixI 'True) (S1 ('MetaSel ('Just "userName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))))
type AWSResponse GetUser Source #
Instance details Defined in Amazonka.IAM.GetUser type AWSResponse GetUser = GetUserResponse

newGetUser :: GetUser Source #

Create a value of GetUser with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:userName:GetUser', getUser_userName - The name of the user to get information about.

This parameter is optional. If it is not included, it defaults to the user making the request. This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

Request Lenses

getUser_userName :: Lens' GetUser (Maybe Text) Source #

The name of the user to get information about.

This parameter is optional. If it is not included, it defaults to the user making the request. This parameter allows (through its regex pattern) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

Destructuring the Response

data GetUserResponse Source #

Contains the response to a successful GetUser request.

See: newGetUserResponse smart constructor.

Constructors

GetUserResponse'

Fields

httpStatus :: Int
The response's http status code.
user :: User
A structure containing details about the IAM user.
Due to a service issue, password last used data does not include password use from May 3, 2018 22:50 PDT to May 23, 2018 14:08 PDT. This affects last sign-in dates shown in the IAM console and password last used dates in the IAM credential report, and returned by this operation. If users signed in during the affected time, the password last used date that is returned is the date the user last signed in before May 3, 2018. For users that signed in after May 23, 2018 14:08 PDT, the returned password last used date is accurate.
You can use password last used information to identify unused credentials for deletion. For example, you might delete users who did not sign in to Amazon Web Services in the last 90 days. In cases like this, we recommend that you adjust your evaluation window to include dates after May 23, 2018. Alternatively, if your users use access keys to access Amazon Web Services programmatically you can refer to access key last used information because it is accurate for all dates.

Instances

Instances details

Eq GetUserResponse Source #
Instance details Defined in Amazonka.IAM.GetUser Methods (==) :: GetUserResponse -> GetUserResponse -> Bool # (/=) :: GetUserResponse -> GetUserResponse -> Bool #
Read GetUserResponse Source #
Instance details Defined in Amazonka.IAM.GetUser Methods readsPrec :: Int -> ReadS GetUserResponse # readList :: ReadS [GetUserResponse] # readPrec :: ReadPrec GetUserResponse # readListPrec :: ReadPrec [GetUserResponse] #
Show GetUserResponse Source #
Instance details Defined in Amazonka.IAM.GetUser Methods showsPrec :: Int -> GetUserResponse -> ShowS # show :: GetUserResponse -> String # showList :: [GetUserResponse] -> ShowS #
Generic GetUserResponse Source #
Instance details Defined in Amazonka.IAM.GetUser Associated Types type Rep GetUserResponse :: Type -> Type # Methods from :: GetUserResponse -> Rep GetUserResponse x # to :: Rep GetUserResponse x -> GetUserResponse #
NFData GetUserResponse Source #
Instance details Defined in Amazonka.IAM.GetUser Methods rnf :: GetUserResponse -> () #
type Rep GetUserResponse Source #
Instance details Defined in Amazonka.IAM.GetUser type Rep GetUserResponse = D1 ('MetaData "GetUserResponse" "Amazonka.IAM.GetUser" "libZSservicesZSamazonka-iamZSamazonka-iam" 'False) (C1 ('MetaCons "GetUserResponse'" 'PrefixI 'True) (S1 ('MetaSel ('Just "httpStatus") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Int) :*: S1 ('MetaSel ('Just "user") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 User)))

newGetUserResponse Source #

Arguments

:: Int	`$sel:httpStatus:GetUserResponse'`
-> User	`$sel:user:GetUserResponse'`
-> GetUserResponse

Create a value of GetUserResponse with all optional fields omitted.

Use generic-lens or optics to modify other optional fields.

The following record fields are available, with the corresponding lenses provided for backwards compatibility:

$sel:httpStatus:GetUserResponse', getUserResponse_httpStatus - The response's http status code.

$sel:user:GetUserResponse', getUserResponse_user - A structure containing details about the IAM user.

Due to a service issue, password last used data does not include password use from May 3, 2018 22:50 PDT to May 23, 2018 14:08 PDT. This affects last sign-in dates shown in the IAM console and password last used dates in the IAM credential report, and returned by this operation. If users signed in during the affected time, the password last used date that is returned is the date the user last signed in before May 3, 2018. For users that signed in after May 23, 2018 14:08 PDT, the returned password last used date is accurate.

You can use password last used information to identify unused credentials for deletion. For example, you might delete users who did not sign in to Amazon Web Services in the last 90 days. In cases like this, we recommend that you adjust your evaluation window to include dates after May 23, 2018. Alternatively, if your users use access keys to access Amazon Web Services programmatically you can refer to access key last used information because it is accurate for all dates.

Response Lenses

getUserResponse_httpStatus :: Lens' GetUserResponse Int Source #

The response's http status code.

getUserResponse_user :: Lens' GetUserResponse User Source #

A structure containing details about the IAM user.

Due to a service issue, password last used data does not include password use from May 3, 2018 22:50 PDT to May 23, 2018 14:08 PDT. This affects last sign-in dates shown in the IAM console and password last used dates in the IAM credential report, and returned by this operation. If users signed in during the affected time, the password last used date that is returned is the date the user last signed in before May 3, 2018. For users that signed in after May 23, 2018 14:08 PDT, the returned password last used date is accurate.

You can use password last used information to identify unused credentials for deletion. For example, you might delete users who did not sign in to Amazon Web Services in the last 90 days. In cases like this, we recommend that you adjust your evaluation window to include dates after May 23, 2018. Alternatively, if your users use access keys to access Amazon Web Services programmatically you can refer to access key last used information because it is accurate for all dates.