IAM / Client / update_login_profile

update_login_profile#

IAM.Client.update_login_profile(**kwargs)#

Changes the password for the specified IAM user. You can use the CLI, the Amazon Web Services API, or the Users page in the IAM console to change the password for any IAM user. Use ChangePassword to change your own password in the My Security Credentials page in the Amazon Web Services Management Console.

For more information about modifying passwords, see Managing passwords in the IAM User Guide.

See also: AWS API Documentation

Request Syntax

response = client.update_login_profile(
    UserName='string',
    Password='string',
    PasswordResetRequired=True|False
)
Parameters:

  • UserName (string) –

    [REQUIRED]

    The name of the user whose password you want to update.

    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: _+=,.@-

  • Password (string) –

    The new password for the specified IAM user.

    The regex pattern used to validate this parameter is a string of characters consisting of the following:

    • Any printable ASCII character ranging from the space character ( \u0020) through the end of the ASCII character range

    • The printable characters in the Basic Latin and Latin-1 Supplement character set (through \u00FF)

    • The special characters tab ( \u0009), line feed ( \u000A), and carriage return ( \u000D)

    However, the format can be further restricted by the account administrator by setting a password policy on the Amazon Web Services account. For more information, see UpdateAccountPasswordPolicy.

  • PasswordResetRequired (boolean) – Allows this new password to be used only once by requiring the specified IAM user to set a new password on next sign-in.

Returns:

None

Exceptions

  • IAM.Client.exceptions.EntityTemporarilyUnmodifiableException

  • IAM.Client.exceptions.NoSuchEntityException

  • IAM.Client.exceptions.PasswordPolicyViolationException

  • IAM.Client.exceptions.LimitExceededException

  • IAM.Client.exceptions.ServiceFailureException

Examples

The following command creates or changes the password for the IAM user named Bob.

response = client.update_login_profile(
    Password='SomeKindOfPassword123!@#',
    UserName='Bob',
)

print(response)

Expected Output:

{
    'ResponseMetadata': {
        '...': '...',
    },
}