As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

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

 **Descrição** 

 O runbook `AWS-InstallAmazonECSAgent` instala o atendente do Amazon Elastic Container Service (Amazon ECS) na instância do Amazon Elastic Compute Cloud (Amazon EC2) que for especificado. Este runbook é compatível somente com instâncias do Amazon Linux e do Amazon Linux 2. 

 [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-InstallAmazonECSAgent) 

**Tipo de documento**

Automação

**Proprietário**

Amazon

**Plataformas**

Linux

**Parâmetros**
+ AutomationAssumeRole

  Tipo: String

  Descrição: (opcional) o nome do recurso da Amazon (ARN) do perfil do AWS Identity and Access Management (IAM) que permite que o Systems Manager Automation realize ações em seu nome. Se nenhum perfil for especificado, o Systems Manager Automation usa as permissões do usuário que inicia este runbook.
+ InstanceIds

  Tipo: StringList

  Descrição: (obrigatório) Os IDs das instâncias do Amazon EC2 nas quais deseja instalar o atendente do Amazon ECS.

**Permissões obrigatórias do IAM**

O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito.
+  `ssm:StartAutomationExecution` 
+  `ssm:GetAutomationExecution` 
+  `ssm:GetCommandInvocation` 
+  `ec2:DescribeImages` 
+  `ec2:DescribeInstanceAttribute` 
+  `ec2:DescribeInstances` 

 **Etapas do documento** 

 `aws:executeScript` :Instala o atendente do Amazon ECS nas instâncias do Amazon EC2 especificadas no parâmetro de `InstanceIds`. 

 **Saídas** 

InstallAmazonECSAgent. SuccessfulInstances - O ID da instância em que a instalação do agente do Amazon ECS foi bem-sucedida.

InstallAmazonECSAgent. FailedInstances - O ID da instância em que a instalação do agente do Amazon ECS falhou.

InstallAmazonECSAgent. InProgressInstances - O ID da instância em que a instalação do agente Amazon ECS está em andamento.