Amazon n' CodeCatalyst est plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour de plus amples informations, veuillez consulter [Comment effectuer une migration depuis CodeCatalyst](migration.md).

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.

# Modifier le rôle IAM d'une action
<a name="deploy-environments-switch-role"></a>

Par défaut, lorsque vous associez un [environnement](deploy-environments.md) à une [action](workflows-actions.md) de flux de travail, l'action hérite du rôle IAM par défaut spécifié dans l'environnement. Vous pouvez modifier ce comportement afin que l'action utilise un rôle différent. Vous souhaiterez peut-être qu'une action utilise un rôle différent si le rôle IAM par défaut ne dispose pas des autorisations nécessaires pour fonctionner dans le AWS cloud.

Pour attribuer un rôle IAM différent à une action, vous pouvez utiliser l'option **Changer de rôle** dans l'éditeur visuel ou la `Connections:` propriété dans l'éditeur YAML. Le nouveau rôle remplace le rôle IAM par défaut spécifié dans l'environnement, ce qui vous permet de conserver le rôle IAM par défaut tel quel. Vous souhaiterez peut-être conserver le rôle IAM par défaut tel quel si d'autres actions l'utilisent.

Utilisez les instructions suivantes pour configurer une action afin d'utiliser un rôle IAM différent de celui spécifié dans son environnement.

------
#### [ Visual ]

**Pour attribuer un rôle IAM différent à une action (éditeur visuel)**

1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Choisissez votre projet.

1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**

1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.

1. Choisissez **Modifier**.

1. Choisissez la case qui représente l'action dont vous souhaitez mettre à jour le rôle IAM.

1. Cliquez sur l’onglet **Configuration**.

1. Dans le **What's in *my-environment* ?** case, choisissez l'icône représentant des points de suspension verticaux (![\[Ellipsis.\]](http://docs.aws.amazon.com/fr_fr/codecatalyst/latest/userguide/images/flows/elipsis.png)).

1. Choisissez **Changer de rôle**.

1. Dans la boîte de dialogue **Changer de rôle**, dans la liste déroulante des **rôles IAM**, choisissez le rôle IAM que vous souhaitez utiliser par l'action. Ce rôle remplacera le rôle IAM par défaut dans l'environnement. Si le rôle que vous souhaitez utiliser ne figure pas dans la liste, assurez-vous de l'avoir ajouté à votre espace. Pour de plus amples informations, veuillez consulter [Ajout de rôles IAM à des connexions de compte](ipa-connect-account-addroles.md).

   Le rôle choisi apparaît désormais dans la section **What's in *my-environment* ?** boîte avec un badge **Defined in Workflow**. Le rôle apparaît également dans le fichier de définition du flux de travail, dans la `Connections:` section.

1. (Facultatif) Choisissez **Valider** pour valider le code YAML du flux de travail avant de le valider.

1. Choisissez **Valider**, entrez un message de validation, puis choisissez à nouveau **Valider**.

------
#### [ YAML ]

**Pour attribuer un rôle IAM différent à une action (éditeur YAML)**

1. Ouvrez la CodeCatalyst console à l'[adresse https://codecatalyst.aws/](https://codecatalyst.aws/).

1. Choisissez votre projet.

1. **Dans le volet de navigation, choisissez **CI/CD**, puis Workflows.**

1. Choisissez le nom de votre flux de travail. Vous pouvez filtrer par le nom du référentiel source ou de la branche où le flux de travail est défini, ou filtrer par nom ou statut du flux de travail.

1. Choisissez **Modifier**.

1. Choisissez **YAML.**

1. Dans l'action de flux de travail dans laquelle vous souhaitez utiliser un autre rôle IAM, ajoutez une `Connections:` section similaire à la suivante :

   ```
   action-name:
     Environment:
       Name: environment-name
       Connections: 
         - Name: account-connection-name
           Role: iam-role-name
   ```

   Dans le code précédent, remplacez *account-connection-name* par le nom de la [connexion au compte](ipa-connect-account.md) contenant le rôle IAM et remplacez *iam-role-name* par le nom du rôle IAM que vous souhaitez que l'action utilise. Ce rôle remplacera le rôle IAM par défaut dans l'environnement. Assurez-vous d'avoir ajouté le rôle à votre espace. Pour de plus amples informations, veuillez consulter [Ajout de rôles IAM à des connexions de compte](ipa-connect-account-addroles.md).

   Pour plus d'informations, consultez la [Types d'action](workflows-actions.md#workflows-actions-types) rubrique. Cette rubrique contient des liens vers la documentation de chaque action, y compris sa référence YAML.

------