AWSSupport-RestoreEC2InstanceFromSnapshot - AWS Systems Manager Référence du manuel d'automatisation

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

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écutez cette automatisation (console)

Type de document

 Automatisation

Propriétaire

Amazon

Plateformes

LinuxmacOS, Windows

Paramètres

  • AutomationAssumeRole

    Type : String

    Description : (Facultatif) Le nom de ressource Amazon (ARN) du rôle AWS Identity and Access Management (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 démarre ce runbook.

  • EndDate

    Type : String

    Description : (Facultatif) La dernière date à laquelle vous souhaitez que l'automatisation recherche un instantané.

  • InplaceSwap

    Type : booléen

    Valeurs valides : true | false

    Description : (Facultatif) Si la valeur de ce paramètre est définie surtrue, le volume nouvellement créé à partir du snapshot 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 | false

    Valeur par défaut : true

    Description : (Facultatif) Si la valeur de ce paramètre est définie surtrue, 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) La première date à laquelle vous souhaitez que l'automatisation recherche un instantané.

  • TotalSnapshotsToLook

    Type : String

    Description : (Facultatif) Nombre d'instantané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.

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

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

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

  5. aws:executeAwsApi- Marque l'instance cible.

  6. aws:executeAwsApi- Crée une AMI de l'instance.

  7. aws:executeAwsApi- Recueille des détails sur ce qui AMI a été créé à l'étape précédente.

  8. aws:waitForAwsResourceProperty- Attend que l'AMIÉtat le devienne available avant de continuer.

  9. aws:executeScript- Lance une nouvelle instance à partir de celle qui vient d'être crééeAMI.

  10. aws:assertAwsResourceProperty- Vérifie que l'état de l'instance estavailable.

  11. aws:executeAwsApi- Recueille des informations sur l'instance récemment lancée.

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

  13. aws:executeScript- Renvoie une liste d'instantanés au cours de la période spécifiée.

  14. aws:executeAwsApi- Arrête l'instance.

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

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

  17. aws:executeAwsApi- Détache le volume racine.

  18. aws:waitForAwsResourceProperty- Attend que le volume racinaire se détache.

  19. aws:executeAwsApi- Attache le nouveau volume de racine.

  20. aws:waitForAwsResourceProperty- Attend que le nouveau volume soit attaché.

  21. aws:executeAwsApi- Démarre l'instance.

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

  23. aws:waitForAwsResourceProperty- Attend que les contrôles d'état du système et de l'instance soient réussis pour l'instance.

  24. aws:executeScript- Exécute un script pour trouver un instantané qui peut être utilisé pour créer un volume avec succès.

  25. 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.

  26. 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