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 da API | Motivo da falha ou Motivo da interrupção | Causa |
---|---|---|
|
|
O cluster especificado não foi encontrado. Verifique a ortografia do nome do cluster. |
|
|
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. |
|
|
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. |
|
|
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. |
|
|
Em caso de erro de Em caso de erro de |
|
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 |
|
|
Não há nenhuma instância de contêiner que atenda às restrições de posicionamento especificadas na definição da tarefa. |
|
|
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 |
|
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. | |
|
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. | |
|
|
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. |
|
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. |
|
|
|
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 Para erros |
|
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 |
|
|
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 |
|
|
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 |
|
|
|
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. |
|
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. |
|
|
|
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. |
|
|
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. |
|
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. |
|
|
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).