管理 IAM 用户

JavaScript code example that applies to Node.js execution

此 Node.js 代码示例演示：

如何检索 IAM 用户列表。
如何创建和删除用户。
如何更新用户名。

场景

在此示例中，一系列 Node.js 模块用于在 IAM 中创建和管理用户。Node.js 模块使用 SDK 使用以下IAM客户端类方法创建、删除和更新用户： JavaScript

有关 IAM 用户的更多信息，请参阅 IAM 用户指南中的 IAM 用户。

必备任务

要设置和运行此示例，您必须先完成以下任务：

设置项目环境以运行这些 Node TypeScript 示例，并安装所需的模块Amazon SDK for JavaScript和第三方模块。按照上的说明进行操作GitHub。
使用用户凭证创建共享配置文件。有关提供共享凭证文件的更多信息，请参阅从共享凭证文件加载 Node.js 中的凭证。

重要

这些示例演示如何使用 ecmascript6 (ES6) 导入/导出客户端服务对象和命令。

这需要 Node.js 版本 13.x 或更高版本。要下载并安装最新版本的 Node.js，请参阅 Node.js 下载。。
如果你更喜欢使用 CommonJS 语法，请参阅JavaScript es6/CommonJS 语法。

创建用户

创建一个libs目录，然后使用文件名创建 Node.js 模块iamClient.js。将以下代码复制并粘贴到其中，这将创建 IAM 客户端对象。将区域替换为您的Amazon区域。


import { IAMClient } from "@aws-sdk/client-iam";
// Set the AWS Region.
const REGION = "REGION"; // For example, "us-east-1".
// Create an IAM service client object.
const iamClient = new IAMClient({ region: REGION });
export { iamClient };

此示例代码可以在此处找到 GitHub。

创建文件名为 iam_createuser.js 的 Node.js 模块。请务必按照前面所示配置 SDK，包括下载所需的客户端和软件包。创建一个包含所需参数的 JSON 对象，该对象包含要用于新用户的用户名作为命令行参数。

调用IAM客户端服务对象的GetUserCommand方法以查看用户名是否已经存在。如果用户名称当前不存在，请调用 CreateUserCommand 方法来创建它。如果名称已存在，则将说明该结果的消息写入控制台。

注意

将 USER_NAM E 替换为要创建的用户名。


// Import required AWS SDK clients and commands for Node.js.
import { iamClient } from "./libs/iamClient.js";
import { GetUserCommand, CreateUserCommand } from "@aws-sdk/client-iam";

// Set the parameters.
export const params = { UserName: "USER_NAME" }; //USER_NAME

export const run = async () => {
  try {
    const data = await iamClient.send(new GetUserCommand(params));
    console.log(
      "User " + "USER_NAME" + " already exists",
      data.User.UserId
    );
    return data;
  } catch (err) {
    try {
      const results = await iamClient.send(new CreateUserCommand(params));
      console.log("Success", results);
      return results;
    } catch (err) {
      console.log("Error", err);
    }
  }
};
run();

要运行此示例，请在命令提示符处输入以下内容。


node iam_createuser.js

可以在此处找到此示例代码 GitHub。

在 “我的账户” 中列出用户


import { IAMClient } from "@aws-sdk/client-iam";
// Set the AWS Region.
const REGION = "REGION"; // For example, "us-east-1".
// Create an IAM service client object.
const iamClient = new IAMClient({ region: REGION });
export { iamClient };

可以在此处找到此示例代码 GitHub。

创建文件名为 iam_listusers.js 的 Node.js 模块。请务必按照前面所示配置 SDK，包括下载所需的客户端和软件包。创建一个包含列出用户时所需参数的 JSON 对象，通过将 MaxItems 参数设置为 10 来限制返回的数量。调用IAM客户端服务对象ListUsersCommand的方法。将第一个用户的名称和创建日期写入控制台。


// Import required AWS SDK clients and commands for Node.js.
import { iamClient } from "./libs/iamClient.js";
import { ListUsersCommand } from "@aws-sdk/client-iam";

// Set the parameters.
export const params = { MaxItems: 10 };

export const run = async () => {
  try {
    const data = await iamClient.send(new ListUsersCommand(params));
    return data;
    const users = data.Users || [];
    users.forEach(function (user) {
      console.log("User " + user.UserName + " created", user.CreateDate);
    });
  } catch (err) {
    console.log("Error", err);
  }
};
run();

要运行此示例，请在命令提示符处输入以下内容。


node iam_listusers.js

可以在此处找到此示例代码 GitHub。

更新用户名


import { IAMClient } from "@aws-sdk/client-iam";
// Set the AWS Region.
const REGION = "REGION"; // For example, "us-east-1".
// Create an IAM service client object.
const iamClient = new IAMClient({ region: REGION });
export { iamClient };

可以在此处找到此示例代码 GitHub。

创建文件名为 iam_updateuser.js 的 Node.js 模块。请务必按照前面所示配置 SDK，包括下载所需的客户端和软件包。创建一个包含列出用户时所需参数的 JSON 对象，并将当前用户名和新用户名都指定为命令行参数。调用IAM客户端服务对象UpdateUserCommand的方法。

注意

将 ORIGNAL_USER_NAM E 替换为要更新的用户名，将 NEW_USER_NAM E 替换为新的用户名。



// Import required AWS SDK clients and commands for Node.js.
import { iamClient } from "./libs/iamClient.js";
import { UpdateUserCommand } from "@aws-sdk/client-iam";

// Set the parameters.
export const params = {
  UserName: "ORIGINAL_USER_NAME", //ORIGINAL_USER_NAME
  NewUserName: "NEW_USER_NAME", //NEW_USER_NAME
};

export const run = async () => {
  try {
    const data = await iamClient.send(new UpdateUserCommand(params));
    console.log("Success, username updated");
    return data;
  } catch (err) {
    console.log("Error", err);
  }
};
run();

要运行该示例，请在命令提示符下输入以下内容，指定用户的当前名称，然后指定新用户名。


node iam_updateuser.js

可以在此处找到此示例代码 GitHub。

删除用户


import { IAMClient } from "@aws-sdk/client-iam";
// Set the AWS Region.
const REGION = "REGION"; // For example, "us-east-1".
// Create an IAM service client object.
const iamClient = new IAMClient({ region: REGION });
export { iamClient };

可以在此处找到此示例代码 GitHub。

创建文件名为 iam_deleteuser.js 的 Node.js 模块。请务必按照前面所示配置 SDK，包括下载所需的客户端和软件包。创建包含所需参数的 JSON 对象，该对象包含要作为命令行参数删除的用户名。

调用IAM客户端服务对象的GetUserCommand方法以查看用户名是否已经存在。如果该用户名当前不存在，则将说明该结果的消息写入控制台。如果用户存在，则调用 DeleteUserCommand 方法删除该用户。

注意

将 USER_NAM E 替换为要删除的用户名。


// Import required AWS SDK clients and commands for Node.js.
import { iamClient } from "./libs/iamClient.js";
import { DeleteUserCommand, GetUserCommand } from "@aws-sdk/client-iam";

// Set the parameters.
export const params = { UserName: "USER_NAME" }; //USER_NAME

export const run = async () => {
  try {
    const data = await iamClient.send(new GetUserCommand(params));
    return data;
    try {
      const results = await iamClient.send(new DeleteUserCommand(params));
      console.log("Success", results);
      return results;
    } catch (err) {
      console.log("Error", err);
    }
  } catch (err) {
    console.log("User " + "USER_NAME" + " does not exist.");
  }
};
run();

要运行此示例，请在命令提示符处输入以下内容。


node iam_deleteuser.js

可以在此处找到此示例代码 GitHub。

Javascript 在您的浏览器中被禁用或不可用。

要使用 Amazon Web Services 文档，必须启用 Javascript。请参阅浏览器的帮助页面以了解相关说明。

Amazon Identity and Access Management 示例

使用 IAM 策略