# 使用控制台更新 Amazon ECS 任务定义
<a name="update-task-definition-console-v2"></a>

一个*任务定义修订*是当前任务定义的副本，新的参数值将替换现有参数值。您未修改的所有参数都在新修订版中。

要更新任务定义，请创建任务定义修订。如果任务定义用于服务中，则您必须更新该服务才能使用更新的任务定义。

创建修订版时，可以修改以下容器属性和环境属性。
+ 容器映像 URI
+ 端口映射
+ 环境变量
+ 基础设施要求
+ 任务大小
+ 容器大小
+ 任务 角色
+ 任务执行 角色
+ 卷和容器挂载点
+ 私有注册表

使用 JSON 编辑器时，您可以让 Amazon Q 提供建议。有关更多信息，请参阅 [使用 Amazon Q 开发者版在 Amazon ECS 控制台中提供任务定义建议](using-amazon-q.md)。

## JSON 验证
<a name="json-validate-for-update"></a>

Amazon ECS 控制台 JSON 编辑器会在 JSON 文件中验证以下各项：
+ 该文件是有效的 JSON 文件
+ 该文件不包含任何无关的键
+ 该文件包含 `familyName` 参数
+ `containerDefinitions` 下方至少有一个条目

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

------
#### [ Amazon ECS console ]

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

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

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

1. 选择任务定义。

1. 选择任务定义修订版，然后选择**创建新的修订**、**创建新的修订**。

1. 在 **Create new task definition revision**（创建新任务定义修订版）页面上，进行更改。例如，要更改现有的容器定义（如容器映像、内存限制或端口映射），请选择容器，进行更改，然后进行更改。您可以将任务定义兼容性更新为 **AWS Fargate**、**托管实例**或 **Amazon EC2 实例**。

1. 验证信息，然后选择**更新**。

1. 如果您的任务定义已用于某个服务，请使用更新后的任务定义来更新该服务。有关更多信息，请参阅 [更新 Amazon ECS 服务](update-service-console-v2.md)。

------
#### [ Amazon ECS console JSON editor ]

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

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

1. 选择 **Create new revision**（创建新的修订）、**Create new revision with JSON**（使用 JSON 创建新的修订）。

1. 在 JSON 编辑器框中，编辑您的 JSON 文件，

   JSON 必须通过 [JSON 验证](#json-validate-for-update) 中指定的验证检查。

1. 选择**创建**。

------