Utilizar StartSession con una CLI - AWS Systems Manager

Utilizar StartSession con una CLI

En los siguientes ejemplos de código, se muestra 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: para 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

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 AWS Tools for PowerShell.

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