

# 使用控制台注销 Amazon ECS 任务定义修订
<a name="deregister-task-definition-v2"></a>

您可以注销任务定义修订，这样一来，当您想运行任务或更新服务时，任务定义修订将不再显示在 `ListTaskDefinition` API 调用或控制台中。

在注销任务定义修订后，它将立即被标记为 `INACTIVE`。现有任务和服务引用 `INACTIVE` 任务定义修订版将继续运行，而不会中断。引用 `INACTIVE` 任务定义修订仍可通过修改服务的预期数目来纵向扩展或缩减。

您不能使用 `INACTIVE` 任务定义修订版以运行新任务或创建新服务。您也无法更新现有服务以引用 `INACTIVE` 任务定义修订版（即使在取消注册后，这些限制尚未生效的情况下，可能会有长达10分钟的窗口）。

**注意**  
注销任务系列中的所有修订后，任务定义系列将移至 `INACTIVE` 列表。添加 `INACTIVE` 任务定义的新修订会将任务定义系列移回 `ACTIVE` 列表。  
在这个时候,`INACTIVE` 任务定义修订版本仍然可以无限期地在您的账户中发现。但是，此行为可能会在将来发生变化。因此，您不应该依赖 `INACTIVE` 任务定义修订版，这些修订版将持续存在于任何相关任务和服务的生命周期之外。

## Amazon CloudFormation 堆栈
<a name="cloudformation-stack"></a>

以下行为适用于 2023 年 1 月 12 日之前在新的 Amazon ECS 控制台中创建的任务定义。

当您创建任务定义时，Amazon ECS 控制台会自动创建一个名称以 `ECS-Console-V2-TaskDefinition-` 开头的 CloudFormation 堆栈。如果您使用 Amazon CLI 或 Amazon SDK 取消注册任务定义，则必须手动删除任务定义堆栈。有关更多信息，请参阅《Amazon CloudFormation 用户指南》**中的[删除堆栈](https://docs.amazonaws.cn/AWSCloudFormation/latest/UserGuide/cfn-console-delete-stack.html)。

2023 年 1 月 12 日之后创建的任务定义不会为其自动创建 CloudFormation 堆栈。

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

**取消注册新的任务定义（Amazon ECS 控制台）**

1. 在 [https://console.aws.amazon.com/ecs/v2](https://console.amazonaws.cn/ecs/v2) 打开控制台。

1. 从导航栏中，选择包含您的任务定义的区域。

1. 在导航窗格中，选择 **Task definitions**（任务定义）。

1. 在 **Task definitions**（任务定义）页面上，选择包含要取消注册的一个或多个修订的任务定义系列。

1. 在**任务定义名称**页面上，选择要删除的修订，然后依次选择**操作**、**取消注册**。

1. 验证 **Deregister**（注销）窗口中的信息，然后选择 **Deregister**（注销）以完成操作。