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 das Fehlschlagen der Amazon-ECS-API
<a name="api_failures_messages"></a>

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.

Bei vielen Ressourcen ist dies der Region-specific Fall. Achten Sie daher bei der Verwendung der Konsole darauf, dass Sie die richtige Region für Ihre Ressourcen angeben. 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](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Failure.html) 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. 



- ** `DescribeClusters` **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `MISSING`
  - **Ursache:** Der angegebene Cluster wurde nicht gefunden. Überprüfen Sie die Schreibweise des Clusternamens.

- ** `DescribeInstances` **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `MISSING`
  - **Ursache:** 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` **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `MISSING`
  - **Ursache:** 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` **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `MISSING`
  - **Ursache:** 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`  **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `TaskFailedToStart: RESOURCE:*` / **Ursache:** 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.<br />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.
  - **Grund des Ausfalls oder Grund des Anhaltens:** `TaskFailedToStart: AGENT` / **Ursache:** 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.<br />Informationen zur Fehlerbehebung finden Sie unter [Wie behebe ich Probleme mit einem getrennten Amazon-ECS-Agenten](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami).
  - **Grund des Ausfalls oder Grund des Anhaltens:** `TaskFailedToStart: MemberOf placement constraint unsatisfied` / **Ursache:** Es gibt keine Container-Instance, die die in Ihrer Aufgabendefinition definierten Platzierungsbeschränkungen erfüllt.
  - **Grund des Ausfalls oder Grund des Anhaltens:** `TaskFailedToStart: ATTRIBUTE` / **Ursache:** 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](task_definition_parameters.md) und [Konfiguration des Amazon-ECS-Container-Agenten](ecs-agent-config.md).
  - **Grund des Ausfalls oder Grund des Anhaltens:** TaskFailedToStart: NO ACTIVE INSTANCES / **Ursache:** In Ihrem Kapazitätsanbieter gibt es keine aktiven Instances. Informationen über die Verwaltung Ihrer Auto-Scaling-Gruppen finden Sie unter [Auto-Scaling-Gruppen](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) im Benutzerhandbuch für Amazon EC2 Auto Scaling.
  - **Grund des Ausfalls oder Grund des Anhaltens:** `TaskFailedToStart: EMPTY CAPACITY PROVIDER` / **Ursache:** 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](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) im Benutzerhandbuch für Amazon EC2 Auto Scaling.

- ** `GetTaskProtection` **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `MISSING` / **Ursache:** 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.
  - **Grund des Ausfalls oder Grund des Anhaltens:** `TASK_NOT_VALID` / **Ursache:** 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` **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `RESOURCE:*` / **Ursache:** 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.<br />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](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#AvailableIpPerENI) im *Amazon-EC2-Benutzerhandbuch*.<br />Bei `RESOURCE:GPU` Fehlern ist die von der Aufgabe angeforderte Anzahl der GPUs nicht verfügbar und Sie müssen Ihrem Cluster möglicherweise GPU-enabled Container-Instances hinzufügen. Weitere Informationen finden Sie unter [Amazon-ECS-Aufgabendefinitionen für GPU-Workloads](ecs-gpu.md).
  - **Grund des Ausfalls oder Grund des Anhaltens:** `AGENT` / **Ursache:** 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.<br />Informationen zur Fehlerbehebung finden Sie unter [Wie behebe ich Probleme mit einem getrennten Amazon-ECS-Agenten](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami).
  - **Grund des Ausfalls oder Grund des Anhaltens:** `LOCATION` / **Ursache:** 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.
  - **Grund des Ausfalls oder Grund des Anhaltens:** `ATTRIBUTE` / **Ursache:** 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](task_definition_parameters.md) und [Konfiguration des Amazon-ECS-Container-Agenten](ecs-agent-config.md).

- ** `StartTask` **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `MISSING` / **Ursache:** 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.
  - **Grund des Ausfalls oder Grund des Anhaltens:** `INACTIVE` / **Ursache:** Die Container-Instance, auf der Sie versucht haben, die Aufgabe zu starten, wurde vorher von Amazon ECS abgemeldet und kann nicht verwendet werden.

- ** `StopServiceDeployment` **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `ECS deployment failed`
  - **Ursache:** Ein Betrugskonto hat die StopServiceDeployment-API ausgeführt.

- ** `TagResource` **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `InvalidParameterException`
  - **Ursache:** 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 Amazon-ECS-Service mit kurzem ARN zu einem langen ARN](service-arn-migration.md).

- ** `UpdateTaskProtection` **
  - **Grund des Ausfalls oder Grund des Anhaltens:** `DEPLOYMENT_BLOCKED` / **Ursache:** 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.
  - **Grund des Ausfalls oder Grund des Anhaltens:** `MISSING` / **Ursache:** 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.
  - **Grund des Ausfalls oder Grund des Anhaltens:** `TASK_NOT_VALID` / **Ursache:** 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](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/CommonErrors.html).