Skip to content

IAM  >  Structures  >  User

User

Structure Class

User dataclass

Bases: _SerdeShape

Contains information about an IAM user entity.

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

Attributes

arn instance-attribute 
arn: str

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.

create_date instance-attribute 
create_date: datetime

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

password_last_used class-attribute instance-attribute 
password_last_used: datetime | None = ...

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 instance-attribute 
path: str

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.

permissions_boundary class-attribute instance-attribute 
permissions_boundary: AttachedPermissionsBoundary | None = ...

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

tags class-attribute instance-attribute 
tags: list[Tag] | None = ...

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_id instance-attribute 
user_id: str

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

user_name instance-attribute 
user_name: str

The friendly name identifying the user.