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.

# `AWS-AttachIAMToInstance`
<a name="automation-aws-attachiamtoinstance"></a>

 **Description** 

Attachez un rôle Gestion des identités et des accès AWS (IAM) à une instance gérée.

 [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-AttachIAMToInstance) 

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

Linux,macOS, Windows

**Paramètres**
+ AutomationAssumeRole

  Type : Chaîne

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
+ ForceReplace

  Type : Boolean

  Description : (Facultatif) Indicateur pour indiquer si le profil IAM existant doit être remplacé ou non.

  Valeur par défaut : true
+ InstanceId

  Type : Chaîne

  Description : (Obligatoire) L'ID de l'instance à laquelle vous souhaitez attribuer un rôle IAM.
+ RoleName

  Type : Chaîne

  Description : (Obligatoire) Le nom du rôle IAM à ajouter à l'instance gérée.

 **Étapes de document** 

1.  `aws:executeAwsApi`- DescribeInstanceProfile - Trouvez le profil d'instance IAM attaché à l'instance EC2. 

1.  `aws:branch`- CheckInstanceProfileAssociations - Vérifiez le profil d'instance IAM attaché à l'instance EC2. 

   1.  Si un profil d'instance IAM est attaché et `ForceReplace` est défini sur : `true` 

      1.  `aws:executeAwsApi`- DisassociateIamInstanceProfile - Dissociez le profil d'instance IAM de l'instance EC2. 

   1.  `aws:executeAwsApi`- ListInstanceProfilesForRole - Répertoriez les profils d'instance pour le rôle IAM fourni. 

   1.  `aws:branch`- CheckInstanceProfileCreated - Vérifiez si un profil d'instance est associé au rôle IAM fourni. 

      1. Si un profil d'instance est associé au rôle IAM :

         1.  `aws:executeAwsApi`- AttachIAMProfileToInstance - Attachez le rôle de profil d'instance IAM à l'instance EC2. 

      1. Si aucun profil d'instance n'est associé au rôle IAM :

         1.  `aws:executeAwsApi`- CreateInstanceProfileForRole - Créez un rôle de profil d'instance pour le rôle IAM spécifié. 

         1.  `aws:executeAwsApi`- AddRoleToInstanceProfile - Attachez le rôle de profil d'instance au rôle IAM spécifié. 

         1.  `aws:executeAwsApi`- GetInstanceProfile - Obtenez les données du profil d'instance pour le rôle IAM spécifié. 

         1.  `aws:executeAwsApi`- AttachIAMProfileToInstanceWithRetry - Attachez le rôle de profil d'instance IAM à l'instance EC2. 

 **Sorties** 

AttachIAMProfileToInstanceWithRetry.AssociationId

GetInstanceProfile.InstanceProfileName

GetInstanceProfile.InstanceProfileArn

AttachIAMProfileToInstance.AssociationId

ListInstanceProfilesForRole.InstanceProfileName

ListInstanceProfilesForRole.InstanceProfileArn