将 StartSession 与 Amazon SDK 或 CLI 配合使用 - Amazon Systems Manager
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)

StartSession 与 Amazon SDK 或 CLI 配合使用

以下代码示例演示如何使用 StartSession

CLI
Amazon CLI

示例 1:启动会话管理器会话

start-session 示例为会话管理器会话建立与实例的连接。请注意,此交互式命令要求在进行调用的客户端计算机上安装会话管理器插件。

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

输出:

Starting session with SessionId: Jane-Roe-07a16060613c408b5

示例 2:使用 SSH 启动会话管理器会话

start-session 示例为使用 SSH 的会话管理器会话建立与实例的连接。请注意,此交互式命令要求在进行调用的客户端计算机上安装会话管理器插件,并且该命令在实例上使用默认用户,例如为 Linux 的 EC2 实例使用 ec2-user

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

输出:

Starting session with SessionId: ec2-user-07a16060613c408b5

有关更多信息,请参阅《Amazon Systems Manager 用户指南》中的启动会话为 Amazon CLI 安装会话管理器插件

  • 有关 API 详细信息,请参阅《Amazon CLI 命令参考》中的 StartSession

PowerShell
适用于 PowerShell 的工具

示例 1:此示例为会话管理器会话启动与目标的连接,从而启用端口转发。

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

输出:

SessionId StreamUrl ---------- ---------- random-id0 wss://ssmmessages.amazonaws.com/v1/data-channel/random-id
  • 有关 API 详细信息,请参阅《Amazon Tools for PowerShell Cmdlet 参考》中的 StartSession

有关 Amazon SDK 开发人员指南和代码示例的完整列表,请参阅 将 Systems Manager 与 Amazon SDK 配合使用。本主题还包括有关入门的信息以及有关先前的 SDK 版本的详细信息。