

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-RecoverWorkSpaceWithApproval`
<a name="automation-aws-recoverworkspacewithapproval"></a>

Le `AWSSupport-RecoverWorkSpaceWithApproval` runbook exécute les étapes de restauration sur l'instance Amazon WorkSpaces (WorkSpaces) dont vous spécifiez l'état de fonctionnement. `Unhealthy` En fonction des valeurs que vous spécifiez pour les paramètres d'entrée et les instantanés disponibles, le runbook redémarre, restaure et reconstruit le fichier WorkSpaces jusqu'à ce que son état soit rétabli. `Available` Ce runbook utilise l'action `aws:approve` d'automatisation, qui suspend temporairement l'automatisation jusqu'à ce que les responsables désignés approuvent ou refusent les actions de restauration sélectionnées.

**Important**  
La restauration ou la reconstruction d'un WorkSpace est une action potentiellement destructrice qui peut entraîner la perte de données. Cela est dû au fait que les WorkSpace données sont restaurées à partir du dernier instantané disponible et que les données récupérées à partir des instantanés peuvent dater de 12 heures.  
L'option de restauration recrée à la fois le volume racine et le volume utilisateur en fonction des instantanés les plus récents. L'option de reconstruction recrée le volume utilisateur à partir de l'instantané le plus récent et le recrée WorkSpace à partir de l'image associée au bundle à partir duquel WorkSpace il a été créé. Les applications installées ou les paramètres système modifiés après leur WorkSpace création sont perdus. Pour plus d'informations sur la restauration et la reconstruction WorkSpaces, consultez [Restore a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) et [Rebuild a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html) dans le *Guide d' WorkSpaces administration Amazon*.

Avant d'utiliser ce runbook, nous vous recommandons de consulter la rubrique [Résolution WorkSpaces des problèmes liés à Amazon](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html) dans le Guide d' WorkSpaces administration Amazon.

Le runbook exécute les actions de restauration suivantes dans l'ordre, en s'arrêtant dès qu' WorkSpaces il atteint un `Available` état :
+ Récupère l'état initial du WorkSpaces et confirme qu'il est dans un état récupérable (`Unhealthy`,, `Error` `Impaired``Stopped`, ou). `Available`
+ Si WorkSpaces c'est le cas`Stopped`, démarrez-le et attendez le résultat.
+ Récupère les instantanés de reconstruction et de restauration disponibles pour le. WorkSpaces
+ Envoie une notification d'approbation via Amazon Simple Notification Service (Amazon SNS) aux approbateurs désignés et fait une pause jusqu'à ce qu'elle soit approuvée ou refusée.
+ S'il `Reboot` est approuvé et défini sur`Yes`, redémarre le WorkSpaces et attend le résultat.
+ Si ce n' WorkSpaces est toujours pas le cas `Available` et qu'`Restore`il est défini sur`Yes`, restaure le WorkSpaces instantané le plus récent et attend le résultat.
+ Si ce n' WorkSpaces est toujours pas le cas `Available` et `Rebuild` qu'il est défini sur`Yes`, reconstruit l'image du bundle WorkSpaces à partir de l'image du bundle la plus récente et attend le résultat.
+ Confirme l'état final du WorkSpaces is`Available`.

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

**Type de document**

 Automatisation

**Propriétaire**

Amazon

**Plateformes**

/

**Autorisations IAM requises**

Le `AutomationAssumeRole` paramètre nécessite les actions suivantes pour utiliser correctement le runbook.
+ `sns:Publish`
+ `workspaces:DescribeWorkspaces`
+ `workspaces:DescribeWorkspaceSnapshots`
+ `workspaces:RebootWorkspaces`
+ `workspaces:RebuildWorkspaces`
+ `workspaces:RestoreWorkspace`
+ `workspaces:StartWorkspaces`

Exemple de politique IAM :

```
{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "workspaces:DescribeWorkspaces",
                "workspaces:DescribeWorkspaceSnapshots",
                "workspaces:RebootWorkspaces",
                "workspaces:RebuildWorkspaces",
                "workspaces:RestoreWorkspace",
                "workspaces:StartWorkspaces"
            ],
            "Resource": "*"
        },
        {
            "Effect": "Allow",
            "Action": "sns:Publish",
            "Resource": "arn:aws:sns:*:*:Automation*"
        }
    ]
}
```

Pour configurer l'automatisation, procédez comme suit :

1. Ouvrez [AWSSupport-RecoverWorkSpaceWithApproval](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RecoverWorkSpaceWithApproval/description)dans Systems Manager sous Documents.

1. Choisissez Execute automation (Exécuter l’automatisation).

1. Pour les paramètres d'entrée, entrez ce qui suit :
   + **AutomationAssumeRole (Facultatif) :**

     L'ARN du rôle 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. Type :`AWS::IAM::Role::Arn`.
   + **WorkspaceId (Obligatoire) :**

     L'ID du WorkSpaces à récupérer. Doit correspondre au schéma`^ws-[0-9a-z]{8,63}$`. Type :`String`.
   + **Redémarrage (facultatif) :**

     Réglez `Yes` sur pour WorkSpaces permettre le redémarrage du. Valeur par défaut : `Yes`. Valeurs autorisées : `Yes` \|`No`. Type :`String`.
   + **Restaurer (facultatif) :**

     Réglez `Yes` sur pour WorkSpaces permettre la restauration. Le système est restauré sur l'instantané le plus récent du volume racine. Toutes les applications installées ou les paramètres système modifiés après la création du dernier instantané sont perdus. Le volume utilisateur est recréé à partir de l'instantané le plus récent et son contenu actuel est remplacé. Valeur par défaut : `No`. Valeurs autorisées : `Yes` \|`No`. Type :`String`.
   + **Reconstruire (facultatif) :**

     Réglez `Yes` sur pour WorkSpaces permettre la reconstruction. Le système est actualisé avec l'image la plus récente du bundle à partir duquel il WorkSpaces a été créé. Toutes les applications installées ou les paramètres système modifiés après WorkSpaces leur création sont perdus. Le volume utilisateur est recréé à partir de l'instantané le plus récent et son contenu actuel est remplacé. Valeur par défaut : `No`. Valeurs autorisées : `Yes` \|`No`. Type :`String`.
   + **Confirmez (obligatoire) :**

     Entrez `Yes` pour confirmer que les actions de restauration et de reconstruction permettent de récupérer les données WorkSpaces à partir de l'instantané le plus récent et que les données restaurées à partir d'instantanés peuvent dater de 12 heures. Modèle autorisé :`^[Yy][Ee][Ss]$`. Type :`String`.
   + **Approbateurs (obligatoire) :**

     Liste des noms d'utilisateur ou ARN IAM des approbateurs pour l'action d'automatisation. Vous pouvez spécifier des principes sous forme de nom d'utilisateur IAM, d'ARN d'utilisateur IAM, d'ARN de rôle IAM ou d'ARN d'utilisateur de rôle IAM. Minimum : 1, maximum : 10. Type :`StringList`.
   + **MinRequiredApprovals (Facultatif) :**

     Le nombre minimum d'approbations requises pour reprendre l'exécution de l'automatisation. La valeur ne peut pas dépasser le nombre d'approbateurs défini par le `Approvers` paramètre. Valeur par défaut : `1`. Valeurs autorisées : `1` —`10`. Type :`Integer`.
   + **SNSTopicArn (Obligatoire) :**

     L'ARN de la rubrique Amazon SNS utilisé pour envoyer la notification d'approbation en attente. Le nom de la rubrique Amazon SNS doit être préfixé par. `Automation` Type :`String`.

1. Sélectionnez Execute (Exécuter).

1. L'automatisation démarre.

1. Le document exécute les étapes suivantes :
   + **`getWorkSpaceInitialState`**: Récupère l'état actuel du WorkSpaces.
   + **`assertWorkSpaceInitialState`**: confirme que l'état WorkSpaces est récupérable (`Available`,, `Error` `Stopped``Unhealthy`, ou`Impaired`). L'automatisation prend fin s' WorkSpaces il est dans un autre état.
   + **`branchOnWorkSpaceInitialState`**: Branches basées sur l' WorkSpaces état initial. Si`Stopped`, continue à démarrer le WorkSpaces. If `Unhealthy``Error`, or`Impaired`, procède à la récupération des instantanés.
   + **`startWorkSpace`**: démarre le WorkSpaces s'il était dans un `Stopped` état.
   + **`waitForStartWorkSpace`**: Attend jusqu'à 10 minutes WorkSpaces pour que le `Starting` statut atteigne.
   + **`waitForStartWorkSpaceResult`**: Attend jusqu'à 30 minutes jusqu' WorkSpaces à ce que le `Available` statut atteigne `Unhealthy``Error`,`Impaired`, ou après le démarrage.
   + **`getWorkSpaceStateAfterStart`**: Récupère l' WorkSpaces état après la tentative de démarrage.
   + **`branchOnWorkSpaceStateAfterStart`**: Si WorkSpaces c'est le cas`Available`, passe à l'assertion finale. Sinon, procédez à la récupération des instantanés.
   + **`getWorkSpaceSnapshots`**: Récupère les instantanés de reconstruction et de restauration disponibles pour le. WorkSpaces
   + **`approval`**: envoie une notification d'approbation à la rubrique Amazon SNS spécifiée et suspend l'automatisation pendant 24 heures au maximum, en attendant que les approbateurs désignés approuvent ou refusent les actions de restauration.
   + **`branchOnRebootAllowed`**: Si `Reboot` ce paramètre est défini sur`Yes`, redémarre le WorkSpaces. Sinon, passez à la branche de restauration.
   + **`rebootWorkSpace`**: Redémarre le. WorkSpaces
   + **`waitForRebootWorkSpace`**: Attend jusqu'à 10 minutes WorkSpaces pour que le `Rebooting` statut atteigne.
   + **`waitForRebootWorkSpaceResult`**: attend jusqu'à 30 minutes que le statut WorkSpaces atteigne ou atteigne `Unhealthy` `Error` le `Available` statut après le redémarrage.
   + **`getWorkSpaceStateAfterReboot`**: Récupère l' WorkSpaces état après la tentative de redémarrage.
   + **`branchOnWorkSpaceStateAfterReboot`**: Si WorkSpaces c'est le cas`Available`, passe à l'assertion finale. Sinon, passez à la branche de restauration.
   + **`branchOnRestoreAllowed`**: si `Restore` ce paramètre est défini sur`Yes`, procède à la restauration du WorkSpaces. Sinon, passez à la branche de reconstruction.
   + **`restoreWorkSpace`**: restaure WorkSpaces le instantané le plus récent. Si la restauration échoue, l'automatisation passe à la branche de reconstruction.
   + **`waitForRestoreWorkSpace`**: Attend jusqu'à 10 minutes WorkSpaces pour que le `Restoring` statut atteigne.
   + **`waitForRestoreWorkSpaceResult`**: attend jusqu'à 30 minutes que le `Available` statut WorkSpaces soit atteint `Unhealthy` ou atteint après la restauration. `Error`
   + **`getWorkSpaceStateAfterRestore`**: récupère l' WorkSpaces état après la tentative de restauration.
   + **`branchOnWorkSpaceStateAfterRestore`**: Si WorkSpaces c'est le cas`Available`, passe à l'assertion finale. Sinon, passez à la branche de reconstruction.
   + **`branchOnRebuildAllowed`**: si `Rebuild` ce paramètre est défini sur`Yes`, procède à la reconstruction du WorkSpaces. Dans le cas contraire, passez à l'assertion finale.
   + **`rebuildWorkSpace`**: Reconstruit l'image du bundle WorkSpaces à partir de la dernière image du bundle.
   + **`waitForRebuildWorkSpace`**: Attend jusqu'à 10 minutes WorkSpaces pour que le `Rebuilding` statut atteigne.
   + **`waitForRebuildWorkSpaceResult`**: attend jusqu'à 30 minutes que le statut WorkSpaces atteigne ou atteigne `Unhealthy` `Error` le `Available` statut après la reconstruction.
   + **`getWorkSpaceStateAfterRebuild`**: récupère l' WorkSpaces état après la tentative de reconstruction.
   + **`assertWorkSpaceFinalState`**: confirme que le WorkSpaces statut est`Available`. L'automatisation échoue si le n' WorkSpaces est pas dans un `Available` état.

1. Une fois l'exécution terminée, consultez la section Sorties pour connaître les résultats détaillés de l'exécution.

Systems Manager Automation
+ [Exécuter cette automatisation (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RecoverWorkSpaceWithApproval/description)
+ [Exécuter une automatisation](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing.html)
+ [Configuration d'une automatisation](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-setup.html)
+ [Exécution d'une automatisation avec des approbateurs](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing-approval.html)
+ [Support des flux de travail automatisés](https://aws.amazon.com/premiumsupport/technology/saw/)