Há mais exemplos de AWS SDK disponíveis no repositório [AWS Doc SDK Examples](https://github.com/awsdocs/aws-doc-sdk-examples) GitHub . 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á. # 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, como `ec2-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](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-sessions-start.html) e [instalar o plug-in do gerenciador de sessões para a AWS CLI no Guia](https://docs.aws.amazon.com/systems-manager/latest/userguide/session-manager-working-with-install-plugin.html) do *usuário do AWS Systems Manager*. + Para obter detalhes da API, consulte [StartSession](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/ssm/start-session.html)em *Referência de AWS CLI Comandos*. ------ #### [ PowerShell ] **Ferramentas para PowerShell V4** **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](https://docs.aws.amazon.com/powershell/v4/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V4)*. **Ferramentas para PowerShell V5** **Exemplo 1: Este exemplo inicia uma conexão com um destino para uma sessão do Session Manager, habilitando o encaminhamento de portas. Nota: Você precisa adicionar o parâmetro Region, se ainda não estiver definido usando AWSCredentials.** ``` Start-SSMSession -Target 'i-064578e5e7454488f' -DocumentName 'AWS-StartPortForwardingSession' -Parameter @{ localPortNumber = '8080'; portNumber = '80' } -Region 'us-west-1' ``` **Saída**: ``` Starting session with SessionId: testUser-xi4glew849asyeryde34u4dfsdfy Port 8080 opened for sessionId testUser-xi4glew849asyeryde34u4dfsdfy. Waiting for connections... ``` **Exemplo 2: esse exemplo cria uma sessão interativa com uma instância especificada para uma sessão do Session Manager.** ``` Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1' ``` **Saída**: ``` Starting session with SessionId : testUser-xi4glew849asyeryde34u4dfsdfy Windows PowerShell Copyright (C) Microsoft Corporation. All rights reserved. Install the latest PowerShell for new features and improvements! PS C:\Windows\system32> whoami ec2amaz-fnsdrwv\ec2-test-user PS C:\Windows\system32> ``` **Exemplo 3: Este exemplo cria uma sessão sem se conectar a ela e retorna as TokenValue propriedades SessionId StreamUrl,, e necessárias para se conectar à sessão.** ``` Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1' -DisablePluginInvocation ``` **Saída**: ``` SessionId : testUser-xi4glew849asyeryde34u4dfsdfy StreamUrl : {StreamUrl value redacted} TokenValue : {Token value redacted} ContentLength : 1207 HttpStatusCode : OK ``` + Para obter detalhes da API, consulte [StartSession](https://docs.aws.amazon.com/powershell/v5/reference)em *Referência de Ferramentas da AWS para PowerShell cmdlet (V5)*. ------