

La AWS SDK pour JavaScript v2 est arrivée end-of-support. Nous vous recommandons de migrer vers la [AWS SDK pour JavaScript version 3](https://docs.aws.amazon.com//sdk-for-javascript/v3/developer-guide/). Pour plus de détails et d'informations sur la façon de migrer, veuillez consulter cette [annonce](https://aws.amazon.com/blogs//developer/announcing-end-of-support-for-aws-sdk-for-javascript-v2/).

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Gestion des alias de compte IAM
<a name="iam-examples-account-aliases"></a>

![\[JavaScript code example that applies to Node.js execution\]](http://docs.aws.amazon.com/fr_fr/sdk-for-javascript/v2/developer-guide/images/nodeicon.png)

**Cet exemple de code Node.js présente :**
+ Comment gérer les alias de votre identifiant de AWS compte.

## Scénario
<a name="iam-examples-account-aliases-scenario"></a>

Si vous souhaitez que l'URL de votre page de connexion contienne le nom de votre entreprise ou un autre identifiant convivial au lieu de votre identifiant de AWS compte, vous pouvez créer un alias pour votre identifiant de AWS compte. Si vous créez un alias de AWS compte, l'URL de votre page de connexion change pour intégrer l'alias.

Dans cet exemple, une série de modules Node.js sont utilisés pour créer et gérer des alias de comptes IAM. Les modules Node.js utilisent le SDK pour gérer les alias JavaScript à l'aide des méthodes suivantes de la classe `AWS.IAM` client :
+ [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)

Pour plus d'informations sur les alias de compte IAM, consultez la section [Votre identifiant de AWS compte et son alias](https://docs.aws.amazon.com/IAM/latest/UserGuide/console_account-alias.html) dans le guide de l'utilisateur *IAM*.

## Tâches prérequises
<a name="iam-examples-account-aliases-prerequisites"></a>

Pour configurer et exécuter cet exemple, vous devez d'abord :
+ Installez Node.js. Pour plus d'informations sur l'installation de Node.js, consultez le [site web de Node.js](https://nodejs.org).
+ Créez un fichier de configurations partagé avec vos informations d'identification utilisateur. Pour plus d'informations sur le fichier d'informations d'identification partagé, consultez [Chargement des informations d'identification dans Node.js à partir du fichier d'informations d'identification partagé](loading-node-credentials-shared.md).

## Création d'un alias de compte
<a name="iam-examples-account-aliases-creating"></a>

Créez un module Node.js nommé `iam_createaccountalias.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à IAM, créez un objet `AWS.IAM` de service. Créez un objet JSON contenant les paramètres requis pour créer un alias de compte, ce qui inclut l'alias que vous voulez créer. Appelez la méthode `createAccountAlias` de l'objet de service `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);
  }
});
```

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

```
node iam_createaccountalias.js ALIAS
```

Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/iam/iam_createaccountalias.js).

## Liste des alias de compte
<a name="iam-examples-account-aliases-listing"></a>

Créez un module Node.js nommé `iam_listaccountaliases.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à IAM, créez un objet `AWS.IAM` de service. Créez un objet JSON contenant les paramètres requis pour répertorier les alias de compte, ce qui inclut le nombre maximal d'éléments à renvoyer. Appelez la méthode `listAccountAliases` de l'objet de service `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);
  }
});
```

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

```
node iam_listaccountaliases.js
```

Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/iam/iam_listaccountaliases.js).

## Suppression d'un alias de compte
<a name="iam-examples-account-aliases-deleting"></a>

Créez un module Node.js nommé `iam_deleteaccountalias.js`. Veillez à configurer le kit SDK comme indiqué précédemment. Pour accéder à IAM, créez un objet `AWS.IAM` de service. Créez un objet JSON contenant les paramètres requis pour supprimer un alias de compte, ce qui inclut l'alias que vous voulez supprimer. Appelez la méthode `deleteAccountAlias` de l'objet de service `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);
  }
});
```

Pour exécuter l'exemple, entrez ce qui suit dans la ligne de commande.

```
node iam_deleteaccountalias.js ALIAS
```

Cet exemple de code se trouve [ici sur GitHub](https://github.com/awsdocs/aws-doc-sdk-examples/tree/master/javascript/example_code/iam/iam_deleteaccountalias.js).