Raisons de l'échec de l'API Amazon ECS - Amazon Elastic Container Service

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.

Raisons de l'échec de l'API Amazon ECS

Lorsqu'une action d'API que vous avez déclenchée par le biais de l'API Amazon ECS, de la console ou d'Amazon AWS CLI ECS se termine par un message failures d'erreur, les informations suivantes peuvent vous aider à résoudre le problème. L'échec renvoie une raison 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 le AWS CLI, assurez-vous que vos AWS CLI commandes sont envoyées à la bonne région avec le --region region paramètre.

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 d'API.

Action d’API Motif de l'échec ou de l'arrêt Cause

DescribeClusters

MISSING

Le cluster spécifié n'a pas été trouvé. Vérifiez l'orthographe du nom du cluster.

DescribeInstances

MISSING

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.

DescribeServices

MISSING

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.

DescribeTasks

MISSING

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.

DescribeTasks

TaskFailedToStart: RESOURCE:*

En cas d'RESOURCE:CPUerreur, le nombre de CPUs requêtes demandées par la tâche n'est pas disponible sur vos instances de conteneur. Cela se produit généralement lorsque l'unité de processeur requise dans la définition de votre tâche est supérieure à la taille du processeur des EC2 instances Amazon définies dans le groupe Auto Scaling mappé au fournisseur de capacité. Vous devez vérifier la configuration de votre fournisseur de capacité.

En cas d'erreur RESOURCE:MEMORY, la quantité de mémoire demandée par la tâche n'est pas disponible sur vos instances de conteneur. Cela se produit généralement lorsque la quantité de mémoire requise dans votre définition de tâche est supérieure à la mémoire prise en charge sur les EC2 instances Amazon définies dans le groupe Auto Scaling mappé au fournisseur de capacité. Vous devez vérifier la configuration de votre fournisseur de capacité.

TaskFailedToStart: AGENT

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é ?.

TaskFailedToStart: MemberOf placement constraint unsatisfied

Aucune instance de conteneur ne répond aux contraintes de placement définies dans votre définition de tâche.

TaskFailedToStart: ATTRIBUTE

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 awsvpc, mais qu'aucune instance dans les sous-réseaux spécifiés ne comporte l'attribut ecs.capability.task-eni. Pour plus d'informations sur les attributs requis pour des paramètres de définition de tâche et des variables de configuration d'agent spécifiques, consultez Paramètres de définition des tâches Amazon ECS pour le type de lancement Fargate et Configuration de l'agent de conteneur Amazon ECS.

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, consultez la section Groupes Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

TaskFailedToStart: EMPTY CAPACITY PROVIDER

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, consultez la section Groupes Auto Scaling dans le guide de l'utilisateur d'Amazon EC2 Auto Scaling.

GetTaskProtection

MISSING

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.

TASK_NOT_VALID

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.

RunTask ou StartTask

RESOURCE:*

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 RESOURCE:ENI indiquent que votre cluster ne dispose pas de points d'attache d'interface réseau Elastic, qui sont requis pour les tâches utilisant le mode réseau awsvpc. Le nombre d'interfaces réseau pouvant être associées aux EC2 instances Amazon est limité, et l'interface réseau principale compte pour une. Pour plus d'informations sur le nombre d'interfaces réseau prises en charge pour chaque type d'instance, consultez la section Adresses IP par interface réseau et par type d'instance dans le guide de EC2 l'utilisateur Amazon.

En cas d'RESOURCE:GPUerreur, le nombre de GPUs requêtes demandées par la tâche n'est pas disponible et vous devrez peut-être ajouter des instances de conteneur compatibles GPU à votre cluster. Pour de plus amples informations, veuillez consulter Définitions de tâches Amazon ECS pour les charges de travail GPU.

AGENT

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é ?.

LOCATION

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 awsVpcConfiguration.

ATTRIBUTE

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 awsvpc, mais qu'aucune instance dans les sous-réseaux spécifiés ne comporte l'attribut ecs.capability.task-eni. Pour plus d'informations sur les attributs requis pour des paramètres de définition de tâche et des variables de configuration d'agent spécifiques, consultez Paramètres de définition des tâches Amazon ECS pour le type de lancement Fargate et Configuration de l'agent de conteneur Amazon ECS.

StartTask

MISSING

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 est incorrect ou si l'ARN ou l'ID de l'instance de conteneur est mal orthographié.

INACTIVE

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.

StopServiceDeployment

ECS deployment failed

Un compte frauduleux exécutait l'StopServiceDeploymentAPI.

TagResource

InvalidParameterException

L'ARN du service que vous balisez est au format court. Vous devez migrer vers le format long. Pour plus d'informations sur la migration de l'ARN, consultezMigrer un ARN de service court Amazon ECS vers un ARN long.

UpdateTaskProtection

DEPLOYMENT_BLOCKED

Impossible de définir la protection des tâches car une ou plusieurs tâches protégées empêchent le déploiement du 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.

MISSING

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.

TASK_NOT_VALID

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'échec décrits ici, les opérations d'API peuvent également échouer en raison d'exceptions, entraînant des réponses d'erreur. Pour obtenir la liste de ces exceptions, consultez la section Erreurs courantes.