update_login_profile async ¶

async def update_login_profile(
    self,
    user_name: "capo_iam.types.user_name_type.userNameType",
    *,
    config_overrides: Optional[AsyncIAMClientConfig] = None,
    password: Optional["capo_iam.types.password_type.passwordType"] = None,
    password_reset_required: Optional[
        "capo_iam.types.boolean_object_type.booleanObjectType"
    ] = None,
) -> None:
    r"""<p>Changes the password for the specified IAM user. You can use the CLI, the Amazon Web Services API, or the <b>Users</b> page in the IAM console to change the password for any IAM user. Use <a href="https://docs.aws.amazon.com/IAM/latest/APIReference/API_ChangePassword.html">ChangePassword</a> to change your own password in the <b>My Security Credentials</b> page in the Amazon Web Services Management Console.</p> <p>For more information about modifying passwords, see <a href="https://docs.aws.amazon.com/IAM/latest/UserGuide/Using_ManagingLogins.html">Managing passwords</a> in the <i>IAM User Guide</i>.</p>

    Args:
        user_name: <p>The name of the user whose password you want to update.</p> <p>This parameter allows (through its <a href="http://wikipedia.org/wiki/regex">regex pattern</a>) a string of characters consisting of upper and lowercase alphanumeric characters with no spaces. You can also include any of the following characters: _+=,.@-</p>
        password: <p>The new password for the specified IAM user.</p> <p>The <a href="http://wikipedia.org/wiki/regex">regex pattern</a> used to validate this parameter is a string of characters consisting of the following:</p> <ul> <li> <p>Any printable ASCII character ranging from the space character (<code>\u0020</code>) through the end of the ASCII character range</p> </li> <li> <p>The printable characters in the Basic Latin and Latin-1 Supplement character set (through <code>\u00FF</code>)</p> </li> <li> <p>The special characters tab (<code>\u0009</code>), line feed (<code>\u000A</code>), and carriage return (<code>\u000D</code>)</p> </li> </ul> <p>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 <a href="https://docs.aws.amazon.com/IAM/latest/APIReference/API_UpdateAccountPasswordPolicy.html">UpdateAccountPasswordPolicy</a>.</p>
        password_reset_required: <p>Allows this new password to be used only once by requiring the specified IAM user to set a new password on next sign-in.</p>

    Raises:
        capo_iam.errors.entity_temporarily_unmodifiable_exception.EntityTemporarilyUnmodifiableException: <p>The request was rejected because it referenced an entity that is temporarily unmodifiable, such as a user name that was deleted and then recreated. The error indicates that the request is likely to succeed if you try again after waiting several minutes. The error message describes the entity.</p>
        capo_iam.errors.limit_exceeded_exception.LimitExceededException: <p>The request was rejected because it attempted to create resources beyond the current Amazon Web Services account limits. The error message describes the limit exceeded.</p>
        capo_iam.errors.no_such_entity_exception.NoSuchEntityException: <p>The request was rejected because it referenced a resource entity that does not exist. The error message describes the resource.</p>
        capo_iam.errors.password_policy_violation_exception.PasswordPolicyViolationException: <p>The request was rejected because the provided password did not meet the requirements imposed by the account password policy.</p>
        capo_iam.errors.service_failure_exception.ServiceFailureException: <p>The request processing has failed because of an unknown error, exception or failure.</p>
        capo_iam.errors.UnknownServiceError: The service returned an error code this client does not model.

    Examples:
        To change the password for an IAM user
        The following command creates or changes the password for the IAM user named Bob.

        >>> await client.update_login_profile(user_name='Bob', password='SomeKindOfPassword123!@#')
    """

    async def _handler(
        req: "AsyncOperationRequest[capo_iam.types.update_login_profile_request.UpdateLoginProfileRequest]",
    ) -> AsyncOperationResponse[None]:
        import capo_iam._operations.aws_identity_management_v20100508.update_login_profile

        (
            output,
            http_response,
        ) = await capo_iam._operations.aws_identity_management_v20100508.update_login_profile.async_update_login_profile(
            req.options, req.input
        )
        return AsyncOperationResponse(output=output, response=http_response)

    def _redact_input(
        input_: "capo_iam.types.update_login_profile_request.UpdateLoginProfileRequest",
    ) -> dict[str, Any]:
        import capo_iam.types.update_login_profile_request

        return capo_iam.types.update_login_profile_request.redact_sensitive(input_)

    interceptors_, options_ = self.operation_options(
        config_overrides,
        OperationLogging("UpdateLoginProfile", redact_input=_redact_input),
    )
    input_: capo_iam.types.update_login_profile_request.UpdateLoginProfileRequest = {
        "user_name": user_name
    }
    if password is not None:
        input_["password"] = password
    if password_reset_required is not None:
        input_["password_reset_required"] = password_reset_required

    response = await aexecute_pipeline(
        AsyncOperationRequest(input=input_, options=options_),
        handler=_handler,
        interceptors=list(interceptors_),
    )
    await response.response.aclose()
    return response.output