

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

 **Description** 

Le `AWSSupport-RestoreEC2InstanceFromSnapshot` runbook vous aide à identifier et à restaurer une instance Amazon Elastic Compute Cloud (Amazon EC2) à partir d'un instantané Amazon Elastic Block Store (Amazon EBS) fonctionnel du volume racine.

[Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RestoreEC2InstanceFromSnapshot)

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

Linux, macOS, Windows

**Paramètres**
+ AutomationAssumeRole

  Type : String

  Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle Gestion des identités et des accès AWS (IAM) qui permet à Systems Manager Automation d'effectuer les actions en votre nom. Si aucun rôle n'est spécifié, Systems Manager Automation utilise les autorisations de l'utilisateur qui lance ce runbook.
+ EndDate

  Type : String

  Description : (Facultatif) Date à laquelle vous souhaitez que l'automatisation recherche un instantané.
+ InplaceSwap

  Type : booléen

  Valeurs valides : true \$1 false

  Description : (Facultatif) Si la valeur de ce paramètre est définie sur`true`, le volume nouvellement créé à partir de l'instantané remplace le volume racine existant attaché à votre instance.
+ InstanceId

  Type : String

  Description : (Obligatoire) L'ID de l'instance que vous souhaitez restaurer à partir d'un instantané.
+ LookForInstanceStatusCheck

  Type : booléen

  Valeurs valides : true \$1 false

  Valeur par défaut : true

  Description : (Facultatif) Si la valeur de ce paramètre est définie sur`true`, l'automatisation vérifie si les vérifications de l'état des instances échouent sur les instances de test lancées à partir des instantanés.
+ SkipSnapshotsBy

  Type : String

  Description : (Facultatif) Intervalle auquel les instantanés sont ignorés lorsque vous recherchez des instantanés pour restaurer votre instance. Par exemple, si 100 instantanés sont disponibles et que vous spécifiez une valeur de 2 pour ce paramètre, un instantané sur trois est examiné.

  Par défaut : 0
+ SnapshotId

  Type : String

  Description : (Facultatif) L'ID d'un instantané à partir duquel vous souhaitez restaurer l'instance.
+ StartDate

  Type : String

  Description : (Facultatif) Date à laquelle vous souhaitez que l'automatisation recherche un instantané pour la première fois.
+ TotalSnapshotsToLook

  Type : String

  Description : (Facultatif) Nombre de clichés examinés par l'automatisation.

**Autorisations IAM requises**

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
+ `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`

 **Étapes de document** 

1. `aws:executeAwsApi`- Recueille des informations sur l'instance cible.

1. `aws:assertAwsResourceProperty`- Vérifie que l'instance cible existe.

1. `aws:assertAwsResourceProperty`- Vérifie que le volume racine est un volume Amazon EBS.

1. `aws:assertAwsResourceProperty`- Vérifie qu'aucune autre automatisation ciblant cette instance n'est déjà en cours d'exécution.

1. `aws:executeAwsApi`- Marque l'instance cible.

1. `aws:executeAwsApi`- Crée un AMI de l'instance.

1. `aws:executeAwsApi`- Recueille des informations sur le AMI créé à l'étape précédente.

1. `aws:waitForAwsResourceProperty`- Attend le AMI état à devenir `available` avant de poursuivre.

1. `aws:executeScript`- Lance une nouvelle instance à partir de la nouvelle instance AMI.

1. `aws:assertAwsResourceProperty`- Vérifie que l'état de l'instance est`available`.

1. `aws:executeAwsApi`- Recueille des informations sur la nouvelle instance lancée.

1. `aws:branch`- Branches selon que vous avez fourni ou non une valeur pour le `SnapshotId` paramètre.

1. `aws:executeScript`- Renvoie une liste de clichés pendant la période spécifiée.

1. `aws:executeAwsApi`- Arrête l'instance.

1. `aws:waitForAwsResourceProperty`- Attend que l'état du volume soit atteint. `available`

1. `aws:waitForAwsResourceProperty`- Attend que l'état de l'instance soit atteint. `stopped`

1. `aws:executeAwsApi`- Détache le volume racine.

1. `aws:waitForAwsResourceProperty`- Attend que le volume racine soit détaché.

1. `aws:executeAwsApi`- Attache le nouveau volume racine.

1. `aws:waitForAwsResourceProperty`- Attend que le nouveau volume soit joint.

1. `aws:executeAwsApi`- Démarre l'instance.

1. `aws:waitForAwsResourceProperty`- Attend que l'état de l'instance soit atteint. `available`

1. `aws:waitForAwsResourceProperty`- Attend que les vérifications de l'état du système et de l'instance soient effectuées pour l'instance.

1. `aws:executeScript`- Exécute un script pour trouver un instantané pouvant être utilisé pour créer un volume avec succès.

1. `aws:executeScript`- Exécute un script pour récupérer l'instance en utilisant le volume nouvellement créé à partir de l'instantané identifié par l'automatisation, ou en utilisant le volume créé à partir de l'instantané que vous avez spécifié dans le `SnapshotId` paramètre.

1. `aws:executeScript`- Supprime les ressources créées par l'automatisation.

 **Sorties** 

launchCloneInstance.InstanceIds

ListSnapshotByDate. Instantanés finaux

ListSnapshotByDate.remainingSnapshotToBeCheckedInSameDateRange

findWorkingSnapshot. Instantané de travail

InstanceRecovery.résultat