

# Exclusão de uma revisão de definição de tarefa do Amazon ECS usando o console
<a name="delete-task-definition-v2"></a>

Quando não precisar mais de uma revisão específica da definição de tarefa no Amazon ECS, você pode excluir a revisão da definição da tarefa.

Quando você exclui uma revisão de definição de tarefa, ela passa imediatamente de `INACTIVE` para `DELETE_IN_PROGRESS`. Tarefas e serviços existentes que fazem referência a uma revisão de definição de tarefa `DELETE_IN_PROGRESS` continuam a ser executados sem interrupções. 

Não é possível usar uma revisão de definição de tarefa `DELETE_IN_PROGRESS` para executar novas tarefas ou criar novos serviços. Também não é possível atualizar um serviço existente para fazer referência a uma revisão de definição de tarefa `DELETE_IN_PROGRESS`.

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.

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

## Procedimento
<a name="delete-task-def-procedure"></a>

**Para excluir definições de tarefa (console do Amazon ECS)**

É necessário cancelar o registro de uma revisão da definição de tarefa antes de excluí-la. Para obter mais informações, consulte [Cancelar registro de uma revisão de definição de tarefa do Amazon ECS usando o console](deregister-task-definition-v2.md).

1. Abra o console em [https://console.aws.amazon.com/ecs/v2](https://console.aws.amazon.com/ecs/v2).

1. Na barra de navegação, selecione a região que contém a definição de tarefa.

1. No painel de navegação, escolha **Task definitions** (Definições de tarefa).

1. Na página **Definições de tarefa**, escolha a família de definições de tarefa que contém uma ou mais revisões cujos registros você quer excluir.

1. Na página **Nome da definição de tarefa**, selecione as revisões a serem excluídas e escolha **Ações**, **Excluir**.

   Se a opção **Excluir** não estiver disponível, você deve cancelar o registro da definição da tarefa.

1. Verifique as informações na caixa de confirmação **Excluir** e escolha **Excluir** para finalizar.