管理 IAM 账户别名

JavaScript code example that applies to Node.js execution

此 Node.js 代码示例演示：

如何管理Amazon账户 ID 的别名。

场景

如果您希望在登录页面的 URL 用贵公司名称或其他友好标识取代您的Amazon账户 ID，可以为Amazon账户 ID 创建一个别名。如果您创建 Amazon 账户别名，您的登录页面 URL 将更改以包含该别名。

在此示例中，一系列 Node.js 模块用于创建和管理 IAM 账户别名。Node.js 模块使用 SDK JavaScript 来使用IAM客户端类的以下方法管理别名：

有关 IAM 账户别名的更多信息，请参阅 IA M 用户指南中的您的Amazon账户 ID 及其别名。

必备任务

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

设置项目环境以运行这些 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_createaccountalias.js 的 Node.js 模块。请务必按照前面所示配置 SDK，包括下载所需的客户端和软件包。创建一个 JSON 对象，其中包含创建账户别名所需的参数，其中包括要创建的别名。调用IAM客户端服务对象CreateAccountAliasCommand的方法。

注意

将 ACCO UNT_ALIA S 替换为要创建的别名。


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

// Set the parameters.
export const params = { AccountAlias: "ACCOUNT_ALIAS" }; //ACCOUNT_ALIAS

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

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


node iam_createaccountalias.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_listaccountaliases.js 的 Node.js 模块。请务必按照前面显示的客户端配置 SDK，包括下载所需的客户端和软件包。创建一个包含列出账户别名时所需参数的 JSON 对象，其中包括要返回的最大项数。调用IAM客户端服务对象ListAccountAliasesCommand的方法。


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

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

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

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


node iam_listaccountaliases.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_deleteaccountalias.js 的 Node.js 模块。请务必按照前面所示配置 SDK，包括下载所需的客户端和软件包。创建一个包含删除账户别名时所需参数的 JSON 对象，其中包括您要删除的别名。调用 IAM 服务对象的 DeleteAccountAliasCommand 方法。

注意

将 ALIAS 替换为要删除的别名的名称。


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

// Set the parameters.
export const params = { AccountAlias: "ALIAS" }; // ALIAS

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

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


node iam_deleteaccountalias.js

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

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

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

使用 IAM 服务器证书

Amazon Kinesis 示例