# Motivos de falha da API no Amazon ECS
<a name="api_failures_messages"></a>

Quando uma ação de API que você acionou por meio da API do Amazon ECS, do console ou da AWS CLI é encerrada com uma mensagem de erro `failures`, a ação a seguir pode ajudar a reparar a causa. A falha retorna o motivo e o nome do recurso da Amazon (ARN) do recurso associado à falha.

Muitos recursos são específicos da região. Portanto, ao usar o console, certifique-se de ter definido a região correta para os recursos. Ao usar a AWS CLI, certifique-se de que os comandos da AWS CLI estejam sendo enviados para a região correta com o parâmetro `--region {{region}}`.

Para obter mais informações sobre a estrutura do tipo de dados da `Failure`, consulte [Falha](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/API_Failure.html) na *Referência da API do Amazon Elastic Service*.

Veja a seguir exemplos de mensagens de falha que você pode receber ao executar comandos da API. 



- ** `DescribeClusters` **
  - **Motivo da falha ou Motivo da interrupção:** `MISSING`
  - **Causa:** O cluster especificado não foi encontrado. Verifique a ortografia do nome do cluster.

- ** `DescribeInstances` **
  - **Motivo da falha ou Motivo da interrupção:** `MISSING`
  - **Causa:** A instância de contêiner especificada não foi encontrada. Verifique se você especificou o cluster no qual a instância de contêiner está registrada e se o ARN e o ID da instância de contêiner estão corretos.

- ** `DescribeServices` **
  - **Motivo da falha ou Motivo da interrupção:** `MISSING`
  - **Causa:** O serviço especificado não foi encontrado. Verifique se o cluster ou a região correta está especificada e se o ARN ou o nome do serviço é válido.

- ** `DescribeTasks` **
  - **Motivo da falha ou Motivo da interrupção:** `MISSING`
  - **Causa:** A tarefa especificada não foi encontrada. Verifique se o cluster ou a região correta está especificada e se o ARN ou o ID da tarefa é válido.

- ** `DescribeTasks`  **
  - **Motivo da falha ou Motivo da interrupção:** `TaskFailedToStart: RESOURCE:*` / **Causa:** Em caso de erro de `RESOURCE:CPU`, o número de CPUs solicitadas pela tarefa está indisponível nas suas instâncias de contêiner. Isso costuma ocorrer quando o requisito de unidade de CPU na definição de tarefa é maior do que o tamanho da CPU das instâncias do Amazon EC2 definidas no grupo do Auto Scaling mapeado para o provedor de capacidade. Você precisa verificar a configuração do seu provedor de capacidade.<br />Em caso de erro de `RESOURCE:MEMORY`, a quantidade de memória solicitada pela tarefa está indisponível nas suas instâncias de contêiner. Isso costuma ocorrer quando o requisito de quantidade de memória na definição de tarefa é maior do que o suporte de memória nas instâncias do Amazon EC2 definidas no grupo do Auto Scaling mapeado para o provedor de capacidade. Você precisa verificar a configuração do seu provedor de capacidade.
  - **Motivo da falha ou Motivo da interrupção:** `TaskFailedToStart: AGENT` / **Causa:** A instância de contêiner na qual você tentou iniciar uma tarefa tem um agente que está desconectado, no momento. Para evitar tempos de espera prolongados para a tarefa, a solicitação foi rejeitada.<br />Para saber mais sobre como solucionar um agente que está desconectado, consulte [Como solucionar problemas com um agente desconectado do Amazon ECS](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami).
  - **Motivo da falha ou Motivo da interrupção:** `TaskFailedToStart: MemberOf placement constraint unsatisfied` / **Causa:** Não há nenhuma instância de contêiner que atenda às restrições de posicionamento especificadas na definição da tarefa.
  - **Motivo da falha ou Motivo da interrupção:** `TaskFailedToStart: ATTRIBUTE` / **Causa:** A definição de tarefa contém um parâmetro que exige um atributo de instância de contêiner específico que não está disponível nas instâncias de contêiner. Por exemplo, se sua tarefa usar o modo de rede `awsvpc`, mas não houver instâncias nas suas sub-redes especificadas com o atributo `ecs.capability.task-eni`. Para obter mais informações sobre quais atributos são obrigatórios para parâmetros de definição de tarefa específicos e variáveis de configuração de agentes, consulte [Parâmetros de definição de tarefa do Amazon ECS para o Fargate](task_definition_parameters.md) e [Configuração do agente de contêiner do Amazon ECS](ecs-agent-config.md).
  - **Motivo da falha ou Motivo da interrupção:** TaskFailedToStart: NO ACTIVE INSTANCES / **Causa:** Não há instâncias ativas em seu provedor de capacidade. Para obter mais informações sobre como gerenciar seus grupos do Auto Scaling, consulte [Grupos do Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) no Guia do usuário do Amazon EC2 Auto Scaling.
  - **Motivo da falha ou Motivo da interrupção:** `TaskFailedToStart: EMPTY CAPACITY PROVIDER` / **Causa:** Não existem instâncias no seu cluster. Provavelmente, isso se deve a um provedor de capacidade vazio ou porque as instâncias no provedor de capacidade não estão registradas no cluster. Para obter mais informações sobre como gerenciar seus grupos do Auto Scaling, consulte [Grupos do Auto Scaling](https://docs.aws.amazon.com/autoscaling/ec2/userguide/auto-scaling-groups.html) no Guia do usuário do Amazon EC2 Auto Scaling.

- ** `GetTaskProtection` **
  - **Motivo da falha ou Motivo da interrupção:** `MISSING` / **Causa:** A tarefa especificada não foi encontrada. Verifique se o nome ou o ARN do cluster e o ARN ou o ID da tarefa são válidos.
  - **Motivo da falha ou Motivo da interrupção:** `TASK_NOT_VALID` / **Causa:** A tarefa especificada não faz parte de um serviço do Amazon ECS. Somente tarefas gerenciadas por serviços do Amazon ECS podem ser protegidas. Verifique o ARN ou o ID da tarefa e tente novamente.

- ** `RunTask` ou `StartTask` **
  - **Motivo da falha ou Motivo da interrupção:** `RESOURCE:*` / **Causa:** O recurso ou os recursos solicitados pela tarefa estão indisponíveis nas instâncias de contêiner no cluster. Se o recurso for CPU, memória, portas ou interfaces de redes elásticas, poderá ser necessário adicionar instâncias de contêineres ao cluster.<br />Para erros `RESOURCE:ENI`, o cluster não tem quaisquer pontos de conexão com a interface de rede elástica disponíveis, que são necessários para tarefas que usam o modo de rede `awsvpc`. As instâncias do Amazon EC2 têm um limite para o número de interfaces de rede que podem ser anexadas a elas, e a interface de rede primária conta como uma delas. Para obter mais informações sobre quantas interfaces de rede e endereços IP privados são compatíveis com cada tipo de instância, consulte [Endereços IP por interface de rede por tipo de instância](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/using-eni.html#AvailableIpPerENI) no *Manual do usuário do Amazon EC2*.<br />Para erros `RESOURCE:GPU`, o número de GPUs solicitadas pela tarefa não está disponível e talvez você precise adicionar instâncias de contêiner habilitadas para GPU ao cluster. Para obter mais informações, consulte [Definições de tarefa do Amazon ECS para workloads de GPU](ecs-gpu.md).
  - **Motivo da falha ou Motivo da interrupção:** `AGENT` / **Causa:** A instância de contêiner na qual você tentou iniciar uma tarefa tem um agente que está desconectado, no momento. Para evitar tempos de espera prolongados para a tarefa, a solicitação foi rejeitada.<br />Para saber mais sobre como solucionar um agente que está desconectado, consulte [Como solucionar problemas com um agente desconectado do Amazon ECS](https://repost.aws/knowledge-center/ecs-agent-disconnected-linux2-ami).
  - **Motivo da falha ou Motivo da interrupção:** `LOCATION` / **Causa:** A instância de contêiner na qual você tentou iniciar uma tarefa está em uma zona de disponibilidade diferente das sub-redes especificadas em `awsVpcConfiguration`.
  - **Motivo da falha ou Motivo da interrupção:** `ATTRIBUTE` / **Causa:** A definição de tarefa contém um parâmetro que exige um atributo de instância de contêiner específico que não está disponível nas instâncias de contêiner. Por exemplo, se sua tarefa usar o modo de rede `awsvpc`, mas não houver instâncias nas suas sub-redes especificadas com o atributo `ecs.capability.task-eni`. Para obter mais informações sobre quais atributos são obrigatórios para parâmetros de definição de tarefa específicos e variáveis de configuração de agentes, consulte [Parâmetros de definição de tarefa do Amazon ECS para o Fargate](task_definition_parameters.md) e [Configuração do agente de contêiner do Amazon ECS](ecs-agent-config.md).

- ** `StartTask` **
  - **Motivo da falha ou Motivo da interrupção:** `MISSING` / **Causa:** Não foi possível encontrar a instância de contêiner na qual você tentou executar a tarefa. Verifique se o cluster ou a região errada foram especificados ou se o ARN ou ID da instância de contêiner estão escritos incorretamente.
  - **Motivo da falha ou Motivo da interrupção:** `INACTIVE` / **Causa:** O registro da instância de contêiner na qual você tentou iniciar uma tarefa foi cancelado anteriormente junto ao Amazon ECS e não pode ser usado.

- ** `StopServiceDeployment` **
  - **Motivo da falha ou Motivo da interrupção:** `ECS deployment failed`
  - **Causa:** Uma conta fraudulenta executou a API StopServiceDeployment.

- ** `TagResource` **
  - **Motivo da falha ou Motivo da interrupção:** `InvalidParameterException`
  - **Causa:** O ARN do serviço que você está marcando tem o formato curto. Você deve migrar para o formato longo. Para obter informações sobre como migrar o ARN, consulte [Migrar um ARN curto de um serviço do Amazon ECS para um ARN longo](service-arn-migration.md).

- ** `UpdateTaskProtection` **
  - **Motivo da falha ou Motivo da interrupção:** `DEPLOYMENT_BLOCKED` / **Causa:** Não é possível definir a proteção de tarefas, pois uma ou mais tarefas protegidas estão impedindo que a implantação do serviço atinja um estado estável. Cancele a proteção de tarefas existentes ou espere até que a proteção de tarefas expire.
  - **Motivo da falha ou Motivo da interrupção:** `MISSING` / **Causa:** A tarefa especificada não foi encontrada. Verifique se o nome ou o ARN do cluster e o ARN ou o ID da tarefa são válidos.
  - **Motivo da falha ou Motivo da interrupção:** `TASK_NOT_VALID` / **Causa:** A tarefa especificada não faz parte de um serviço do Amazon ECS. Somente tarefas gerenciadas por serviços do Amazon ECS podem ser protegidas. Verifique o ARN ou o ID da tarefa e tente novamente.



**nota**  
Além dos cenários de falha descritos aqui, as operações de APIs também podem apresentar falha devido a exceções, resultando em respostas de erro. Para obter uma lista dessas exceções, consulte [Common Errors](https://docs.aws.amazon.com/AmazonECS/latest/APIReference/CommonErrors.html) (Erros comuns).