Utilizzo di StartSession con una CLI

Gli esempi di codice seguenti mostrano come utilizzare StartSession.

CLI

AWS CLI

Esempio 1: per avviare una sessione di Session Manager

Questo esempio start-session stabilisce una connessione con un'istanza per una sessione di Session Manager. Si noti che questo comando interattivo richiede l'installazione del plug-in Session Manager sul computer client che effettua la chiamata.

aws ssm start-session \
    --target "i-1234567890abcdef0"

Output:

Starting session with SessionId: Jane-Roe-07a16060613c408b5

Esempio 2: per avviare una sessione di Session Manager utilizzando SSH

Questo esempio start-session stabilisce una connessione con un'istanza per una sessione di Session Manager utilizzando SSH. Tieni presente che questo comando interattivo richiede l'installazione del plug-in Session Manager sul computer client che effettua la chiamata e che il comando utilizza l'utente predefinito sull'istanza, ad esempio per EC2 le istanze ec2-user per Linux.

ssh -i /path/my-key-pair.pem ec2-user@i-02573cafcfEXAMPLE

Output:

Starting session with SessionId: ec2-user-07a16060613c408b5

Per ulteriori informazioni, vedere Avvio di una sessione e installazione del plug-in Session Manager per la AWS CLI nella Guida per l'utente di AWS Systems Manager.

• Per i dettagli sull'API, vedere StartSessionin AWS CLI Command Reference.

PowerShell

Strumenti per PowerShell V4

Esempio 1: questo esempio avvia una connessione a una destinazione per una sessione di Session Manager, abilitando il port forwarding.

Start-SSMSession -Target 'i-064578e5e7454488f' -DocumentName 'AWS-StartPortForwardingSession' -Parameter @{ localPortNumber = '8080'; portNumber = '80' }

Output:

SessionId    StreamUrl
----------    ----------
random-id0    wss://ssmmessages.amazonaws.com/v1/data-channel/random-id

• Per i dettagli sull'API, vedere StartSessionin AWS Strumenti per PowerShell Cmdlet Reference (V4).

Strumenti per V5 PowerShell

Esempio 1: questo esempio avvia una connessione a una destinazione per una sessione di Session Manager, abilitando il port forwarding. Nota: è necessario aggiungere il parametro Region se non è già impostato utilizzando AWSCredentials.

Start-SSMSession -Target 'i-064578e5e7454488f' -DocumentName 'AWS-StartPortForwardingSession' -Parameter @{ localPortNumber = '8080'; portNumber = '80' } -Region 'us-west-1'

Output:

Starting session with SessionId: testUser-xi4glew849asyeryde34u4dfsdfy
Port 8080 opened for sessionId testUser-xi4glew849asyeryde34u4dfsdfy.
Waiting for connections...

Esempio 2: Questo esempio crea una sessione interattiva con un'istanza specificata per una sessione di Session Manager.

Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1'

Output:

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>

Esempio 3: Questo esempio crea una sessione senza connettersi ad essa e restituisce le TokenValue proprietà SessionId StreamUrl, e necessarie per connettersi alla sessione.

Start-SSMSession -Target 'i-1234567890abcdef0' -Region 'us-west-1' -DisablePluginInvocation

Output:

SessionId        : testUser-xi4glew849asyeryde34u4dfsdfy
StreamUrl        : {StreamUrl value redacted}
TokenValue       : {Token value redacted}
ContentLength    : 1207
HttpStatusCode   : OK

• Per i dettagli sull'API, vedere StartSessionin AWS Strumenti per PowerShell Cmdlet Reference (V5).

Per un elenco completo delle guide per sviluppatori AWS SDK e degli esempi di codice, vedere. Utilizzo di questo servizio con un AWS SDK Questo argomento include anche informazioni su come iniziare e dettagli sulle versioni precedenti dell'SDK.