将 ChangePassword 与 AWS SDK 或 CLI 配合使用

以下代码示例演示如何使用 ChangePassword。

CLI

AWS CLI

更改 IAM 用户的密码

要更改 IAM 用户的密码，建议使用 --cli-input-json 参数传递包含新旧密码的 JSON 文件。通过此方法，您可以使用含有非字母数字字符的强密码。将密码作为命令行参数传递时，可能难以使用含有非字母数字字符的密码。要使用 --cli-input-json 参数，请先使用带 --generate-cli-skeleton 参数的 change-password 命令，如以下示例所示。

aws iam change-password \
    --generate-cli-skeleton > change-password.json

前述命令创建一个名为 change-password.json 的 JSON 文件，您可以用该文件来填写旧密码和新密码。例如，该文件可能如下所示。

{
    "OldPassword": "3s0K_;xh4~8XXI",
    "NewPassword": "]35d/{pB9Fo9wJ"
}

接下来，要更改密码，请再次使用 change-password 命令，这次是传递 --cli-input-json 参数以指定您的 JSON 文件。以下 change-password 命令将 --cli-input-json 参数与名为 change-password.json 的 JSON 文件一起使用。

aws iam change-password \
    --cli-input-json file://change-password.json

此命令不生成任何输出。

此命令只能由 IAM 用户调用。如果使用 AWS 账户（根）凭证调用此命令，则命令将返回 InvalidUserType 错误。

有关更多信息，请参阅《AWS IAM 用户指南》中的 IAM 用户如何更改自己的密码。

• 有关 API 详细信息，请参阅《AWS CLI 命令参考》中的 ChangePassword。

PowerShell

适用于 PowerShell 的工具

示例 1：此命令更改运行该命令的用户的密码。此命令只能由 IAM 用户调用。如果您在使用 AWS 账户（根）凭证登录时调用此命令，则命令将返回 InvalidUserType 错误。

Edit-IAMPassword -OldPassword "MyOldP@ssw0rd" -NewPassword "MyNewP@ssw0rd"

• 有关 API 详细信息，请参阅《AWS Tools for PowerShell Cmdlet 参考》中的 ChangePassword。

有关 AWS SDK 开发人员指南和代码示例的完整列表，请参阅 将此服务与 AWS SDK 结合使用。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。