# Run Command: rodar um comando de shell nas suas instâncias

Rode df -h, free -m ou qualquer comando em instâncias EC2 gerenciadas pelo Systems Manager, acompanhe ao vivo e leia a saída.

Abra **Services → Systems Manager → Run Command**, ou **More → Run command** em uma instância EC2 (ela já vem escolhida).

Screenshot: Resultado do Run Command: df -h deu certo em web-1 e checkout-api-1, com o código de saída e a saída de cada instância

1. **Escolha as instâncias.** A lista mostra o status de ping, a plataforma e a versão do SSM Agent de cada instância gerenciada. Instâncias cujo agente não está conectado não podem ser escolhidas.
2. **Digite os comandos**, um por linha, ou toque em um atalho: *Disk* (`df -h`), *Memory* (`free -m`), *Uptime*, *Service status* (`systemctl status <service>`: troque o marcador), principais processos, erros recentes. Instâncias Windows recebem atalhos de PowerShell e `AWS-RunPowerShellScript`; as Linux, `AWS-RunShellScript`.
3. **Rode.** É uma ação Pro e passa pela sua proteção. Em uma conta cujo nome parece de produção (prod, production, live), você sempre digita o nome da conta para confirmar.

A tela do comando se atualiza a cada poucos segundos até todas as instâncias terminarem e então mostra o código de saída, a saída e os erros de cada uma. A API guarda os primeiros 24.000 caracteres de cada; para mais, o comando precisa de saída para um bucket do S3 ou para o CloudWatch Logs, que a tela vincula quando configurada. **Recent commands** lista os últimos comandos, com os resultados.

## Instâncias não gerenciadas

Instâncias EC2 em execução que faltam no Systems Manager aparecem com o motivo provável: *No instance profile* (anexe uma função com `AmazonSSMManagedInstanceCore`) ou *SSM agent not connected* (falta essa política na função, o agente está parado ou a instância não alcança os endpoints do SSM pela internet nem por endpoints de VPC).

## Permissões

| O quê | Ações do IAM | Em ReadOnlyAccess / ViewOnlyAccess |
|---|---|---|
| Instâncias gerenciadas | `ssm:DescribeInstanceInformation` (e `ec2:DescribeInstances` para a lista das não gerenciadas) | Sim / Não (adicione) |
| Comandos recentes, status e saída | `ssm:ListCommands`, `ssm:ListCommandInvocations`, `ssm:GetCommandInvocation` | Sim / Não (adicione) |
| Run | `ssm:SendCommand` no documento e nas instâncias | Não / Não |

## Perguntas frequentes

### Abre uma sessão de shell?

Não. O Run Command envia os comandos e devolve a saída; nada fica aberto. Para uma sessão interativa, use Copy SSM session command na instância e rode no seu computador.

**Ainda com dúvidas?**

Escreva para [support@cloudconsole.dev](mailto:support@cloudconsole.dev) contando o que você tentou e qual mensagem o app mostrou. Não envie chaves de acesso nem segredos. Respondemos em até dois dias úteis.

## Veja também

- [Parameter Store: navegar, revelar e editar parâmetros](https://cloudconsole.dev/pt-br/help/parameter-store) – Como usar o app
- [O que você pode alterar pelo celular](https://cloudconsole.dev/pt-br/help/actions) – Segurança e alterações
- [Permissões para alterações (ações do Pro)](https://cloudconsole.dev/pt-br/help/permissions-for-changes) – Permissões e erros
- [Proteções: como as alterações são confirmadas](https://cloudconsole.dev/pt-br/help/guardrails) – Segurança e alterações

[Todos os tópicos de ajuda →](https://cloudconsole.dev/pt-br/help/)

---

Source: https://cloudconsole.dev/pt-br/help/run-command

CloudConsole is an independent iPhone and Android app for Amazon Web Services by Cloudconcur Ltd. It is not affiliated with Amazon Web Services.
