Motifs d’échec d’API Amazon ECS
Si une action API que vous avez déclenchée via l’API Amazon ECS, la console ou la AWS CLI renvoie un message d’erreur failures, les éléments suivants peuvent aider à résoudre la cause. L’échec renvoie un motif et l’Amazon Resource Name (ARN) de la ressource associée à l’échec.
De nombreuses ressources sont spécifiques à la région. Lorsque vous utilisez la console, assurez-vous donc de définir la région correspondant à vos ressources. Lorsque vous utilisez l'AWS CLI, assurez-vous que vos commandes AWS CLI sont envoyées à la région correspondante avec le paramètre --region
.region
Pour plus d'informations sur la structure du type de données Failure, consultez Failure (Échec) dans la Référence d'API Amazon Elastic Container Service.
Voici des exemples de messages d’échec que vous pouvez recevoir lors de l’exécution de commandes API.
| Action d’API | Motif de l'échec ou de l'arrêt | Cause |
|---|---|---|
|
|
|
Le cluster spécifié n'a pas été trouvé. Vérifiez l'orthographe du nom du cluster. |
|
|
|
L'instance de conteneur spécifiée n'a pas été trouvée. Vérifiez que vous avez spécifié le cluster dans lequel l'instance de conteneur est enregistrée et que l'ARN ou l'ID de l'instance de conteneur est correct. |
|
|
|
Le service spécifié n'a pas été trouvé. Vérifiez que la région ou le cluster correct est spécifié et que l'ARN ou le nom du service est valide. |
|
|
|
La tâche spécifiée n'a pas été trouvée. Vérifiez que la région ou le cluster correct est spécifié et que l'ID ou l'ARN de la tâche est valide. |
|
|
|
En cas d'erreur En cas d'erreur |
|
|
L'instance de conteneur avec laquelle vous avez essayé de lancer une tâche comporte un agent qui est actuellement déconnecté. Afin d'éviter de longs délais d'attente pour le placement de la tâche, la demande a été rejetée. Pour plus d'informations sur la résolution problèmes des agents déconnectés, consultez Comment résoudre les problèmes liés à un agent Amazon ECS déconnecté ? |
|
|
|
Aucune instance de conteneur ne répond aux contraintes de placement définies dans votre définition de tâche. |
|
|
|
La définition de votre tâche contient un paramètre nécessitant un attribut d'instance de conteneur spécifique qui n'est pas disponible sur vos instances de conteneur. Cela se produit, par exemple, si votre tâche utilise le mode réseau |
|
TaskFailedToStart: NO ACTIVE INSTANCES |
Il n'y a aucune instance active dans votre fournisseur de capacité. Pour plus d'informations sur la gestion de vos groupes Auto Scaling, veuillez consulter Groupes Auto Scaling dans le Guide de l'utilisateur Amazon EC2 Auto Scaling (langue française non garantie). | |
|
|
Il n'existe pas d'instances dans votre cluster. Cela est probablement dû à un fournisseur de capacité vide ou au fait que les instances du fournisseur de capacité ne sont pas enregistrées auprès du cluster. Pour plus d'informations sur la gestion de vos groupes Auto Scaling, veuillez consulter Groupes Auto Scaling dans le Guide de l'utilisateur Amazon EC2 Auto Scaling (langue française non garantie). | |
|
|
|
La tâche spécifiée n'a pas été trouvée. Vérifiez que l'ARN ou le nom du cluster et l'ARN ou l'ID de tâche sont valides. |
|
|
La tâche spécifiée ne fait pas partie d’un service Amazon ECS. Seules les tâches gérées par les services Amazon ECS peuvent être protégées. Vérifiez l'ARN ou l'ID de la tâche et réessayez. |
|
|
|
|
La ou les ressources demandées par la tâche ne sont pas disponibles sur les instances de conteneur du cluster. Si la ressource demandée concerne le CPU, la mémoire, les ports ou les interfaces réseau Elastic, vous devrez peut-être ajouter d'autres instances de conteneur à votre cluster. Les erreurs Les erreurs |
|
|
L'instance de conteneur avec laquelle vous avez essayé de lancer une tâche comporte un agent qui est actuellement déconnecté. Afin d'éviter de longs délais d'attente pour le placement de la tâche, la demande a été rejetée. Pour plus d'informations sur la résolution problèmes des agents déconnectés, consultez Comment résoudre les problèmes liés à un agent Amazon ECS déconnecté ? |
|
|
|
L'instance de conteneur sur laquelle vous avez tenté de lancer une tâche se trouve dans une zone de disponibilité différente de celle du ou des sous-réseaux que vous avez spécifiés dans votre |
|
|
|
La définition de votre tâche contient un paramètre nécessitant un attribut d'instance de conteneur spécifique qui n'est pas disponible sur vos instances de conteneur. Cela se produit, par exemple, si votre tâche utilise le mode réseau |
|
|
|
|
L’instance de conteneur sur laquelle vous avez tenté de lancer la tâche est introuvable. Vérifiez si le cluster ou la région spécifiés sont incorrects, ou si l’ARN ou l’ID de l’instance de conteneur est mal orthographié. |
|
|
L'enregistrement de l'instance de conteneur sur laquelle vous avez essayé de lancer une tâche a été précédemment annulé avec Amazon ECS et cette instance ne peut pas être utilisée. |
|
|
|
|
Un compte frauduleux a utilisé l’API StopServiceDeployment. |
|
|
|
L’ARN du service que vous étiquetez est au format court. Vous devez passer au format long. Pour plus d’informations sur le processus de migration de l’ARN, consultez la section Migrer un ARN court de service Amazon ECS vers un ARN long. |
|
|
|
Impossible de définir la protection des tâches, car une ou plusieurs tâches protégées empêchent le déploiement de service d’atteindre un état stable. Désactivez la protection des tâches sur les tâches existantes ou attendez que la protection des tâches expire. |
|
|
La tâche spécifiée n'a pas été trouvée. Vérifiez que l'ARN ou le nom du cluster et l'ARN ou l'ID de tâche sont valides. |
|
|
|
La tâche spécifiée ne fait pas partie d’un service Amazon ECS. Seules les tâches gérées par les services Amazon ECS peuvent être protégées. Vérifiez l'ARN ou l'ID de la tâche et réessayez. |
Note
Outre les scénarios d’échecs décrits ici, les opérations d’API peuvent également échouer en raison d’exceptions, ce qui entraîne des réponses d’erreur. Pour obtenir la liste de ces exceptions, consultez la section Erreurs courantes.
