本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
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
类型:字符串
描述:(可选)任务启动时指定的可选标签。这有助于您通过筛选
ListTasks
API操作结果来确定哪些任务属于特定作业。最多允许 36 个字母(大写和小写)、数字、连字符 (-) 和下划线 (_)。 -
标签
类型:字符串
描述:(可选)要应用于任务的元数据,以帮助您对任务进行分类和组织。每个标签都由用户定义的键和值组成。
-
taskDefinition
类型:字符串
描述:(可选)要运行的任务定义ARN的
family
和revision
(family
:revision
)或全部。如果未指定修订版,则使用最新的ACTIVE
修订版。
所需IAM权限
AutomationAssumeRole
参数需要执行以下操作才能成功使用运行手册。
-
ecs:RunTask
文档步骤
aws:executeScript
-根据您为运行手册输入参数指定的值运行 Amazon ECS 任务。