AWS Systems Manager
ユーザーガイド

セッションを開始する

AWS Systems Manager コンソール、AWS CLI、または SSH を使用してセッションを開始できます。

セッションの開始 (コンソール)

AWS Systems Manager コンソールを使用して、アカウント内のインスタンスとのセッションを開始できます。

セッションを開始するには (コンソール)

  1. https://console.aws.amazon.com/systems-manager/ で AWS Systems Manager コンソールを開きます。

  2. ナビゲーションペインで [Session Manager] を選択します。

    -または-

    AWS Systems Manager ホームページが最初に開く場合は、メニューアイコン ( ) を選択してナビゲーションペインを開き、ナビゲーションペインの [Session Manager] を選択します。

  3. [Start session (セッションの開始)] を選択します。

  4. [Target instances (ターゲットインスタンス)] で、接続先のインスタンスの左側にあるオプションボタンを選択します。

    接続先のインスタンスがリストにないか、リストに表示されているものの「選択したインスタンスは Session Manager を使用するように構成されていません」というエラーメッセージが表示される場合は、「インスタンスが使用できないか、Session Manager 用に構成されていません」にあるトラブルシューティングの手順を参照してください。

  5. [Start session (セッションの開始)] を選択します。

接続が確立されたら、他の接続タイプと同様に、bash コマンド (Linux) または PowerShell コマンド (Windows) を実行できます。

セッションの開始 (AWS CLI)

AWS CLI を使用してセッションを開始するには、次のコマンドを実行します。

注記

To use the AWS CLI to run session commands, the Session Manager plugin must also be installed on your local machine. For information, see (オプション) AWS CLI 用の Session Manager Plugin をインストールする.

aws ssm start-session --target instance-id

instance-id は、AWS Systems Manager で使用するように設定されたインスタンスの ID と Session Manager の機能を表しています (i-02573cafcfEXAMPLE など)。

start-session コマンドで使用できるその他のオプションについては、AWS Systems Manager section of the AWS CLI Command Reference の「start-session」を参照してください。

セッションの開始 (SSH)

SSH を使用してセッションを開始するには、次のコマンドを実行します。

注記

SSH を使用してセッションを開始するには、SSH 接続をサポートするようにターゲットインスタンスを構成する必要があります。詳細については、「(オプション) Session Managerを通して SSH 接続を有効にする」を参照してください。

ssh -i /path/my-key-pair.pem username@instance-id

/path/my-key-pair.pem は、インスタンスに関連付けられている Enhanced Mail(PEM)証明書のパスを表します。たとえば、Amazon EC2 インスタンスの場合、インスタンスを作成したときに作成または選択したキーペアファイル。

username@instance-id は、インスタンスへの接続に使用するユーザー名とインスタンス ID を表します (JaneDoe@i-02573cafcfEXAMPLE など)。

ヒント

SSH を使用してセッションを開始する際、次のコマンド形式を使用して、ローカルファイルをターゲットインスタンスにコピーできます。

scp -i /path/my-key-pair.pem /path/SampleFile.txt username@instance-id:~

start-session コマンドで使用できるその他のオプションについては、AWS Systems Manager section of the AWS CLI Command Reference の「start-session」を参照してください。

セッションの開始 (ポート転送)

ポート転送セッションを開始するには、CLI から次のコマンドを実行します。

注記

AWS CLI を使用してセッションコマンドを実行するには、ローカルマシンにも Session Manager plugin がインストールされている必要があります。詳細については、(オプション) AWS CLI 用の Session Manager Plugin をインストールする を参照してください。

aws ssm start-session --target instance-id --document-name AWS-StartPortForwardingSession --parameters '{"portNumber":["80"], "localPortNumber":["56789"]}'

instance-id は、AWS Systems Manager で使用するように設定されたインスタンスの ID と Session Manager の機能を表しています (i-02573cafcfEXAMPLE など)。

portNumber は、トラフィックのリダイレクト先となるインスタンスのリモートポートを表します (3389 など)。このパラメータを指定しない場合、Session Manager はデフォルトのリモートポートとして 80 を想定します。

localPortNumber は、トラフィックのリダイレクト先となるクライアントのローカルポートを表します (56789 など)。

start-session コマンドで使用できるその他のオプションについては、AWS Systems Manager section of the AWS CLI Command Reference の「start-session」を参照してください。

セッションの開始 (インタラクティブコマンド)

インタラクティブコマンドセッションを開始するには、次のコマンドを実行します。

注記

AWS CLI を使用してセッションコマンドを実行するには、ローカルマシンにも Session Manager plugin がインストールされている必要があります。詳細については、(オプション) AWS CLI 用の Session Manager Plugin をインストールする を参照してください。

aws ssm start-session --target instance-id --document-name CustomCommandSessionDocument --parameters '{"logpath":["/var/log/amazon/ssm/amazon-ssm-agent.log"]}'

instance-id は、AWS Systems Manager で使用するように設定されたインスタンスの ID と Session Manager の機能を表しています (i-02573cafcfEXAMPLE など)。

start-session コマンドで使用できるその他のオプションについては、AWS Systems Manager section of the AWS CLI Command Reference の「start-session」を参照してください。

関連情報

AWS ニュースブログAWS Systems Manager セッションマネージャーを使用したポート転送