Gründe für das Fehlschlagen der Amazon-ECS-API - Amazon Elastic Container Service

Gründe für das Fehlschlagen der Amazon-ECS-API

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

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

Weitere Informationen über die Struktur des Failure-Datentyps finden Sie unter Fehler in der Amazon Elastic Container Service-API-Referenz.

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

API-Aktion 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, in dem die Container-Instance registriert ist, und dass sowohl die Container-Instance-ARN 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 der Dienst-ARN oder -name gültig ist.

DescribeTasks

MISSING

Die angegebene Aufgabe wurde nicht gefunden. Überprüfen Sie, ob der richtige Cluster oder die richtige Region angegeben ist und ob sowohl der ARN oder die ID der Aufgabe gültig ist.

DescribeTasks

TaskFailedToStart: RESOURCE:*

Bei RESOURCE:CPU-Fehlern ist die Anzahl der CPUs, die von der Aufgabe angefragt wurden, auf Ihrer gegebenen Container-Instance nicht verfügbar. Dies ist in der Regel der Fall, wenn die CPU-Einheiten-Anforderung in Ihrer Aufgabendefinition größer ist als die CPU-Größe der Amazon-EC2-Instances, die in der Auto-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 Arbeitsspeicherbedarf in Ihrer Aufgabendefinition größer ist als der unterstützte Arbeitsspeicher auf den EC2-Instances, die in der Auto-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 Fehlerbehebung finden Sie unter Wie behebe ich Probleme mit einem getrennten Amazon-ECS-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 Amazon-ECS-Aufgabendefinitionsparameter für Fargate und Konfiguration des Amazon-ECS-Container-Agenten.
TaskFailedToStart: NO ACTIVE INSTANCES In Ihrem Kapazitätsanbieter gibt es keine aktiven Instances. Informationen über die Verwaltung Ihrer Auto-Scaling-Gruppen finden Sie unter Auto-Scaling-Gruppen im Benutzerhandbuch für Amazon EC2 Auto Scaling.

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 über die Verwaltung Ihrer Auto-Scaling-Gruppen finden Sie unter Auto-Scaling-Gruppen im Benutzerhandbuch für Amazon EC2 Auto Scaling.

GetTaskProtection

MISSING

Die angegebene Aufgabe wurde nicht gefunden. Stellen Sie sicher, dass der Cluster-Name oder ARN und der Aufgaben-ARN sowie die ID gültig sind.

TASK_NOT_VALID

Die angegebene Aufgabe ist nicht Teil eines Amazon-ECS-Service. Nur vom Amazon-ECS-Service verwaltete Aufgaben können geschützt werden. Überprüfen Sie den Aufgaben-ARN oder die -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 CPU, Speicher, Ports oder Elastic-Network-Schnittstellen handelt, müssen Sie Ihrem Cluster möglicherweise 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. Amazon-EC2-Instances haben eine Begrenzung für die Anzahl der Netzwerkschnittstellen, die an sie angehängt werden können, und die primäre Netzwerkschnittstelle zählt als eine Einheit. Weitere Informationen darüber, wie viele Netzwerkschnittstellen pro Instance-Typ unterstützt werden, finden Sie unter IP-Adressen pro Netzwerkschnittstelle pro Instance-Typ im Amazon-EC2-Benutzerhandbuch.

Für RESOURCE:GPU-Fehler ist die Anzahl der GPUs, die von der Aufgabe angefordert werden, nicht verfügbar, und Sie müssen möglicherweise GPU-fähige Container-Instances zu Ihrem Cluster hinzufügen. Weitere Informationen finden Sie unter Amazon-ECS-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 Fehlerbehebung finden Sie unter Wie behebe ich Probleme mit einem getrennten Amazon-ECS-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 Amazon-ECS-Aufgabendefinitionsparameter für Fargate und Konfiguration des Amazon-ECS-Container-Agenten.

StartTask

MISSING

Die Container-Instance, auf der Sie versucht haben, die Aufgabe zu starten, wurde nicht gefunden. Überprüfen Sie, ob das falsche Cluster oder die falsche Region angegeben wurde oder ob der ARN oder die ID der Container-Instance Tippfehler enthalten.

INACTIVE

Die Container-Instance, auf der Sie versucht haben, die Aufgabe zu starten, wurde vorher von Amazon ECS abgemeldet und kann nicht verwendet werden.

StopServiceDeployment

ECS deployment failed

 Ein Betrugskonto hat die StopServiceDeployment-API ausgeführt.

TagResource

InvalidParameterException

 Der ARN für den Service, den Sie markieren, hat das Kurzformat. Sie müssen zum Langformat migrieren. Weitere Informationen zur Migration des ARN finden Sie unter Migrieren eines kurzen ARN für einen Amazon ECS Service zu einem langen ARN.

UpdateTaskProtection

DEPLOYMENT_BLOCKED

Der Aufgabenschutz 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 Cluster-Name oder ARN und der Aufgaben-ARN sowie die ID gültig sind.

TASK_NOT_VALID

Die angegebene Aufgabe ist nicht Teil eines Amazon-ECS-Service. Nur vom Amazon-ECS-Service verwaltete Aufgaben können geschützt werden. Überprüfen Sie den Aufgaben-ARN oder die -ID und versuchen Sie es erneut.
Anmerkung

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