AWSSupport-RestoreEC2InstanceFromSnapshot - AWS Systems Manager 自动化运行手册参考

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

AWSSupport-RestoreEC2InstanceFromSnapshot

描述

AWSSupport-RestoreEC2InstanceFromSnapshot 运行手册可帮助您识别 Amazon Elastic Compute Cloud (Amazon EC2) 实例,并将其从根卷的有效Amazon Elastic Block Store (Amazon EBS) 快照中恢复。

运行此自动化(控制台)

文档类型

自动化

所有者

Amazon

平台

Linux、macOS、Windows

参数

  • AutomationAssumeRole

    类型:字符串

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

  • EndDate

    类型:字符串

    描述:(可选)要自动化查看快照的最后日期。

  • InplaceSwap

    类型:布尔值

    有效值:true | false

    描述:(可选)如果此参数的值设置为 true,则从快照中新创建的卷将替换附加到您的实例的现有根卷。

  • InstanceId

    类型:字符串

    说明:(必需)要从快照复原的实例的 ID。

  • LookForInstanceStatusCheck

    类型:布尔值

    有效值:true | 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 - 收集有关目标实例的详细信息。

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

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

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

  5. aws:executeAwsApi - 标记目标实例。

  6. aws:executeAwsApi - 创建实例的 AMI。

  7. aws:executeAwsApi - 收集有关在上一步创建的 AMI 的详细信息。

  8. aws:waitForAwsResourceProperty - 等待 AMI 状态变为 available 后再继续。

  9. aws:executeScript - 从新创建的实例 AMI 启动一个新实例。

  10. aws:assertAwsResourceProperty - 验证实例状态为 available

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

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

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

  14. aws:executeAwsApi - 停止实例。

  15. aws:waitForAwsResourceProperty - 等待卷状态处于 available

  16. aws:waitForAwsResourceProperty - 等待实例状态处于 stopped

  17. aws:executeAwsApi - 分离根卷。

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

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

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

  21. aws:executeAwsApi - 启动实例。

  22. aws:waitForAwsResourceProperty - 等待实例状态处于 available

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

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

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

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

输出

launchCloneInstance.InstanceIds

ListSnapshotByDate.finalSnapshots

ListSnapshotByDate.remainingSnapshotToBeCheckedInSameDateRange

findWorkingSnapshot.workingSnapshot

InstanceRecovery.result