Nous avons annoncé la sortie end-of-support de la AWS SDK for JavaScript v2. Nous vous recommandons de migrer vers la AWS SDK for JavaScript version 3. Pour les dates, les détails supplémentaires et les informations sur la façon de migrer, reportez-vous à l'annonce associée.

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

Cet exemple de code Node.js présente :

Scénario

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 compte AWS, l'URL de votre page de connexion est modifiée de manière à 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 :

Pour plus d'informations sur les alias de compte IAM, consultez la section Votre identifiant de AWS compte et son alias dans le guide de l'utilisateur IAM.

Tâches prérequises

Pour configurer et exécuter cet exemple, vous devez d'abord :

Création d'un alias de compte

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.

Liste des alias de compte

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.

Suppression d'un alias de compte

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.