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-07a16060613c408b5Exemple 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 exempleec2-userpour les instances EC2 pour Linux.ssh -i /path/my-key-pair.pem ec2-user@i-02573cafcfEXAMPLESortie :
Starting session with SessionId: ec2-user-07a16060613c408b5Pour 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' -DisablePluginInvocationSortie :
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).
-