Usar StartSession
com uma CLI
Os exemplos de código a seguir mostram como usar o StartSession
.
- CLI
-
- AWS CLI
-
Exemplo 1: Para iniciar uma sessão do Session Manager
Este exemplo de
start-session
estabelece uma conexão com uma instância para uma sessão do Session Manager. Observe que esse comando interativo exige que o plug-in do Session Manager seja instalado na máquina-cliente que faz a chamada.aws ssm start-session \ --target
"i-1234567890abcdef0"
Saída:
Starting session with SessionId: Jane-Roe-07a16060613c408b5
Exemplo 2: Para iniciar uma sessão do Session Manager usando SSH
Este exemplo de
start-session
estabelece uma conexão com uma instância para uma sessão do Session Manager usando SSH. Observe que esse comando interativo exige que o plug-in do Session Manager seja instalado na máquina-cliente que faz a chamada e que o comando use o usuário padrão na instância, comoec2-user
nas instâncias do EC2 para Linux.ssh -i /path/my-key-pair.pem ec2-user@i-02573cafcfEXAMPLE
Saída:
Starting session with SessionId: ec2-user-07a16060613c408b5
Para obter mais informações, consulte Iniciar uma sessão e Instale o plugin do Session Manager para AWS CLI no Guia de usuário do AWS Systems Manager.
-
Para obter detalhes da API, consulte StartSession
na Referência de comandos da AWS CLI.
-
- PowerShell
-
- Ferramentas para PowerShell
-
Exemplo 1: Este exemplo inicia uma conexão com um destino para uma sessão do Session Manager, habilitando o encaminhamento de portas.
Start-SSMSession -Target 'i-064578e5e7454488f' -DocumentName 'AWS-StartPortForwardingSession' -Parameter @{ localPortNumber = '8080'; portNumber = '80' }
Saída:
SessionId StreamUrl ---------- ---------- random-id0 wss://ssmmessages.amazonaws.com/v1/data-channel/random-id
-
Para obter detalhes da API, consulte StartSession na AWS Tools for PowerShell Cmdlet Reference.
-
Para ver uma lista completa dos Guias do desenvolvedor de SDK da AWS e exemplos de código, consulte Usar o Systems Manager com um AWS SDK. Este tópico também inclui informações sobre como começar e detalhes sobre versões anteriores do SDK.