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

AWSSupport-ExecuteEC2Rescue

描述

此文档使用 EC2Rescue 工具进行故障排除,并尽可能修复指定 EC2 实例(Windows 或 Linux)的常见连接问题。

文档类型

Automation

所有者

Amazon

平台

Windows、Linux

参数

  • UnreachableInstanceId

    类型:字符串

    说明:(必需)您的无法访问的 EC2 实例的 ID。重要说明:AWS Systems Manager Automation 会停止此实例,并在尝试任何操作前创建一个 AMI。存储在实例存储卷中的数据将丢失。如果不使用弹性 IP,则公有 IP 地址将发生更改。

  • SubnetId

    类型:字符串

    默认值:CreateNewVPC

    说明:(可选)EC2Rescue 实例的子网 ID。默认情况下,AWS Systems Manager Automation 会创建一个新 VPC。或者,您也可以使用 SelectedInstanceSubnet 来使用实例所在的子网,或指定一个自定义的子网 ID。重要说明:子网必须与 UnreachableInstanceId 位于同一可用区中,并且必须允许访问 SSM 终端节点。

  • EC2RescueInstanceType

    类型:字符串

    允许的值:t2.small、t2.medium、t2.large

    默认值:t2.small

    说明:(必需)EC2Rescue 实例的 EC2 实例类型。建议大小:t2.small。

  • LogDestination

    类型:字符串

    说明:(可选)您账户中用于上传故障排除日志的 S3 存储桶的名称。请确保存储桶策略不会向不需要访问收集的日志的各方授予不必要的读/写权限。

  • AssumeRole

    类型:字符串

    说明:(可选)此执行的 IAM 角色。如果未指定任何角色,AWS Systems Manager Automation 将使用您的 IAM 权限运行此文档。

示例

对实例执行 EC2Rescue

aws ssm start-automation-execution --document-name AWSSupport-ExecuteEC2Rescue --parameters 'UnreachableInstanceId=INSTANCEID'

对实例执行 EC2Rescue,为 EC2Rescue 实例使用当前实例子网

aws ssm start-automation-execution --document-name AWSSupport-ExecuteEC2Rescue --parameters 'UnreachableInstanceId=INSTANCEID,SubnetId=SelectedInstanceSubnet'

对实例执行 EC2Rescue,为 EC2Rescue 实例使用自定义子网

aws ssm start-automation-execution --document-name AWSSupport-ExecuteEC2Rescue --parameters 'UnreachableInstanceId=INSTANCEID,SubnetId=SUBNETID'

检索执行输出

aws ssm get-automation-execution --automation-execution-id EXECUTIONID --output text --query 'AutomationExecution.Output'

所需的 IAM 权限

您必须至少具有 ssm:ExecuteAutomationssm:GetAutomationExecution 才能读取 Automation 输出。有关所需权限的更多信息,请参阅 AWSSupport-StartEC2RescueWorkflow

文档步骤

  1. aws:assertAwsResourceProperty - 断言提供的实例为 Windows

    1. (EC2Rescue for Windows) 如果提供的实例是 Windows:

      1. aws:executeAutomation - 使用 EC2Rescue for Windows 离线脚本调用 AWSSupport-StartEC2RescueWorkflow

      2. aws:executeAwsApi - 从嵌套的 Automation 检索备份 AMI ID

      3. aws:executeAwsApi - 从嵌套的 Automation 检索 EC2Rescue 摘要

    2. (EC2Rescue for Linux) 如果提供的实例是 Linux:

      1. aws:executeAutomation - 使用 EC2Rescue for Linux 离线脚本调用 AWSSupport-StartEC2RescueWorkflow

      2. aws:executeAwsApi - 从嵌套的 Automation 检索备份 AMI ID

      3. aws:executeAwsApi - 从嵌套的 Automation 检索 EC2Rescue 摘要

输出

getEC2RescueForWindowsResult.Output

getWindowsBackupAmi.ImageId

getEC2RescueForLinuxResult.Output

getLinuxBackupAmi.ImageId