Skip to content

IAM  >  Operations  >  update_login_profile

update_login_profile

Operation

update_login_profile async

update_login_profile(request: UpdateLoginProfileInput | UpdateLoginProfileInputDict, /, *, plugins: list[Plugin] | None = None) -> UpdateLoginProfileOutput
update_login_profile(*, plugins: list[Plugin] | None = None, **kwargs: Unpack[UpdateLoginProfileInputDict]) -> UpdateLoginProfileOutput

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.

Parameters:

Name Type Description Default
plugins list[Plugin] | None

A list of callables that modify the configuration dynamically. Changes made by these plugins only apply for the duration of the operation execution and will not affect any other operation invocations.

None

Returns:

Type Description
UpdateLoginProfileOutput

An instance of UpdateLoginProfileOutput.

Input

Pass the input fields as keyword arguments, or pass a model or dictionary as the first positional argument. Pass plugins separately as a keyword argument.

Model

UpdateLoginProfileInput dataclass

Bases: _SerdeShape

Dataclass for UpdateLoginProfileInput structure.

Attributes
password class-attribute instance-attribute
password: str | None = ...

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.

password_reset_required class-attribute instance-attribute
password_reset_required: bool | None = ...

Allows this new password to be used only once by requiring the specified IAM user to set a new password on next sign-in.

user_name class-attribute instance-attribute
user_name: str | None = ...

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

Dictionaries

UpdateLoginProfileInputDict

Bases: TypedDict

Dictionary form of UpdateLoginProfileInput.

Attributes
password instance-attribute
password: str | None

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.

password_reset_required instance-attribute
password_reset_required: bool | None

Allows this new password to be used only once by requiring the specified IAM user to set a new password on next sign-in.

user_name instance-attribute
user_name: Required[str]

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

Output

UpdateLoginProfileOutput dataclass

Bases: _SerdeShape

Dataclass for UpdateLoginProfileOutput structure.

Attributes

response_metadata class-attribute instance-attribute
response_metadata: ResponseMetadata = ...

Metadata about the response that produced this output. Use this to recover the request identifiers a service's support team needs in order to investigate a call. Members of the metadata are individually optional.