changePassword method

Future<void> changePassword({ required String newPassword, required String oldPassword, })

Changes the password of the IAM user who is calling this operation. The AWS account root user password is not affected by this operation.

To change the password for a different user, see UpdateLoginProfile. For more information about modifying passwords, see Managing Passwords in the IAM User Guide.

May throw NoSuchEntityException. May throw InvalidUserTypeException. May throw LimitExceededException. May throw EntityTemporarilyUnmodifiableException. May throw PasswordPolicyViolationException. May throw ServiceFailureException.

Parameter newPassword : The new password. The new password must conform to the AWS account's password policy, if one exists.

The regex pattern that is used to validate this parameter is a string of characters. That string can include almost any printable ASCII character from the space (\u0020) through the end of the ASCII character range (\u00FF). You can also include the tab (\u0009), line feed (\u000A), and carriage return (\u000D) characters. Any of these characters are valid in a password. However, many tools, such as the AWS Management Console, might restrict the ability to type certain characters because they have special meaning within that tool.

Parameter oldPassword : The IAM user's current password.

Implementation

Future<void> changePassword({
  required String newPassword,
  required String oldPassword,
}) async {
  ArgumentError.checkNotNull(newPassword, 'newPassword');
  _s.validateStringLength(
    'newPassword',
    newPassword,
    1,
    128,
    isRequired: true,
  );
  ArgumentError.checkNotNull(oldPassword, 'oldPassword');
  _s.validateStringLength(
    'oldPassword',
    oldPassword,
    1,
    128,
    isRequired: true,
  );
  final $request = <String, dynamic>{};
  $request['NewPassword'] = newPassword;
  $request['OldPassword'] = oldPassword;
  await _protocol.send(
    $request,
    action: 'ChangePassword',
    version: '2010-05-08',
    method: 'POST',
    requestUri: '/',
    exceptionFnMap: _exceptionFns,
    shape: shapes['ChangePasswordRequest'],
    shapes: shapes,
  );
}