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-ECSRunTask` **Descrição** O `AWS-ECSRunTask` runbook executa a tarefa do Amazon Elastic Container Service (Amazon ECS) especificada por você. [Executar esta automação (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWS-ECSRunTask) **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. + capacityProviderStrategy Tipo: string Descrição: (Opcional) A estratégia do provedor de capacidade a ser usada para a tarefa. + cluster Tipo: string Descrição: (Opcional) O nome abreviado ou ARN do cluster no qual executar sua tarefa. Se você não especificar um cluster, o cluster padrão será usado. + contagem Tipo: string Descrição: (Opcional) O número de instanciações da tarefa especificada a serem colocadas em seu cluster. Você pode especificar até 10 tarefas para cada solicitação. + habilitar ECSManaged tags Tipo: booliano Descrição: (Opcional) Especifica se as tags gerenciadas do Amazon ECS devem ser usadas para a tarefa. Para obter mais informações, consulte [Marcar seus recursos do Amazon ECS](https://docs.aws.amazon.com/AmazonECS/latest/developerguide/ecs-using-tags.html), no *Guia do Desenvolvedor do Amazon Elastic Container Service*. + enableExecuteCommand Tipo: booliano Descrição: (Opcional) Determina se a funcionalidade de execução do comando deve ser ativada para os contêineres nessa tarefa. Se verdadeiro, isso ativa a funcionalidade de execução do comando em todos os contêineres da tarefa. + grupo Tipo: string Descrição: (Opcional) O nome do grupo de tarefas a ser associado à tarefa. O valor padrão é o nome da família da definição da tarefa. Por exemplo, .`family:my-family-name` + Tipo de lançamento Tipo: string Valores válidos: EC2 \$1 FARGATE \$1 EXTERNAL Descrição: (Opcional) A infraestrutura na qual executar sua tarefa autônoma. + networkConfiguration Tipo: string Descrição: (Opcional) A configuração de rede para a tarefa. Esse parâmetro é necessário para definições de tarefas que usam o modo de `awsvpc` rede para receber sua própria interface de rede elástica e não é compatível com outros modos de rede. + substituições Tipo: string Descrição: (Opcional) Uma lista de substituições de contêiner no formato JSON que especificam o nome de um contêiner na definição de tarefa especificada e as substituições que ele deve receber. Você pode substituir o comando padrão de um contêiner especificado na definição da tarefa ou na imagem do Docker com uma substituição de comando. Você também pode substituir as variáveis de ambiente existentes que são especificadas na definição da tarefa ou na imagem do Docker em um contêiner. Além disso, você pode adicionar novas variáveis de ambiente com uma substituição de ambiente. + placementConstraints Tipo: string Descrição: (Opcional) Uma matriz de objetos de restrição de posicionamento para usar na tarefa. Você pode especificar até 10 restrições para cada tarefa, incluindo restrições na definição da tarefa e aquelas especificadas em tempo de execução. + placementStrategy Tipo: string Descrição: (Opcional) Os objetos da estratégia de posicionamento a serem usados na tarefa. Você pode especificar no máximo 5 regras de estratégia para cada tarefa. + platformVersion Tipo: string Descrição: (Opcional) A versão da plataforma que a tarefa usa. Uma versão da plataforma é especificada somente para tarefas hospedadas no Fargate. Se não for especificada uma versão da plataforma, a versão da plataforma `LATEST` será usada. + propagateTags Tipo: string Descrição: (Opcional) Determina se as tags se propagam da definição da tarefa para a tarefa. Se nenhum valor for especificado, as tags não serão propagadas. As tags só podem ser propagadas para a tarefa durante sua criação. + referenceId Tipo: string Descrição: (Opcional) O ID de referência a ser usado para a tarefa. O ID de referência pode ter um tamanho máximo de 1024 caracteres. + Iniciado por Tipo: string Descrição: (Opcional) Uma tag opcional especificada quando uma tarefa é iniciada. Isso ajuda você a identificar quais tarefas pertencem a um trabalho específico filtrando os resultados de uma operação de `ListTasks` API. São permitidos até 36 letras (maiúsculas e minúsculas), números, hífens (-) e sublinhados (\$1). + tags Tipo: string Descrição: (Opcional) Metadados que você deseja aplicar à tarefa para ajudá-lo a categorizar e organizar tarefas. Cada tag consiste em uma chave e um valor definidos pelo usuário. + Definição de tarefa Tipo: string Descrição: (Opcional) O `family` e `revision` (`family`:`revision`) ou o ARN completo da definição da tarefa a ser executada. Se uma revisão não for especificada, a `ACTIVE` revisão mais recente será usada. **Permissões obrigatórias do IAM** O parâmetro `AutomationAssumeRole` requer as seguintes ações para usar o runbook com êxito. + `ecs:RunTask` **Etapas do documento** `aws:executeScript`- Executa a tarefa do Amazon ECS com base nos valores que você especifica para os parâmetros de entrada do runbook.