• n' AWS Systems ManagerChange Managerest plus ouvert aux nouveaux clients. Les clients existants peuvent continuer à utiliser le service normalement. Pour plus d'informations, consultez AWS Systems ManagerChange Managerla section Modification de la disponibilité.
• Le AWS Systems Manager CloudWatch tableau de bord ne sera plus disponible après le 30 avril 2026. Les clients peuvent continuer à utiliser CloudWatch la console Amazon pour consulter, créer et gérer leurs CloudWatch tableaux de bord Amazon, comme ils le font aujourd'hui. Pour plus d'informations, consultez la documentation Amazon CloudWatch Dashboard.
Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.
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 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 : pour démarrer une session Session Manager en utilisant SSH
Cet exemple 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 plug-in Session Manager pour la AWS CLI dans le Guide de l'utilisateur de AWS Systems Manager.
- 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
- 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 à l'aide de 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 TokenValue propriétés SessionId StreamUrl, et 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 obtenir la liste complète des guides de développement du AWS SDK et des exemples de code, consultezUtilisation de ce service avec un AWS SDK. Cette rubrique comprend également des informations sur le démarrage et sur les versions précédentes du kit SDK.