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

# `AWS-InstallAmazonECSAgent`
<a name="automation-aws-install-ecs-agent"></a>

 **描述** 

 `AWS-InstallAmazonECSAgent` 运行手册将 Amazon Elastic Container Service (Amazon ECS) 代理安装在您指定的 Amazon Elastic Compute Cloud (Amazon EC2) 实例上。此运行手册仅支持 Amazon Linux 和 Amazon Linux 2 实例。

 [运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-InstallAmazonECSAgent) 

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux

**参数**
+ AutomationAssumeRole

  类型：字符串

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

  类型： StringList

  描述：（必需）要在其上安装 Amazon ECS 代理的 Amazon EC2 实例的 ID。

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `ssm:GetCommandInvocation` 
+  `ec2:DescribeImages` 
+  `ec2:DescribeInstanceAttribute` 
+  `ec2:DescribeInstances` 

 **文档步骤** 

 `aws:executeScript` - 将 Amazon ECS 代理安装到您在 `InstanceIds` 参数中指定的 Amazon EC2 实例上。

 **输出** 

InstallAmazonECSAgent。 SuccessfulInstances -成功安装 Amazon ECS 代理的实例的 ID。

InstallAmazonECSAgent。 FailedInstances -安装 Amazon ECS 代理失败的实例的 ID。

InstallAmazonECSAgent。 InProgressInstances -正在安装 Amazon ECS 代理的实例的 ID。