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.Types.User

Description

Synopsis

data User = User' {
- passwordLastUsed :: Maybe ISO8601
- path :: Maybe Text
- permissionsBoundary :: Maybe AttachedPermissionsBoundary
- tags :: Maybe [Tag]
- userName :: Text
- userId :: Text
- arn :: Text
- createDate :: ISO8601
}
newUser :: Text -> Text -> Text -> UTCTime -> User
user_passwordLastUsed :: Lens' User (Maybe UTCTime)
user_path :: Lens' User (Maybe Text)
user_permissionsBoundary :: Lens' User (Maybe AttachedPermissionsBoundary)
user_tags :: Lens' User (Maybe [Tag])
user_userName :: Lens' User Text
user_userId :: Lens' User Text
user_arn :: Lens' User Text
user_createDate :: Lens' User UTCTime

Documentation

data User Source #

Contains information about an IAM user entity.

This data type is used as a response element in the following operations:

CreateUser
GetUser
ListUsers

See: newUser smart constructor.

Constructors

User'

Fields

passwordLastUsed :: Maybe ISO8601
The date and time, in ISO 8601 date-time format, when the user's password was last used to sign in to an Amazon Web Services website. For a list of Amazon Web Services websites that capture a user's last sign-in time, see the Credential reports topic in the IAM User Guide. If a password is used more than once in a five-minute span, only the first use is returned in this field. If the field is null (no value), then it indicates that they never signed in with a password. This can be because:
- The user never had a password.
- A password exists but has not been used since IAM started tracking this information on October 20, 2014.
A null value does not mean that the user never had a password. Also, if the user does not currently have a password but had one in the past, then this field contains the date and time the most recent password was used.
This value is returned only in the GetUser and ListUsers operations.
path :: Maybe Text
The path to the user. For more information about paths, see IAM identifiers in the IAM User Guide.
The ARN of the policy used to set the permissions boundary for the user.
permissionsBoundary :: Maybe AttachedPermissionsBoundary
For more information about permissions boundaries, see Permissions boundaries for IAM identities in the IAM User Guide.
tags :: Maybe [Tag]
A list of tags that are associated with the user. For more information about tagging, see Tagging IAM resources in the IAM User Guide.
userName :: Text
The friendly name identifying the user.
userId :: Text
The stable and unique string identifying the user. For more information about IDs, see IAM identifiers in the IAM User Guide.
arn :: Text
The Amazon Resource Name (ARN) that identifies the user. For more information about ARNs and how to use ARNs in policies, see IAM Identifiers in the IAM User Guide.
createDate :: ISO8601
The date and time, in ISO 8601 date-time format, when the user was created.

Instances

Instances details

Eq User Source #
Instance details Defined in Amazonka.IAM.Types.User Methods (==) :: User -> User -> Bool # (/=) :: User -> User -> Bool #
Read User Source #
Instance details Defined in Amazonka.IAM.Types.User Methods readsPrec :: Int -> ReadS User # readList :: ReadS [User] # readPrec :: ReadPrec User # readListPrec :: ReadPrec [User] #
Show User Source #
Instance details Defined in Amazonka.IAM.Types.User Methods showsPrec :: Int -> User -> ShowS # show :: User -> String # showList :: [User] -> ShowS #
Generic User Source #
Instance details Defined in Amazonka.IAM.Types.User Associated Types type Rep User :: Type -> Type # Methods from :: User -> Rep User x # to :: Rep User x -> User #
NFData User Source #
Instance details Defined in Amazonka.IAM.Types.User Methods rnf :: User -> () #
Hashable User Source #
Instance details Defined in Amazonka.IAM.Types.User Methods hashWithSalt :: Int -> User -> Int # hash :: User -> Int #
FromXML User Source #
Instance details Defined in Amazonka.IAM.Types.User Methods parseXML :: [Node] -> Either String User #
type Rep User Source #
Instance details Defined in Amazonka.IAM.Types.User type Rep User = D1 ('MetaData "User" "Amazonka.IAM.Types.User" "libZSservicesZSamazonka-iamZSamazonka-iam" 'False) (C1 ('MetaCons "User'" 'PrefixI 'True) (((S1 ('MetaSel ('Just "passwordLastUsed") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe ISO8601)) :: S1 ('MetaSel ('Just "path") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe Text))) :: (S1 ('MetaSel ('Just "permissionsBoundary") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe AttachedPermissionsBoundary)) :: S1 ('MetaSel ('Just "tags") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 (Maybe [Tag])))) :: ((S1 ('MetaSel ('Just "userName") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :: S1 ('MetaSel ('Just "userId") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text)) :: (S1 ('MetaSel ('Just "arn") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 Text) :*: S1 ('MetaSel ('Just "createDate") 'NoSourceUnpackedness 'NoSourceStrictness 'DecidedStrict) (Rec0 ISO8601)))))

newUser Source #

Arguments

:: Text	`$sel:userName:User'`
-> Text	`$sel:userId:User'`
-> Text	`$sel:arn:User'`
-> UTCTime	`$sel:createDate:User'`
-> User

Create a value of User 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:passwordLastUsed:User', user_passwordLastUsed - The date and time, in ISO 8601 date-time format, when the user's password was last used to sign in to an Amazon Web Services website. For a list of Amazon Web Services websites that capture a user's last sign-in time, see the Credential reports topic in the IAM User Guide. If a password is used more than once in a five-minute span, only the first use is returned in this field. If the field is null (no value), then it indicates that they never signed in with a password. This can be because:

The user never had a password.
A password exists but has not been used since IAM started tracking this information on October 20, 2014.

A null value does not mean that the user never had a password. Also, if the user does not currently have a password but had one in the past, then this field contains the date and time the most recent password was used.

This value is returned only in the GetUser and ListUsers operations.

$sel:path:User', user_path - The path to the user. For more information about paths, see IAM identifiers in the IAM User Guide.

The ARN of the policy used to set the permissions boundary for the user.

$sel:permissionsBoundary:User', user_permissionsBoundary - For more information about permissions boundaries, see Permissions boundaries for IAM identities in the IAM User Guide.

$sel:tags:User', user_tags - A list of tags that are associated with the user. For more information about tagging, see Tagging IAM resources in the IAM User Guide.

$sel:userName:User', user_userName - The friendly name identifying the user.

$sel:userId:User', user_userId - The stable and unique string identifying the user. For more information about IDs, see IAM identifiers in the IAM User Guide.

$sel:arn:User', user_arn - The Amazon Resource Name (ARN) that identifies the user. For more information about ARNs and how to use ARNs in policies, see IAM Identifiers in the IAM User Guide.

$sel:createDate:User', user_createDate - The date and time, in ISO 8601 date-time format, when the user was created.

user_passwordLastUsed :: Lens' User (Maybe UTCTime) Source #

The date and time, in ISO 8601 date-time format, when the user's password was last used to sign in to an Amazon Web Services website. For a list of Amazon Web Services websites that capture a user's last sign-in time, see the Credential reports topic in the IAM User Guide. If a password is used more than once in a five-minute span, only the first use is returned in this field. If the field is null (no value), then it indicates that they never signed in with a password. This can be because:

The user never had a password.
A password exists but has not been used since IAM started tracking this information on October 20, 2014.

A null value does not mean that the user never had a password. Also, if the user does not currently have a password but had one in the past, then this field contains the date and time the most recent password was used.

This value is returned only in the GetUser and ListUsers operations.

user_path :: Lens' User (Maybe Text) Source #

The path to the user. For more information about paths, see IAM identifiers in the IAM User Guide.

The ARN of the policy used to set the permissions boundary for the user.

user_permissionsBoundary :: Lens' User (Maybe AttachedPermissionsBoundary) Source #

For more information about permissions boundaries, see Permissions boundaries for IAM identities in the IAM User Guide.

user_tags :: Lens' User (Maybe [Tag]) Source #

A list of tags that are associated with the user. For more information about tagging, see Tagging IAM resources in the IAM User Guide.

user_userName :: Lens' User Text Source #

The friendly name identifying the user.

user_userId :: Lens' User Text Source #

The stable and unique string identifying the user. For more information about IDs, see IAM identifiers in the IAM User Guide.

user_arn :: Lens' User Text Source #

The Amazon Resource Name (ARN) that identifies the user. For more information about ARNs and how to use ARNs in policies, see IAM Identifiers in the IAM User Guide.

user_createDate :: Lens' User UTCTime Source #

The date and time, in ISO 8601 date-time format, when the user was created.