Gründe Amazon ECS API Amazon-Fehler

Wenn eine API Aktion, die Sie über Amazon ECSAPI, die Konsole oder die ausgelöst haben, mit einer failures Fehlermeldung AWS CLI beendet wird, kann Folgendes bei der Behebung der Ursache hilfreich sein. Der Fehler gibt einen Grund und den Amazon-Ressourcennamen (ARN) der Ressource zurück, die mit dem Fehler verknüpft ist.

Viele Ressourcen sind regionalspezifisch. Achten Sie also darauf, dass die Konsole auf die richtige Region für Ihre Ressourcen gesetzt ist. Stellen Sie bei der AWS CLI Verwendung von sicher, dass Ihre AWS CLI Befehle mit dem --region region Parameter an die richtige Region gesendet werden.

Weitere Informationen zur Struktur des Failure Datentyps finden Sie unter Fehler in der Amazon Elastic Container Service API Reference.

Im Folgenden finden Sie Beispiele für Fehlermeldungen, die Sie möglicherweise beim Ausführen von API Befehlen erhalten.

APIAktion	Grund des Ausfalls oder Grund des Anhaltens	Ursache
DescribeClusters	MISSING	Der angegebene Cluster wurde nicht gefunden. Überprüfen Sie die Schreibweise des Clusternamens.
DescribeInstances	MISSING	Die angegebene Container-Instance wurde nicht gefunden. Stellen Sie sicher, dass Sie den Cluster angegeben haben, für den die Container-Instance registriert ist, und ARN ob sowohl die Container-Instance als auch die ID korrekt sind.
DescribeServices	MISSING	Der angegebene Service wurde nicht gefunden. Stellen Sie sicher, dass der richtige Cluster oder die richtige Region angegeben ist und ob der Dienst ARN oder Name gültig ist.
DescribeTasks	MISSING	Die angegebene Aufgabe wurde nicht gefunden. Stellen Sie sicher, dass der richtige Cluster oder die richtige Region angegeben ist und dass sowohl die Aufgabe ARN als auch die ID gültig sind.
DescribeTasks	TaskFailedToStart: RESOURCE:*	Bei RESOURCE:CPU Fehlern ist die Anzahl der von der Aufgabe CPUs angeforderten Instances auf Ihren Container-Instances nicht verfügbar. Dies ist in der Regel der Fall, wenn die CPU Einheitenanforderung in Ihrer Aufgabendefinition größer ist als die CPU Größe der EC2 Amazon-Instances, die in der Auto Scaling Scaling-Gruppe definiert sind, die dem Kapazitätsanbieter zugeordnet ist. Sie müssen die Konfiguration Ihres Kapazitätsanbieters überprüfen. Bei RESOURCE:MEMORY-Fehlern ist die Speichermenge, die von der Aufgabe angefragt wurde, auf Ihrer gegebenen Container-Instance nicht verfügbar. Dies ist in der Regel der Fall, wenn der Speicherbedarf in Ihrer Aufgabendefinition größer ist als der unterstützte Speicher auf den EC2 Amazon-Instances, die in der Auto Scaling Scaling-Gruppe definiert sind, die dem Kapazitätsanbieter zugeordnet ist. Sie müssen die Konfiguration Ihres Kapazitätsanbieters überprüfen.
	TaskFailedToStart: AGENT	Die Container-Instance, auf der Sie eine Aufgabe zu starten versucht haben, hat einen Agenten, der derzeit nicht verbunden ist. Um langen Wartezeiten für die Platzierung der Aufgabe vorzubeugen, wurde die Anfrage zurückgewiesen. Informationen zur Problembehebung bei einem unterbrochenen Agenten finden Sie unter Wie behebe ich Probleme bei einem unterbrochenen ECS Amazon-Agenten?
	TaskFailedToStart: MemberOf placement constraint unsatisfied	Es gibt keine Container-Instance, die die in Ihrer Aufgabendefinition definierten Platzierungsbeschränkungen erfüllt.
	TaskFailedToStart: ATTRIBUTE	Ihre Aufgabendefinition enthält einen Parameter, der ein spezifisches Container-Instance-Attribut erfordert, das auf Ihren Container-Instances nicht verfügbar ist. Beispiel: Wenn Ihre Aufgabe den Netzwerkmodus awsvpc verwendet, es aber keine Instances in Ihren angegebenen Subnetze mit dem Attribut ecs.capability.task-eni gibt. Weitere Informationen darüber, welche Attribute für bestimmte Aufgabendefinitionsparameter und Agentenkonfigurationsvariablen erforderlich sind, finden Sie unter Parameter für die ECS Amazon-Aufgabendefinition und Konfiguration des ECS Amazon-Container-Agenten.
	TaskFailedToStart: NO ACTIVE INSTANCES	In Ihrem Kapazitätsanbieter gibt es keine aktiven Instances. Informationen zur Verwaltung Ihrer Auto Scaling Scaling-Gruppen finden Sie unter Auto Scaling Scaling-Gruppen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.
	TaskFailedToStart: EMPTY CAPACITY PROVIDER	Es gibt keine Instances in Ihrem Cluster. Dies liegt höchstwahrscheinlich an einem leeren Kapazitätsanbieter oder daran, dass die Instances im Kapazitätsanbieter nicht im Cluster registriert sind. Informationen zur Verwaltung Ihrer Auto Scaling Scaling-Gruppen finden Sie unter Auto Scaling Scaling-Gruppen im Amazon EC2 Auto Scaling Scaling-Benutzerhandbuch.
GetTaskProtection	MISSING	Die angegebene Aufgabe wurde nicht gefunden. Stellen Sie sicher, dass der Clustername oder ARN und die Aufgabe ARN oder ID gültig sind.
	TASK_NOT_VALID	Die angegebene Aufgabe ist nicht Teil eines ECS Amazon-Service. Nur vom Amazon ECS Service verwaltete Aufgaben können geschützt werden. Überprüfen Sie die Aufgabe ARN oder ID und versuchen Sie es erneut.
RunTask oder StartTask	RESOURCE:*	Die Ressource oder Ressourcen, die von der Aufgabe angefragt wurden, sind auf der gegebenen Container-Instance im Cluster nicht verfügbar. Wenn es sich bei der Ressource um ArbeitsspeicherCPU, Ports oder elastische Netzwerkschnittstellen handelt, müssen Sie Ihrem Cluster möglicherweise zusätzliche Container-Instances hinzufügen. Für RESOURCE:ENI-Fehler stehen Ihrem Cluster keine verfügbaren Befestigungspunkte für Elastic-Network-Schnittstellen zur Verfügung, die für Aufgaben benötigt werden, die den Netzwerkmodus awsvpc verwenden. EC2Amazon-Instances haben ein Limit für die Anzahl der Netzwerkschnittstellen, die an sie angeschlossen werden können, und die primäre Netzwerkschnittstelle zählt als eine. Weitere Informationen darüber, wie viele Netzwerkschnittstellen für jeden Instance-Typ unterstützt werden, finden Sie unter IP-Adressen pro Netzwerkschnittstelle pro Instance-Typ im EC2Amazon-Benutzerhandbuch. Bei RESOURCE:GPU Fehlern ist die Anzahl der von der Aufgabe GPUs angeforderten Instances nicht verfügbar und Sie müssen Ihrem Cluster möglicherweise Container-Instances mit GPU aktivierter Option hinzufügen. Weitere Informationen finden Sie unter ECSAmazon-Aufgabendefinitionen für GPU Workloads.
	AGENT	Die Container-Instance, auf der Sie eine Aufgabe zu starten versucht haben, hat einen Agenten, der derzeit nicht verbunden ist. Um langen Wartezeiten für die Platzierung der Aufgabe vorzubeugen, wurde die Anfrage zurückgewiesen. Informationen zur Problembehebung bei einem unterbrochenen Agenten finden Sie unter Wie behebe ich Probleme bei einem unterbrochenen ECS Amazon-Agenten?
	LOCATION	Die Container-Instance, auf der Sie versucht haben, eine Aufgabe zu starten, befindet sich in einer anderen Availability Zone als die Subnetze, die Sie in awsVpcConfiguration angegeben haben.
	ATTRIBUTE	Ihre Aufgabendefinition enthält einen Parameter, der ein spezifisches Container-Instance-Attribut erfordert, das auf Ihren Container-Instances nicht verfügbar ist. Beispiel: Wenn Ihre Aufgabe den Netzwerkmodus awsvpc verwendet, es aber keine Instances in Ihren angegebenen Subnetze mit dem Attribut ecs.capability.task-eni gibt. Weitere Informationen darüber, welche Attribute für bestimmte Aufgabendefinitionsparameter und Agentenkonfigurationsvariablen erforderlich sind, finden Sie unter Parameter für die ECS Amazon-Aufgabendefinition und Konfiguration des ECS Amazon-Container-Agenten.
StartTask	MISSING	Die Container-Instance, auf der Sie versucht haben, die Aufgabe zu starten, wurde nicht gefunden. Überprüfen Sie, ob der falsche Cluster oder die falsche Region angegeben ist oder ob die Container-Instance ARN oder ID falsch geschrieben ist.
	INACTIVE	Die Container-Instance, auf der Sie versucht haben, eine Aufgabe zu starten, wurde zuvor bei Amazon abgemeldet ECS und kann nicht verwendet werden.
UpdateTaskProtection	DEPLOYMENT_BLOCKED	Der Task-Schutz kann nicht eingerichtet werden, da eine oder mehrere geschützte Aufgaben verhindern, dass die Servicebereitstellung einen stabilen Status erreicht. Deaktivieren Sie den Aufgabenschutz für vorhandene Aufgaben oder warten Sie, bis der Aufgabenschutz abläuft.
	MISSING	Die angegebene Aufgabe wurde nicht gefunden. Stellen Sie sicher, dass der Clustername oder ARN und die Aufgabe ARN oder ID gültig sind.
	TASK_NOT_VALID	Die angegebene Aufgabe ist nicht Teil eines ECS Amazon-Service. Nur vom Amazon ECS Service verwaltete Aufgaben können geschützt werden. Überprüfen Sie die Aufgabe ARN oder ID und versuchen Sie es erneut.

Anmerkung

Neben den hier beschriebenen Fehlerszenarien können API Operationen auch aufgrund von Ausnahmen fehlschlagen, was zu Fehlerreaktionen führt. Eine Liste solcher Ausnahmen finden Sie unter Häufige Fehler.