Utilizar StartSession con una CLI

Los siguientes ejemplos de código muestran cómo utilizar StartSession.

CLI

AWS CLI

Ejemplo 1: para iniciar una sesión de Session Manager

Este ejemplo de start-session establece una conexión a una instancia para una sesión de Session Manager. Tenga en cuenta que este comando interactivo requiere que el complemento Session Manager esté instalado en la máquina cliente que realiza la llamada.

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

Salida:

Starting session with SessionId: Jane-Roe-07a16060613c408b5

Ejemplo 2: iniciar una sesión de Session Manager mediante SSH

Este ejemplo de start-session establece una conexión a una instancia para una sesión de Session Manager mediante SSH. Tenga en cuenta que este comando interactivo requiere que el complemento Session Manager esté instalado en la máquina cliente que realiza la llamada y que el comando use el usuario predeterminado de la instancia, como ec2-user en el caso de las instancias EC2 para Linux.

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

Salida:

Starting session with SessionId: ec2-user-07a16060613c408b5

Para obtener más información, consulte Iniciar una sesión e Instalar el complemento Session Manager para la CLI de AWS en la Guía del usuario de AWS.

• Para obtener más información sobre la API, consulte StartSession en la Referencia de comandos de la AWS CLI.

PowerShell

Herramientas para PowerShell V4

Ejemplo 1: este ejemplo inicia una conexión a un destino para una sesión de Session Manager, lo que habilita el reenvío de puertos.

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

Salida:

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

• Para obtener información sobre la API, consulte StartSession en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V4).

Herramientas para PowerShell V5

Ejemplo 1: este ejemplo inicia una conexión a un destino para una sesión de Session Manager, lo que habilita el reenvío de puertos. Nota: Debe agregar el parámetro Region si aún no lo ha establecido con AWSCredentials.

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

Salida:

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

Ejemplo 2: este ejemplo crea una sesión interactiva con una instancia específica para una sesión del Session Manager.

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

Salida:

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>

Ejemplo 3: este ejemplo crea una sesión sin conectarse a ella y devuelve las propiedades SessionId, StreamUrl y TokenValue necesarias para conectarse a la sesión.

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

Salida:

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

• Para obtener información sobre la API, consulte StartSession en la Referencia de Cmdlet de las Herramientas de AWS para PowerShell (V5).

Para obtener una lista completa de las guías para desarrolladores de AWS SDK y ejemplos de código, consulte Cómo utilizar este servicio con un AWS SDK. En este tema también se incluye información sobre cómo comenzar a utilizar el SDK y detalles sobre sus versiones anteriores.