AWS-AttachIAMToInstance - AWS Systems Manager Référence du manuel d'automatisation

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

Description

Attachez un rôle AWS Identity and Access Management (IAM) à une instance gérée.

Exécuter cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

LinuxmacOS, Windows

Paramètres

  • AutomationAssumeRole

    Type : String

    Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle AWS Identity and Access Management (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 : booléen

    Description : (Facultatif) Indicateur pour indiquer s'il faut remplacer le IAM profil existant ou non.

    Valeur par défaut : true

  • InstanceId

    Type : String

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

  • RoleName

    Type : String

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

Étapes de document

  1. aws:executeAwsApi- DescribeInstanceProfile - Trouvez le profil d'IAMinstance attaché à l'EC2instance.

  2. aws:branch- CheckInstanceProfileAssociations - Vérifiez le profil d'IAMinstance attaché à l'EC2instance.

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

      1. aws:executeAwsApi- DisassociateIamInstanceProfile - Dissociez le profil d'IAMinstance de l'EC2instance.

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

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

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

        1. aws:executeAwsApi- A ttachIAMProfile ToInstance - Attachez le rôle du profil d'IAMinstance à l'EC2instance.

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

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

        2. aws:executeAwsApi- AddRoleToInstanceProfile - Attachez le rôle du profil d'instance au IAM rôle spécifié.

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

        4. aws:executeAwsApi- A ttachIAMProfile ToInstanceWithRetry - Attachez le rôle du profil d'IAMinstance à l'EC2instance.

Sorties

ttachIAMProfileToInstanceWithRetryA. AssociationId

GetInstanceProfile.InstanceProfileName

GetInstanceProfile.InstanceProfileArn

ttachIAMProfileToInstanceA. AssociationId

ListInstanceProfilesForRole.InstanceProfileName

ListInstanceProfilesForRole.InstanceProfileArn