

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

# `AWSSupport-RestoreEC2InstanceFromSnapshot`
<a name="automation-awssupport-restoreec2instancefromsnapshot"></a>

 **描述** 

该`AWSSupport-RestoreEC2InstanceFromSnapshot`运行手册可帮助您从亚马逊弹性区块存储 (Amazon EBS EC2) 根卷的有效快照中识别和恢复亚马逊弹性计算云 (Amazon) 实例。

[运行此自动化（控制台）](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RestoreEC2InstanceFromSnapshot)

**文档类型**

自动化

**所有者**

Amazon

**平台**

Linux，macOS, Windows

**参数**
+ AutomationAssumeRole

  类型：字符串

  描述：（可选）允许 Systems Manager Automation 代表您执行操作 AWS Identity and Access Management (IAM) 角色的 Amazon 资源名称（ARN）。如果未指定角色，Systems Manager Automation 将使用启动此运行手册的用户的权限。
+ EndDate

  类型：字符串

  描述：（可选）要自动化查看快照的最后日期。
+ InplaceSwap

  类型：布尔值

  有效值：true \$1 false

  描述：（可选）如果此参数的值设置为 `true`，则从快照中新创建的卷将替换附加到您的实例的现有根卷。
+ InstanceId

  类型：字符串

  说明：（必需）要从快照复原的实例的 ID。
+ LookForInstanceStatusCheck

  类型：布尔值

  有效值：true \$1 false

  默认：True

  描述：（可选）如果此参数的值设置为 `true`，则自动化将检查从快照启动的测试实例的实例状态检查是否失败。
+ SkipSnapshotsBy

  类型：字符串

  描述：（可选）搜索快照以恢复实例时跳过快照的时间间隔。例如，如果有 100 个快照可用，且您为此参数指定的值为 2，则每三张快照就会被审查一次。

  默认：0
+ SnapshotId

  类型：字符串

  描述：（可选）要从中复原实例的快照的 ID。
+ StartDate

  类型：字符串

  描述：（可选）要自动化查看快照的最早日期。
+ TotalSnapshotsToLook

  类型：字符串

  描述：（可选）自动化审查的快照数。

**所需的 IAM 权限**

`AutomationAssumeRole` 参数需要执行以下操作才能成功使用运行手册。
+ `ssm:StartAutomationExecution`
+ `ssm:GetAutomationExecution`
+ `ssm:DescribeInstanceInformation`
+ `ec2:AttachVolume`
+ `ec2:CreateImage`
+ `ec2:CreateTags`
+ `ec2:CreateVolume`
+ `ec2:DeleteTags`
+ `ec2:DeregisterImage`
+ `ec2:DescribeInstances`
+ `ec2:DescribeInstanceStatus`
+ `ec2:DescribeImages`
+ `ec2:DescribeSnapshots`
+ `ec2:DescribeVolumes`
+ `ec2:DetachVolume`
+ `ec2:RunInstances`
+ `ec2:StartInstances`
+ `ec2:StopInstances`
+ `ec2:TerminateInstances`
+ `cloudwatch:GetMetricData`

 **文档步骤** 

1. `aws:executeAwsApi` - 收集有关目标实例的详细信息。

1. `aws:assertAwsResourceProperty` - 验证目标实例是否存在。

1. `aws:assertAwsResourceProperty` - 验证根卷是否为 Amazon EBS 卷。

1. `aws:assertAwsResourceProperty` - 验证另一个针对此实例的自动化是否尚未运行。

1. `aws:executeAwsApi` - 标记目标实例。

1. `aws:executeAwsApi`-创建一个 AMI 实例的。

1. `aws:executeAwsApi`-收集有关以下内容的详细信息 AMI 在上一步中创建。

1. `aws:waitForAwsResourceProperty`-等着 AMI `available`在继续操作之前先要变成。

1. `aws:executeScript`-从新创建的实例启动新实例 AMI.

1. `aws:assertAwsResourceProperty` - 验证实例状态为 `available`。

1. `aws:executeAwsApi` - 收集有关新启动实例的详细信息。

1. `aws:branch` - 根据您是否为 `SnapshotId` 参数提供了值进行分支。

1. `aws:executeScript` - 返回指定时间段内快照的列表。

1. `aws:executeAwsApi` - 停止实例。

1. `aws:waitForAwsResourceProperty` - 等待卷状态处于 `available`。

1. `aws:waitForAwsResourceProperty` - 等待实例状态处于 `stopped`。

1. `aws:executeAwsApi` - 分离根卷。

1. `aws:waitForAwsResourceProperty` - 等待根卷被分离。

1. `aws:executeAwsApi` - 附加新的根卷。

1. `aws:waitForAwsResourceProperty` - 等待新卷被附加。

1. `aws:executeAwsApi` - 启动实例。

1. `aws:waitForAwsResourceProperty` - 等待实例状态处于 `available`。

1. `aws:waitForAwsResourceProperty` - 等待通过实例的系统和实例状态检查。

1. `aws:executeScript` - 运行脚本以查找可用于成功创建卷的快照。

1. `aws:executeScript` - 运行脚本，以使用根据自动化识别的快照新创建的卷，或使用根据您在 `SnapshotId` 参数中指定的快照创建的卷来恢复实例。

1. `aws:executeScript` - 删除此自动化创建的资源。

 **输出** 

launchCloneInstance.InstanceIds

ListSnapshotByDate.finalSnapsh

ListSnapshotByDate.remainingSnapshotToBeCheckedInSameDateRange

findWorkingSnapshot. 工作快照

InstanceRecovery。结果