Anunciamos o próximo fim do suporte para o AWS SDK for JavaScript v2. Recomendamos migrar para o AWS SDK for JavaScript v3. Para saber as datas e receber detalhes adicionais e informações sobre como migrar, consulte o anúncio vinculado.

Gerenciar aliases de conta do IAM

Este exemplo de código Node.js mostra:

O cenário

Se deseja que o URL para sua página de login contenha o nome da sua empresa (ou outro identificador amigável) em vez do ID da sua conta da AWS, você pode criar um alias para o ID de sua conta da AWS. Se você criar um alias de conta do AWS, a URL de sua página de login será alterada para incorporar esse alias.

Neste exemplo, é usada uma série de módulos do Node.js para criar e gerenciar aliases da conta do IAM. Os módulos do Node.js usam o SDK para JavaScript para gerenciar aliases usando estes métodos da classe de cliente AWS.IAM:

Para obter mais informações sobre alias de contas do IAM, consulte ID da sua conta da AWS e seu alias no Guia do usuário do IAM.

Tarefas de pré-requisito

Para configurar e executar este exemplo, você deve primeiro concluir estas tarefas:

Criar um alias da conta

Crie um módulo do Node.js com o nome de arquivo iam_createaccountalias.js. Não se esqueça de configurar o SDK conforme mostrado anteriormente. Para acessar o IAM, crie um objeto de serviço do AWS.IAM. Crie um objeto JSON contendo os parâmetros necessários para criar um alias de conta, que inclui o alias que você deseja criar. Chame o método createAccountAlias do objeto de serviço do AWS.IAM.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the IAM service object
var iam = new AWS.IAM({ apiVersion: "2010-05-08" });

iam.createAccountAlias({ AccountAlias: process.argv[2] }, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Para executar o exemplo, digite o seguinte na linha de comando.

node iam_createaccountalias.js ALIAS

Este código de exemplo pode ser encontrado aqui no GitHub.

Listar aliases de conta

Crie um módulo do Node.js com o nome de arquivo iam_listaccountaliases.js. Não se esqueça de configurar o SDK conforme mostrado anteriormente. Para acessar o IAM, crie um objeto de serviço do AWS.IAM. Crie um objeto JSON contendo os parâmetros necessários para listar os aliases de conta, que inclui o número máximo de itens a serem retornados. Chame o método listAccountAliases do objeto de serviço do AWS.IAM.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the IAM service object
var iam = new AWS.IAM({ apiVersion: "2010-05-08" });

iam.listAccountAliases({ MaxItems: 10 }, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Para executar o exemplo, digite o seguinte na linha de comando.

node iam_listaccountaliases.js

Este código de exemplo pode ser encontrado aqui no GitHub.

Excluir um alias de conta

Crie um módulo do Node.js com o nome de arquivo iam_deleteaccountalias.js. Não se esqueça de configurar o SDK conforme mostrado anteriormente. Para acessar o IAM, crie um objeto de serviço do AWS.IAM. Crie um objeto JSON contendo os parâmetros necessários para excluir um alias de conta, que inclui o alias que você deseja excluir. Chame o método deleteAccountAlias do objeto de serviço do AWS.IAM.

// Load the AWS SDK for Node.js
var AWS = require("aws-sdk");
// Set the region
AWS.config.update({ region: "REGION" });

// Create the IAM service object
var iam = new AWS.IAM({ apiVersion: "2010-05-08" });

iam.deleteAccountAlias({ AccountAlias: process.argv[2] }, function (err, data) {
  if (err) {
    console.log("Error", err);
  } else {
    console.log("Success", data);
  }
});

Para executar o exemplo, digite o seguinte na linha de comando.

node iam_deleteaccountalias.js ALIAS

Este código de exemplo pode ser encontrado aqui no GitHub.