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

É possível cancelar o registro da revisão de definição de tarefa, de modo que ela não seja mais exibida nas chamadas de API `ListTaskDefinition` ou no console quando quiser executar uma tarefa ou atualizar um serviço.

Quando você cancela o registro de uma revisão de definição de tarefa, ela é marcada imediatamente como `INACTIVE`. Tarefas e serviços existentes que fazem referência a uma revisão de definição de tarefa `INACTIVE` continuam a ser executados sem interrupções. Serviços existentes que fazem referência a uma revisão de definição de tarefa `INACTIVE` ainda podem aumentar ou diminuir na escala vertical modificando-se a contagem desejada do serviço.

Não é possível usar uma revisão de definição de tarefa `INACTIVE` para executar novas tarefas ou criar novos serviços. Você também não pode atualizar um serviço existente para fazer referência a uma revisão de definição de tarefa `INACTIVE` (embora possa haver uma janela de até 10 minutos após o cancelamento do registro no qual essas restrições ainda não tenham entrado em vigor).

**nota**  
Quando você cancela o registro de todas as revisões em uma família de tarefas, a família de definição de tarefa é movida para a lista `INACTIVE`. Adicionar uma nova revisão de uma definição de tarefa de `INACTIVE` fará com que a família de definição de tarefa retorne para a lista `ACTIVE`.  
Neste momento, as revisões de definição de tarefa `INACTIVE` permanecem detectáveis na sua conta indefinidamente. No entanto, esse comportamento está sujeito a alterações no futuro. Portanto, você não deve confiar em revisões de definição de tarefa `INACTIVE` que persistem além do ciclo de vida de quaisquer tarefas e serviços associados.

## Pilhas do CloudFormation
<a name="cloudformation-stack"></a>

O comportamento a seguir é aplicável às definições de tarefa criadas no novo console do Amazon ECS antes de 12 de janeiro de 2023.

Ao criar uma definição de tarefa, o console do Amazon ECS cria automaticamente uma pilha do CloudFormation com um nome que começa com `ECS-Console-V2-TaskDefinition-`. Se tiver usado a AWS CLI ou um AWS SDK para cancelar o registro da definição de tarefa, você deverá excluir manualmente a pilha de definições de tarefa. Para obter mais informações, consulte [Excluir uma pilha](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-delete-stack.html) no *Guia do usuário do CloudFormation*.

As definições de tarefa criadas após 12 de janeiro de 2023 não têm uma pilha do CloudFormation criada automaticamente para elas.

## Procedimento
<a name="deregister-task-definition-v2-procedure"></a>

**Para cancelar o registro de uma nova definição de tarefa (console do Amazon ECS)**

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 **Task definitions** (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 cancelar.

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

1. Verifique as informações na janela **Deregister** (Cancelar registro) e escolha **Deregister** (Cancelar registro) para terminar.