将 StartSession 与 CLI 配合使用 - AWS SDK 代码示例

文档 AWS SDK 示例 GitHub 存储库中还有更多 S AWS DK 示例

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

StartSession 与 CLI 配合使用

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

CLI
AWS CLI

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

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

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

输出:

Starting session with SessionId: Jane-Roe-07a16060613c408b5

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

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

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

输出:

Starting session with SessionId: ec2-user-07a16060613c408b5

有关更多信息,请参阅 Syst AWS em s Manager 用户指南中的启动会话并安装 AWS CLI 的会话管理器插件

  • 有关 API 的详细信息,请参阅AWS CLI 命令参考StartSession中的。

PowerShell
适用于 PowerShell V4 的工具

示例 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 的详细信息,请参阅 AWS Tools for PowerShell Cmdlet 参考 (V 4) StartSession中的。

适用于 PowerShell V5 的工具

示例 1:此示例为会话管理器会话启动与目标的连接,从而启用端口转发。注意:如果尚未使用进行设置,则需要添加区域参数 AWSCredentials。

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

输出

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

示例 2:此示例为会话管理器会话创建与指定实例的交互式会话。

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

输出

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>

示例 3:此示例创建了一个未连接到该会话的会话 SessionId StreamUrl,并返回连接到该会话所需的、和 TokenValue 属性。

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

输出

SessionId : testUser-xi4glew849asyeryde34u4dfsdfy StreamUrl : {StreamUrl value redacted} TokenValue : {Token value redacted} ContentLength : 1207 HttpStatusCode : OK
  • 有关 API 的详细信息,请参阅 AWS Tools for PowerShell Cmdlet 参考 (V 5) StartSession中的。