AWS Systems Manager
用户指南
AWS 文档中描述的 AWS 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅中国的 AWS 服务入门

排除 Session Manager的故障

使用以下信息来帮助解决与 Session Manager 相关的问题。

没有启动会话的权限

问题:您尝试启动会话,但系统提示您没有必要的权限。

没有更改会话首选项的权限

问题:您尝试更新组织的全局会话首选项,但系统提示您没有必要的权限。

实例不可用或未配置为使用 Session Manager

问题 1:您需要在 Start a session (启动会话) 控制台页面上启动一个会话,但实例不在列表中。

  • 解决方案:要连接到的实例可能尚未配置为配合 AWS Systems Manager 服务使用。要使某个实例可以使用 Systems Manager,必须向该实例附加一个 IAM 实例配置文件,以便为 Systems Manager 提供对实例执行操作的权限。有关信息,请参阅为 Systems Manager 创建 IAM 实例配置文件

    注意

    如果在附加 IAM 实例配置文件时实例上已经在运行 SSM 代理,则在 Start a session (启动会话) 控制台页面上列出该实例之前,可能需要重新启动代理。

问题 2Start a session (启动会话) 控制台页面的列表中显示了要连接的实例,但页面报告“The instance you selected is not configured to use Session Manager”(您选择的实例未配置为使用 Session Manager)。

Session Manager Plugin 未找到

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.

Session Manager Plugin未自动添加到命令行路径 (Windows)

在 Windows 上安装 Session Manager plugin时,session-manager-plugin 可执行文件应自动添加到操作系统的 PATH 环境变量中。如果在运行检查是否正确安装了 Session Manager plugin的命令后命令失败 (aws ssm start-session --target instance-id),则需要使用以下过程手动设置它。

修改您的 PATH 变量 (Windows)

  1. 按 Windows 键并输入 environment variables

  2. 选择 Edit environment variables for your account

  3. 选择 PATH,然后选择 Edit

  4. Variable value 字段添加路径,中间用分号隔开。例如:C:\existing\path;C:\new\path

    C:\existing\path 表示字段中已有的值。C:\new\path 表示要添加的路径。例如:

    • 64 位计算机C:\Program Files\Amazon\SessionManagerPlugin\bin\

    • 32 位计算机C:\Program Files (x86)\Amazon\SessionManagerPlugin\bin\

  5. 选择 OK 两次以应用新设置。

  6. 关闭任何运行的命令提示符并重新打开。