Gründe für den Ausfall der Amazon ECS-API - Amazon Elastic Container Service

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Gründe für den Ausfall der Amazon ECS-API

Wenn eine API-Aktion, die Sie über die Amazon ECS-API, -Konsole oder die ausgelöst haben, mit einer failures Fehlermeldung AWS CLI beendet wird, kann Folgendes bei der Behebung der Ursache hilfreich sein. Für den Fehler werden ein Grund und der Amazon-Ressourcenname (ARN) der Ressource zurückgegeben, 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 ü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 möglicherweise beim Ausführen von API-Befehlen erhalten.

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 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 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 den Fargate-Starttyp und Konfiguration des Amazon-ECS-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 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. EC2 Amazon-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 EC2 Amazon-Benutzerhandbuch.

Bei RESOURCE:GPU Fehlern ist die Anzahl der von der Aufgabe GPUs angeforderten Instances 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 den Fargate-Starttyp und Konfiguration des Amazon-ECS-Container-Agenten.

StartTask

MISSING

Die Container-Instance, auf der Sie versucht haben, die Aufgabe zu starten, wurde nicht gefunden. Prüfen Sie, ob der falsche Cluster oder die falsche Region angegeben ist oder ob der ARN oder die ID der Container-Instance falsch geschrieben ist.

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 betrügerisches Konto hat die StopServiceDeployment API ausgeführt.

TagResource

InvalidParameterException

 Der ARN für den Dienst, den Sie taggen, hat das Kurzformat. Sie müssen auf das Langformat migrieren. Informationen zur Migration des ARN finden Sie unterMigrieren Sie einen Amazon ECS-Kurzservice-ARN zu einem langen ARN.

UpdateTaskProtection

DEPLOYMENT_BLOCKED

Der Aufgabenschutz kann nicht eingerichtet werden, da eine oder mehrere geschützte Aufgaben verhindern, dass die Dienstbereitstellung einen stabilen Zustand 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 API-Operationen auch aufgrund von Ausnahmen fehlschlagen, was zu Fehlerreaktionen führt. Eine Liste solcher Ausnahmen finden Sie unter Häufige Fehler.