

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.

# Utilisation de rôles pour permettre à Amazon ECS de gérer des clusters
<a name="using-service-linked-roles-for-clusters"></a>

Amazon Elastic Container Service utilise des Gestion des identités et des accès AWS rôles liés à un [service](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_terms-and-concepts.html#iam-term-service-linked-role) (IAM). Un rôle lié à un service est un type unique de rôle IAM directement lié à Amazon ECS. Service-linked les rôles sont prédéfinis par Amazon ECS et incluent toutes les autorisations dont le service a besoin pour appeler d'autres AWS services en votre nom.

Un rôle lié à un service simplifie la configuration d'Amazon ECS, car vous n'avez pas besoin d'ajouter manuellement les autorisations requises. Amazon ECS définit les autorisations de ses rôles liés à un service ; sauf définition contraire, seul Amazon ECS peut endosser ses rôles. Les autorisations définies comprennent la politique de confiance et la politique d’autorisation. De plus, cette politique d’autorisation ne peut pas être attachée à une autre entité IAM.

Vous pouvez supprimer un rôle lié à un service uniquement après la suppression préalable de ses ressources connexes. Vos ressources Amazon ECS sont ainsi protégées, car vous ne pouvez pas involontairement supprimer l’autorisation d’accéder aux ressources.

**Pour plus d'informations sur les autres services qui prennent en charge les rôles liés à un service, consultez la section [AWS Services qui fonctionnent avec IAM](https://docs.aws.amazon.com/IAM/latest/UserGuide/reference_aws-services-that-work-with-iam.html) et recherchez les services dont la valeur est **Oui dans la Service-linked colonne** des rôles.** Choisissez un **Oui** ayant un lien permettant de consulter les détails du rôle pour ce service.

## Service-linked autorisations de rôle pour Amazon ECS
<a name="service-linked-role-permissions-clusters"></a>

Amazon ECS utilise le rôle lié à un service nommé **AWSServiceRoleForECS**— Rôle pour permettre à Amazon ECS de gérer votre cluster.

Le rôle AWSServiceRoleForECS lié à un service fait confiance aux services suivants pour assumer le rôle :
+ `ecs.amazonaws.com`

La politique d'autorisations de rôle nommée AmazonECSServiceRolePolicy permet à Amazon ECS d'effectuer les actions suivantes sur les ressources spécifiées :
+ Action : lorsque vous utilisez le mode réseau de `awsvpc` pour vos tâches Amazon ECS, Amazon ECS gère le cycle de vie des interfaces réseau élastiques associées à la tâche. Cela inclut également les balises que Amazon ECS ajoute à vos interfaces réseau élastiques.
+ Action : lorsque vous utilisez un équilibreur de charge avec votre compte Amazon ECS, Amazon ECS gère l'enregistrement et l'annulation de l'enregistrement des ressources avec l'équilibreur de charge.
+ Action : lorsque vous utilisez la découverte de service Amazon ECS, Amazon ECS gère la Route 53 requise et les ressources AWS Cloud Map pour que la découverte de services fonctionne.
+ Action : lorsque vous utilisez le service de mise à l'échelle Amazon ECS, Amazon ECS gère les ressources Auto Scaling requises.
+ Action : Amazon ECS crée et gère des CloudWatch alarmes et des flux de journaux qui facilitent la surveillance de vos ressources Amazon ECS.
+ Action : lorsque vous utilisez Amazon ECS Exec, Amazon ECS gère les autorisations nécessaires pour démarrer des sessions Amazon ECS Exec pour vos tâches.
+ Action : lorsque vous utilisez Amazon ECS Service Connect, Amazon ECS gère les ressources AWS Cloud Map requises pour utiliser la fonctionnalité.
+ Action : lorsque vous utilisez des fournisseurs de capacité Amazon ECS, Amazon ECS gère les autorisations requises pour modifier le groupe Auto Scaling et ses instances Amazon EC2.
+ Action : Amazon ECS peut mettre à jour les attributs de AWS Cloud Map service pour les services gérés par Amazon ECS.
+ Action : Amazon ECS peut invoquer le provisionnement et le déprovisionnement d'Amazon EC2 ENI lors du démarrage et de l'arrêt de tâches.
+ Action : Amazon ECS peut récupérer les fenêtres d'événements Amazon EC2 pour les services et les clusters associés aux fenêtres d'événements.

Vous devez configurer les autorisations de manière à permettre à vos utilisateurs, groupes ou rôles de créer, modifier ou supprimer un rôle lié à un service. Pour plus d'informations, consultez les [autorisations relatives aux Service-linked rôles](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#service-linked-role-permissions) dans le *guide de l'utilisateur IAM*.

## Création d'un rôle lié à un service pour Amazon ECS
<a name="create-service-linked-role-clusters"></a>

Vous n’avez pas besoin de créer manuellement un rôle lié à un service. Lorsque vous créez un cluster, ou que vous créez ou mettez à jour un service dans l' AWS Management Console AWS CLI AWS API, Amazon ECS crée le rôle lié au service pour vous. 

**Important**  
 Ce rôle lié à un service peut apparaître dans votre compte si vous avez effectué une action dans un autre service qui utilise les fonctions prises en charge par ce rôle. Si vous utilisiez le service Amazon ECS avant le 1er janvier 2017, date à laquelle il a commencé à prendre en charge les rôles liés au service, Amazon ECS a créé le AWSServiceRoleForECS rôle dans votre compte. Pour en savoir plus, voir [Un nouveau rôle est apparu dans mon Compte AWS](https://docs.aws.amazon.com/IAM/latest/UserGuide/troubleshoot_roles.html#troubleshoot_roles_new-role-appeared).

Vous pouvez également utiliser la console IAM pour créer un rôle lié à un service avec le **AWSServiceRoleForECS**cas d'utilisation. Dans l'API AWS CLI ou dans l' AWS API, utilisez IAM pour créer un rôle lié à un service avec le nom du `ecs.amazonaws.com` service. Pour plus d’informations, consultez [Création d’un rôle lié à un service](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#create-service-linked-role) dans le *Guide de l’utilisateur IAM*. Si vous supprimez ce rôle lié à un service, vous pouvez utiliser ce même processus pour créer le rôle à nouveau.

Si vous supprimez ce rôle lié à un service et que vous avez ensuite besoin de le recréer, vous pouvez utiliser la même procédure pour recréer le rôle dans votre compte. Lorsque vous créez un cluster, ou lorsque vous créez ou mettez à jour un service, Amazon ECS crée à nouveau le rôle lié au service pour vous. 

Si vous supprimez ce rôle lié à un service, vous pouvez utiliser le même processus IAM pour recréer le rôle.

## Modification d'un rôle lié à un service pour Amazon ECS
<a name="edit-service-linked-role-clusters"></a>

Amazon ECS ne vous permet pas de modifier le rôle AWSServiceRoleForECS lié au service. Après avoir créé un rôle lié à un service, vous ne pouvez pas changer le nom du rôle, car plusieurs entités peuvent faire référence à ce rôle. Néanmoins, vous pouvez modifier la description du rôle à l’aide d’IAM. Pour plus d’informations, consultez [Modification d’un rôle lié à un service](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#edit-service-linked-role) dans le *Guide de l’utilisateur IAM*.

## Suppression d'un rôle lié à un service pour Amazon ECS
<a name="delete-service-linked-role-clusters"></a>

Il n'est pas nécessaire de supprimer le AWSServiceRoleForECS rôle manuellement. Lorsque vous supprimez des clusters dans toutes les régions de l'API AWS Management Console, de l' AWS API ou de l'API, Amazon ECS nettoie les ressources et supprime le rôle lié au service pour vous. AWS CLI

Si vous n’avez plus besoin d’utiliser une fonctionnalité ou un service qui nécessite un rôle lié à un service, nous vous recommandons de supprimer ce rôle. De cette façon, vous n'avez aucune entité inutilisée qui n'est pas surveillée ou gérée activement. Cependant, vous devez nettoyer votre rôle lié à un service avant de pouvoir le supprimer manuellement.

### Nettoyage d’un rôle lié à un service
<a name="service-linked-role-review-before-delete-clusters"></a>

Avant de pouvoir utiliser IAM pour supprimer un rôle lié à un service, vous devez supprimer toutes les ressources utilisées par le rôle.

**Note**  
Si le service Amazon ECS utilise le rôle lorsque vous essayez de supprimer les ressources, la suppression peut échouer. Si cela se produit, patientez quelques minutes et réessayez.

**Pour supprimer les ressources Amazon ECS utilisées par AWSServiceRoleForECS (console)**

1. Arrêtez tous les services Amazon ECS en indiquant 0 comme nombre souhaité dans toutes les régions, puis supprimez-les. Pour plus d’informations, consultez [Mettre à jour un service Amazon ECS](update-service-console-v2.md) et [Suppression d’un service Amazon ECS à l’aide de la console](delete-service-v2.md).

1. Forcez l’annulation de l’enregistrement de toutes les instances de conteneur de tous les clusters dans toutes les régions. Pour de plus amples informations, veuillez consulter [Annulation de l’enregistrement d’instance de conteneur Amazon ECS](deregister_container_instance.md).

1. Supprimez tous les clusters Amazon ECS dans toutes les régions. Pour de plus amples informations, veuillez consulter [Suppression d’un cluster Amazon ECS.](delete_cluster-new-console.md).

**Pour supprimer les ressources Amazon ECS utilisées par AWSServiceRoleForECS (AWS CLI)**

1. Arrêtez tous les services Amazon ECS en indiquant 0 comme nombre souhaité dans toutes les régions, puis supprimez-les. Pour plus d'informations, consultez [update-service et [delete-service](https://docs.aws.amazon.com/cli/latest/reference/ecs/delete-service.html)](https://docs.aws.amazon.com/cli/latest/reference/ecs/update-service.html) dans la référence. AWS Command Line Interface 

1. Forcez l’annulation de l’enregistrement de toutes les instances de conteneur de tous les clusters dans toutes les régions. Pour plus d’informations, consultez la section [deregister-container-instance](https://docs.aws.amazon.com/cli/latest/reference/ecs/deregister-container-instance.html).

1. Supprimez tous les clusters Amazon ECS dans toutes les régions. Pour en savoir plus, consultez la section [delete-cluster](https://docs.aws.amazon.com/cli/latest/reference/ecs/delete-cluster.html).

**Pour supprimer les ressources Amazon ECS utilisées par AWSServiceRoleForECS (API)**

1. Arrêtez tous les services Amazon ECS en indiquant 0 comme nombre souhaité dans toutes les régions, puis supprimez-les. Pour plus d'informations, consultez [UpdateService](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_UpdateService.html)et consultez [DeleteService](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DeleteService.html)le manuel *Amazon ECS API Reference*.

1. Forcez l’annulation de l’enregistrement de toutes les instances de conteneur de tous les clusters dans toutes les régions. Pour de plus amples informations, veuillez consulter [DeregisterContainerInstance](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DeregisterContainerInstance.html).

1. Supprimez tous les clusters Amazon ECS dans toutes les régions. Pour de plus amples informations, veuillez consulter [DeleteCluster](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_DeleteCluster.html).

### Suppression manuelle du rôle lié au service
<a name="slr-manual-delete-clusters"></a>

Utilisez la console IAM, le AWS CLI, ou l' AWS API pour supprimer le rôle lié au AWSServiceRoleForECS service. Pour plus d’informations, consultez la section [Suppression d’un rôle lié à un service](https://docs.aws.amazon.com/IAM/latest/UserGuide/using-service-linked-roles.html#delete-service-linked-role) dans le *Guide de l’utilisateur IAM*.

## Régions prises en charge pour les rôles liés à un service Amazon ECS
<a name="slr-regions-clusters"></a>

Amazon ECS prend en charge l’utilisation des rôles liés à un service dans toutes les régions où le service est disponible. Pour plus d’informations, consultez la section [Régions et points de terminaison AWS](https://docs.aws.amazon.com/general/latest/gr/rande.html).