:doc:`IAM <../../iam>` / Client / update_login_profile

********************
update_login_profile
********************



.. py:method:: 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 <https://docs.aws.amazon.com/IAM/latest/APIReference/API_ChangePassword.html>`__ 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 <https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingLogins.html>`__ in the *IAM User Guide*.

  

  See also: `AWS API Documentation <https://docs.aws.amazon.com/goto/WebAPI/iam-2010-05-08/UpdateLoginProfile>`_  


  **Request Syntax**
  ::

    response = client.update_login_profile(
        UserName='string',
        Password='string',
        PasswordResetRequired=True|False
    )
    
  :type UserName: string
  :param UserName: **[REQUIRED]** 

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

     

    This parameter allows (through its `regex pattern <http://wikipedia.org/wiki/regex>`__) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-

    

  
  :type Password: string
  :param Password: 

    The new password for the specified IAM user.

     

    The `regex pattern <http://wikipedia.org/wiki/regex>`__ 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 <https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateAccountPasswordPolicy.html>`__.

    

  
  :type PasswordResetRequired: boolean
  :param PasswordResetRequired: 

    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**
  
  *   :py:class:`IAM.Client.exceptions.EntityTemporarilyUnmodifiableException`

  
  *   :py:class:`IAM.Client.exceptions.NoSuchEntityException`

  
  *   :py:class:`IAM.Client.exceptions.PasswordPolicyViolationException`

  
  *   :py:class:`IAM.Client.exceptions.LimitExceededException`

  
  *   :py:class:`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': {
            '...': '...',
        },
    }

  