本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # `AWS-ECSRunTask` **描述** 运行`AWS-ECSRunTask`手册运行您指定的亚马逊弹性容器服务 (Amazon ECS) 任务。 [运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-ECSRunTask) **文档类型** 自动化 **所有者** Amazon **平台** Linux **参数** + AutomationAssumeRole 类型：字符串 描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。 + 容量 ProviderStrategy 类型：字符串 描述：（可选）用于任务的容量提供者策略。 + cluster 类型：字符串 描述：（可选）用于运行任务的集群的短名称或 ARN。如果未指定集群，则使用默认集群。 + count 类型：字符串 描述：（可选）要在集群上放置的指定任务的实例化次数。您最多可以为每个请求指定 10 个任务。 + 启用 ECSManagedTags 类型：布尔值 描述：（可选）指定是否对任务使用 Amazon ECS 托管标签。有关更多信息，请参阅《Amazon Elastic Container Service 开发人员指南》中的[标记 Amazon ECS 资源](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html)。 + 启用 ExecuteCommand 类型：布尔值 描述：（可选）确定是否激活此任务中容器的执行命令功能。如果为 true，则将在任务中的所有容器上激活执行命令功能。 + 组 类型：字符串 描述：（可选）要与任务关联的任务组的名称。默认值为任务定义的姓氏。例如 `family:my-family-name`。 + 启动类型 类型：字符串 有效值：EC2 \| FARGATE \| EXTERNAL 描述：（可选）运行独立任务的基础架构。 + networkConfiguration 类型：字符串 描述：（可选）任务的网络配置。使用`awsvpc`网络模式接收自己的 elastic network interface 的任务定义必须使用此参数，其他网络模式则不支持此参数。 + 覆盖 类型：字符串 描述：（可选）JSON 格式的容器覆盖列表，用于指定任务定义中指定容器的名称以及容器应接收的替代项。您可以使用命令替换在任务定义或 Docker 镜像中指定的容器的默认命令。您还可以覆盖任务定义或容器上的 Docker 镜像中指定的现有环境变量。此外，您还可以使用环境覆盖来添加新的环境变量。 + placementConstraints 类型：字符串 描述：（可选）用于任务的放置约束对象数组。您最多可以为每项任务指定 10 个约束条件，包括任务定义中的约束条件和运行时指定的约束。 + placementStrategy 类型：字符串 描述：（可选）用于任务的放置策略对象。您最多可以为每个任务指定 5 条策略规则。 + platformVersion 类型：字符串 描述：（可选）任务使用的平台版本。仅为 Fargate 上托管的任务指定平台版本。如果未指定任何版本，将使用 `LATEST` 平台版本。 + propagateTags 类型：字符串 描述：（可选）确定标签是否从任务定义传播到任务。如果未指定任何值，则不会传播标签。只能在任务创建过程中将标签传播到任务。 + referenceId 类型：字符串 描述：（可选）用于任务的参考 ID。参考 ID 的最大长度可以为 1024 个字符。 + 起始者 类型：字符串 描述：（可选）任务启动时指定的可选标签。这有助于您通过筛选 `ListTasks` API 操作的结果来确定哪些任务属于特定作业。最多允许 36 个字母（大写和小写）、数字、连字符 (-) 和下划线 (\_)。 + 标签 类型：字符串 描述：（可选）要应用于任务的元数据，以帮助您对任务进行分类和组织。每个标签都由用户定义的键和值组成。 + 任务定义 类型：字符串 描述：（可选）要`family`运行的任务定义的和 `revision` (`family`:`revision`) 或完整 ARN。如果未指定修订版，则使用最新的`ACTIVE`修订版。 **所需的 IAM 权限** `AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。 + `ecs:RunTask` **文档步骤** `aws:executeScript`-根据您为运行手册输入参数指定的值运行 Amazon ECS 任务。