Motivos de falha da API no Amazon ECS

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 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.

Ação API	Motivo da falha ou Motivo da interrupção	Causa
DescribeClusters	MISSING	O cluster especificado não foi encontrado. Verifique a ortografia do nome do cluster.
DescribeInstances	MISSING	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	MISSING	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	MISSING	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	TaskFailedToStart: RESOURCE:*	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. 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.
	TaskFailedToStart: AGENT	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. Para saber mais sobre como solucionar um agente que está desconectado, consulte Como solucionar problemas com um agente desconectado do Amazon ECS.
	TaskFailedToStart: MemberOf placement constraint unsatisfied	Não há nenhuma instância de contêiner que atenda às restrições de posicionamento especificadas na definição da tarefa.
	TaskFailedToStart: ATTRIBUTE	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 e Configuração do agente de contêiner do Amazon ECS.
	TaskFailedToStart: NO ACTIVE INSTANCES	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 no Guia do usuário do Amazon EC2 Auto Scaling.
	TaskFailedToStart: EMPTY CAPACITY PROVIDER	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 no Guia do usuário do Amazon EC2 Auto Scaling.
GetTaskProtection	MISSING	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.
	TASK_NOT_VALID	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	RESOURCE:*	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. 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 no Manual do usuário do Amazon EC2. 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 ter mais informações, consulte Definições de tarefa do Amazon ECS para workloads de GPU.
	AGENT	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. Para saber mais sobre como solucionar um agente que está desconectado, consulte Como solucionar problemas com um agente desconectado do Amazon ECS.
	LOCATION	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.
	ATTRIBUTE	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 e Configuração do agente de contêiner do Amazon ECS.
StartTask	MISSING	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.
	INACTIVE	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.
UpdateTaskProtection	DEPLOYMENT_BLOCKED	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.
	MISSING	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.
	TASK_NOT_VALID	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 (Erros comuns).