AWS-ECSRunTask - AWS Systems Manager 自动化运行手册参考

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

AWS-ECSRunTask

描述

AWS-ECSRunTask运行手册运行您指定的亚马逊弹性容器服务 (AmazonECS) 任务。

运行此自动化(控制台)

文档类型

自动化

所有者

Amazon

平台

Linux

参数

  • AutomationAssumeRole

    类型:字符串

    描述:(可选)允许 Systems ARN Manager Automation 代表您执行操作的 AWS Identity and Access Management (IAM) 角色的亚马逊资源名称 ()。如果未指定角色,Systems Manager Automation 将使用启动此运行手册的用户的权限。

  • capacityProviderStrategy

    类型:字符串

    描述:(可选)用于任务的容量提供者策略。

  • cluster

    类型:字符串

    描述:(可选)要运行任务ARN的集群的短名称或。如果未指定集群,则使用默认集群。

  • count

    类型:字符串

    描述:(可选)要在集群上放置的指定任务的实例化次数。您最多可以为每个请求指定 10 个任务。

  • enableECSManaged标签

    类型:布尔值

    描述:(可选)指定是否为任务使用 Amazon ECS 托管标签。有关更多信息,请参阅《亚马逊弹性容器服务开发者指南》中的为亚马逊ECS资源添加标签

  • enableExecuteCommand

    类型:布尔值

    描述:(可选)确定是否激活此任务中容器的执行命令功能。如果为 true,则将在任务中的所有容器上激活执行命令功能。

  • 类型:字符串

    描述:(可选)要与任务关联的任务组的名称。默认值为任务定义的姓氏。例如:family:my-family-name

  • launchType

    类型:字符串

    有效值:EC2| FARGATE | EXTERNAL

    描述:(可选)运行独立任务的基础架构。

  • networkConfiguration

    类型:字符串

    描述:(可选)任务的网络配置。使用awsvpc网络模式接收自己的 elastic network interface 的任务定义必须使用此参数,其他网络模式则不支持此参数。

  • 覆盖

    类型:字符串

    描述:(可选)容器覆盖列表,其JSON格式指定了指定任务定义中容器的名称及其应接收的替代项。您可以使用命令替换在任务定义或 Docker 镜像中指定的容器的默认命令。您还可以覆盖任务定义或容器上的 Docker 镜像中指定的现有环境变量。此外,您还可以使用环境覆盖来添加新的环境变量。

  • placementConstraints

    类型:字符串

    描述:(可选)用于任务的放置约束对象数组。您最多可以为每项任务指定 10 个约束条件,包括任务定义中的约束条件和运行时指定的约束条件。

  • placementStrategy

    类型:字符串

    描述:(可选)用于任务的放置策略对象。您最多可以为每个任务指定 5 条策略规则。

  • platformVersion

    类型:字符串

    描述:(可选)任务使用的平台版本。仅为 Fargate 上托管的任务指定平台版本。如果未指定任何版本,将使用 LATEST 平台版本。

  • propagateTags

    类型:字符串

    描述:(可选)确定标签是否从任务定义传播到任务。如果未指定任何值,则不会传播标签。只能在任务创建过程中将标签传播到任务。

  • referenceId

    类型:字符串

    描述:(可选)用于任务的参考 ID。参考 ID 的最大长度可以为 1024 个字符。

  • startedBy

    类型:字符串

    描述:(可选)任务启动时指定的可选标签。这有助于您通过筛选ListTasksAPI操作结果来确定哪些任务属于特定作业。最多允许 36 个字母(大写和小写)、数字、连字符 (-) 和下划线 (_)。

  • 标签

    类型:字符串

    描述:(可选)要应用于任务的元数据,以帮助您对任务进行分类和组织。每个标签都由用户定义的键和值组成。

  • taskDefinition

    类型:字符串

    描述:(可选)要运行的任务定义ARN的familyrevisionfamily:revision)或全部。如果未指定修订版,则使用最新的ACTIVE修订版。

所需IAM权限

AutomationAssumeRole 参数需要执行以下操作才能成功使用运行手册。

  • ecs:RunTask

文档步骤

aws:executeScript-根据您为运行手册输入参数指定的值运行 Amazon ECS 任务。