

# Estados de definição de tarefa do Amazon ECS
<a name="task-definition-state"></a>

A definição de uma tarefa muda de estado ao criá-la, cancelar o registro ou exclui-la. É possível visualizar o estado da definição de tarefa no console ou usando `DescribeTaskDefinition`. 

Veja a seguir os estados possíveis para uma definição de tarefa:

ACTIVE  
A definição de uma tarefa é `ACTIVE` após ser registrada no Amazon ECS. É possível usar as definições de tarefa no estado `ACTIVE` para executar tarefas ou criar serviços.

INACTIVE  
Quando você cancela o registro de uma definição de tarefa, uma definição de tarefa passa do estado `ACTIVE` para o estado `INACTIVE`. É possível recuperar uma definição de tarefa `INACTIVE` chamando `DescribeTaskDefinition`. Não é possível executar novas tarefas ou criar novos serviços com uma definição de tarefa no estado `INACTIVE`. Não há impacto sobre os serviços ou tarefas existentes.

DELETE\$1IN\$1PROGRESS  
Depois que você envia a definição da tarefa para exclusão, uma definição de tarefa passa do estado `INACTIVE` para o estado `DELETE_IN_PROGRESS`. Depois que a definição da tarefa estiver no estado `DELETE_IN_PROGRESS`, o Amazon ECS verificará periodicamente se a definição da tarefa de destino não está sendo mencionada por nenhuma tarefa ou implantação ativa e, em seguida, excluirá a definição da tarefa permanentemente. Não é possível executar novas tarefas ou criar novos serviços com uma definição de tarefa no estado `DELETE_IN_PROGRESS`. É possível enviar uma definição de tarefa para exclusão a qualquer momento sem afetar tarefas e serviços existentes.  
É possível visualizar no console as definições de tarefa que estão no estado `DELETE_IN_PROGRESS`, e a definição da tarefa pode ser recuperada chamando `DescribeTaskDefinition`.  
Quando você exclui todas as revisões de definição da tarefa `INACTIVE`, o nome da definição da tarefa não é exibido no console e não é retornado na API. Se uma revisão de definição de tarefa estiver no estado `DELETE_IN_PROGRESS`, o nome da definição de tarefa é exibido no console e retornado na API. O nome da definição da tarefa é mantido pelo Amazon ECS e a revisão será incrementada na próxima vez que você criar uma definição de tarefa com esse nome.

Se você usar o AWS Config para gerenciar suas definições de tarefa, o AWS Config cobrará por todos os registros de definição de tarefa. Só haverá cobrança pelo cancelamento do registro da definição de tarefa `ACTIVE` mais recente. Não haverá cobrança pela exclusão de uma definição de tarefa. Para obter mais informações sobre definição de preço, consulte [Preços do AWS Config](https://aws.amazon.com/config/pricing/).

## Recursos do Amazon ECS que podem bloquear uma exclusão
<a name="resource-block-delete"></a>

Uma solicitação de exclusão da definição de tarefa não será concluída se houver algum recurso do Amazon ECS que dependa da revisão da definição de tarefa. Os recursos a seguir podem impedir que uma definição de tarefa seja excluída:
+ Tarefas autônomas do Amazon ECS: a definição da tarefa é necessária para que a tarefa permaneça íntegra.
+ Tarefas de serviço do Amazon ECS: a definição da tarefa é necessária para que a tarefa permaneça íntegra.
+ Implantações e conjuntos de tarefas do serviço do Amazon ECS: a definição da tarefa é necessária quando um evento de escalabilidade é iniciado para uma implantação ou conjunto de tarefas do Amazon ECS.

Se sua definição de tarefa permanecer no estado `DELETE_IN_PROGRESS`, será possível usar o console ou a AWS CLI para identificar e interromper os recursos que bloqueiem a exclusão da definição de tarefa.

### Exclusão da definição de tarefa após a remoção do recurso bloqueado
<a name="resource-block-remove"></a>

As regras a seguir se aplicam depois que você remove os recursos que bloqueiam a exclusão da definição da tarefa:
+ Tarefas do Amazon ECS: a exclusão da definição da tarefa pode levar até uma hora para ser concluída após a interrupção da tarefa.
+ Implantações e conjuntos de tarefas do serviço do Amazon ECS: a exclusão da definição da tarefa pode levar até 24 horas para ser concluída após a exclusão da implantação ou do conjunto de tarefas.