Utilisation de StartSession avec une CLI - Exemples de code de kit AWS SDK

D’autres exemples de kits AWS SDK sont disponibles dans le référentiel GitHub AWS Doc SDK Examples.

Utilisation de StartSession avec une CLI

Les exemples de code suivants illustrent comment utiliser StartSession.

CLI
AWS CLI

Exemple 1 : démarrage d’une session Session Manager

Cet exemple de start-session établit une connexion avec une instance pour une session Session Manager. Notez que cette commande interactive nécessite l’installation du plugin Session Manager sur l’ordinateur client qui effectue l’appel.

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

Sortie :

Starting session with SessionId: Jane-Roe-07a16060613c408b5

Exemple 2 : démarrage d’une session Session Manager en utilisant SSH

Cet exemple de start-session établit une connexion avec une instance pour une session Session Manager en utilisant SSH. Notez que cette commande interactive nécessite que le plugin Session Manager soit installé sur l’ordinateur client qui effectue l’appel, et que la commande utilise l’utilisateur par défaut sur l’instance, par exemple ec2-user pour les instances EC2 pour Linux.

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

Sortie :

Starting session with SessionId: ec2-user-07a16060613c408b5

Pour plus d’informations, consultez Démarrer une session et Installer le plugin Session Manager pour l’AWS CLI dans le Guide de l’utilisateur AWS Systems Manager.

  • Pour les détails de l’API, consultez StartSession dans la Référence des commandes AWS CLI.

PowerShell
Outils pour PowerShell V4

Exemple 1 : cet exemple initie une connexion à une cible pour une session Session Manager, en activant la redirection de port.

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

Sortie :

SessionId StreamUrl ---------- ---------- random-id0 wss://ssmmessages.amazonaws.com/v1/data-channel/random-id
  • Pour plus de détails sur l’API, consultez StartSession dans la Référence des cmdlets Outils AWS pour PowerShell (V4).

Outils pour PowerShell V5

Exemple 1 : cet exemple initie une connexion à une cible pour une session Session Manager, en activant la redirection de port. Remarque : vous devez ajouter le paramètre Region s’il n’est pas déjà défini avec AWSCredentials.

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

Sortie :

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

Exemple 2 : cet exemple crée une session interactive avec une instance spécifiée pour une session Session Manager.

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

Sortie :

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>

Exemple 3 : cet exemple crée une session sans s’y connecter et renvoie les propriétés SessionId, StreamUrl et TokenValue requises pour se connecter à la session.

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

Sortie :

SessionId : testUser-xi4glew849asyeryde34u4dfsdfy StreamUrl : {StreamUrl value redacted} TokenValue : {Token value redacted} ContentLength : 1207 HttpStatusCode : OK
  • Pour plus de détails sur l’API, consultez StartSession dans la Référence des cmdlets Outils AWS pour PowerShell (V5).