Anunciamos el próximo fin del soporte para AWS SDK for JavaScript v2. Se recomienda que migre a AWS SDK for JavaScript v3. Para ver las fechas, los detalles adicionales y la información sobre cómo realizar la migración, consulte el anuncio enlazado.

Administración de alias de cuenta de IAM

Este ejemplo de código de Node.js muestra:

El escenario

Si quiere que la dirección URL de la página de inicio de sesión contenga el nombre de su empresa u otro identificador fácilmente reconocible en lugar de su ID de cuenta de AWS, puede crear un alias para el ID de cuenta de AWS. Si crea un alias de cuenta de AWS, la dirección URL de su página de inicio de sesión cambia para incorporar dicho alias.

En este ejemplo, se van a utilizar una serie de módulos de Node.js para crear y administrar alias de cuenta de IAM. Los módulos de Node.js usan el SDK para JavaScript para gestionar alias mediante los métodos de clase de cliente AWS.IAM siguientes:

Para obtener más información acerca de los alias de cuenta de IAM, consulte ID y alias de su cuenta de AWS en la Guía del usuario de IAM.

Tareas previas necesarias

Para configurar y ejecutar este ejemplo, primero debe completar estas tareas:

Creación de un alias de cuenta

Cree un módulo de Node.js con el nombre de archivo iam_createaccountalias.js. Asegúrese de configurar el SDK tal y como se ha indicado anteriormente. Para obtener acceso a IAM, cree un objeto de servicio AWS.IAM. Cree un objeto JSON que contenga los parámetros necesarios para crear un alias de cuenta y que incluya el alias que desea crear. Llame al método createAccountAlias del objeto de servicio de 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 ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.

node iam_createaccountalias.js ALIAS

Este código de ejemplo se puede encontrar aquí en GitHub.

Mostrar alias de cuenta

Cree un módulo de Node.js con el nombre de archivo iam_listaccountaliases.js. Asegúrese de configurar el SDK tal y como se ha indicado anteriormente. Para obtener acceso a IAM, cree un objeto de servicio AWS.IAM. Cree un objeto JSON que contenga los parámetros necesarios para generar una lista de alias de la cuenta y que incluya el número máximo de elementos que se devolverán. Llame al método listAccountAliases del objeto de servicio de 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 ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.

node iam_listaccountaliases.js

Este código de ejemplo se puede encontrar aquí en GitHub.

Eliminación de un alias de la cuenta

Cree un módulo de Node.js con el nombre de archivo iam_deleteaccountalias.js. Asegúrese de configurar el SDK tal y como se ha indicado anteriormente. Para obtener acceso a IAM, cree un objeto de servicio AWS.IAM. Cree un objeto JSON que contenga los parámetros necesarios para eliminar un alias de la cuenta y que incluya el alias que desea eliminar. Llame al método deleteAccountAlias del objeto de servicio de 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 ejecutar el ejemplo, escriba lo siguiente en la línea de comandos.

node iam_deleteaccountalias.js ALIAS

Este código de ejemplo se puede encontrar aquí en GitHub.