La versión 2 de AWS SDK para JavaScript ha llegado al final del soporte. Se recomienda que migre a [AWS SDK para JavaScript v3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/). Para ver detalles e información adicionales sobre cómo realizar la migración, consulte este [anuncio](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).
# Administración de alias de cuenta de IAM
![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/es_es/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)
**Este ejemplo de código de Node.js muestra:**
+ Cómo administrar alias para su ID de cuenta de AWS.
## 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:
+ [createAccountAlias](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IAM.html#createAccountAlias-property)
+ [listAccountAliases](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IAM.html#listAccountAliases-property)
+ [deleteAccountAlias](https://docs.aws.amazon.com/AWSJavaScriptSDK/latest/AWS/IAM.html#deleteAccountAlias-property)
Para obtener más información acerca de los alias de cuenta de IAM, consulte [ID y alias de su cuenta de AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html) en la *Guía del usuario de IAM*.
## Tareas previas necesarias
Para configurar y ejecutar este ejemplo, primero debe completar estas tareas:
+ Instale Node.js. Para obtener más información acerca de la instalación de Node.js consulte el [sitio web de Node.js](https://nodejs.org).
+ Cree un archivo de configuraciones compartidas con sus credenciales de usuario. Para obtener más información acerca de cómo crear un archivo de credenciales compartidas, consulte [Carga de credenciales en Node.js desde el archivo de credenciales compartidas](loading-node-credentials-shared.md).
## 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/iam/iam_createaccountalias.js).
## 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/iam/iam_listaccountaliases.js).
## 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](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/iam/iam_deleteaccountalias.js).