

Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

# `AWSSupport-RecoverWorkSpaceWithApproval`
<a name="automation-aws-recoverworkspacewithapproval"></a>

El `AWSSupport-RecoverWorkSpaceWithApproval` runbook lleva a cabo los pasos de recuperación de la instancia de Amazon WorkSpaces (WorkSpaces) que especifiques si su estado operativo es el siguiente. `Unhealthy` Según los valores que especifiques para los parámetros de entrada y las instantáneas disponibles, el runbook se reinicia, restaura y reconstruye hasta que pasa a estar en estado. WorkSpaces `Available` Este libro de operaciones utiliza la acción de `aws:approve` automatización, que detiene temporalmente la automatización hasta que los directores designados aprueben o rechacen las acciones de recuperación seleccionadas.

**importante**  
Restaurar o reconstruir una WorkSpace es una acción potencialmente destructiva que puede provocar la pérdida de datos. Esto se debe a que WorkSpace se restaura a partir de la última instantánea disponible y los datos recuperados de las instantáneas pueden tener una antigüedad de hasta 12 horas.  
La opción de restauración recrea tanto el volumen raíz como el volumen de usuarios en función de las instantáneas más recientes. La opción de reconstrucción recrea el volumen de usuario a partir de la instantánea más reciente y recrea el volumen de usuario a WorkSpace partir de la imagen asociada al paquete a partir del cual WorkSpace se creó. Las aplicaciones que se instalaron o la configuración del sistema que se modificó después de su creación WorkSpace se pierden. Para obtener más información sobre la restauración y la reconstrucción WorkSpaces, consulte [ Restaurar WorkSpace ](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) y [ reconstruir a WorkSpace ](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html) en la Guía de WorkSpaces administración de * Amazon*.

Antes de utilizar este manual, recomendamos revisar el [ tema ](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html) Solución de problemas de Amazon WorkSpaces de la Guía de WorkSpaces administración de Amazon.

El runbook lleva a cabo las siguientes acciones de recuperación de forma secuencial y se detiene en cuanto WorkSpaces alcanza un `Available` estado:
+ Recupera el estado inicial del WorkSpaces y confirma que se encuentra en un estado recuperable (`Unhealthy`,,, `Error` `Impaired``Stopped`, o). `Available`
+ Si WorkSpaces es así`Stopped`, lo inicia y espera el resultado.
+ Recupera las instantáneas de reconstrucción y restauración disponibles para. WorkSpaces
+ Envía una notificación de aprobación a través de Amazon Simple Notification Service (Amazon SNS) a los aprobadores designados y la detiene hasta que se aprueba o deniega.
+ Si se aprueba y `Reboot` se establece en`Yes`, se reinicia WorkSpaces y espera el resultado.
+ Si aún no lo WorkSpaces está `Available` y `Restore` está establecido en`Yes`, WorkSpaces restaura la instantánea más reciente y espera el resultado.
+ Si aún no WorkSpaces lo está `Available` y `Rebuild` está establecido en`Yes`, reconstruye la imagen a WorkSpaces partir de la imagen del paquete más reciente y espera el resultado.
+ Confirma el estado final del es WorkSpaces . `Available`

 [Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RecoverWorkSpaceWithApproval) 

**Tipo de documento**

Automatización

**Propietario**

Amazon

**Plataformas**

/

**Permisos de IAM necesarios**

El parámetro `AutomationAssumeRole` requiere las siguientes acciones para utilizar el manual de procedimientos correctamente.
+ `sns:Publish`
+ `workspaces:DescribeWorkspaces`
+ `workspaces:DescribeWorkspaceSnapshots`
+ `workspaces:RebootWorkspaces`
+ `workspaces:RebuildWorkspaces`
+ `workspaces:RestoreWorkspace`
+ `workspaces:StartWorkspaces`

Política de IAM de ejemplo:

```
{
    "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*"
        }
    ]
}
```

Siga estos pasos para configurar la automatización:

1. Abra [ AWSSupport-RecoverWorkSpaceWithApproval ](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RecoverWorkSpaceWithApproval/description) en Systems Manager, en Documentos.

1. Elija Ejecutar automatización.

1. Para los parámetros de entrada, introduzca lo siguiente:
   + **AutomationAssumeRole (Opcional): **

     El AWS ARN del rol de IAM que permite a Systems Manager Automation realizar las acciones en su nombre. Si no se especifica ningún rol, Systems Manager Automation utiliza los permisos del usuario que comienza este manual de procedimientos. Tipo: `AWS::IAM::Role::Arn`.
   + **WorkspaceId (Obligatorio): **

     El ID del que se WorkSpaces va a recuperar. Debe coincidir con el patrón`^ws-[0-9a-z]{8,63}$`. Tipo: `String`.
   + **Reiniciar (opcional): **

     `Yes`Configúrelo para permitir WorkSpaces que se reinicie. Predeterminado: `Yes`. Valores permitidos: `Yes` \|. `No` Tipo: `String`.
   + **Restaurar (opcional): **

     `Yes`Configúrelo en WorkSpaces para permitir la restauración. El sistema se restaura en la instantánea más reciente del volumen raíz. Se perderán todas las aplicaciones instaladas o la configuración del sistema que se haya modificado después de crear la instantánea más reciente. El volumen de usuario se recrea a partir de la instantánea más reciente y su contenido actual se sobrescribe. Predeterminado: `No`. Valores permitidos: `Yes` \|. `No` Tipo: `String`.
   + **Reconstruir (opcional): **

     Configúrelo en `Yes` para permitir WorkSpaces que se reconstruya. El sistema se actualiza con la imagen más reciente del paquete a partir del cual WorkSpaces se creó. Se pierden todas las aplicaciones instaladas o los ajustes del WorkSpaces sistema cambiados después de su creación. El volumen de usuario se recrea a partir de la instantánea más reciente y se sobrescribe su contenido actual. Predeterminado: `No`. Valores permitidos: `Yes` \|. `No` Tipo: `String`.
   + **Confirmar (obligatorio): **

     Introdúzcalo `Yes` para confirmar que tanto las acciones de restauración como las WorkSpaces de reconstrucción recuperan los datos de la instantánea más reciente y que los datos restaurados a partir de instantáneas pueden tener una antigüedad de hasta 12 horas. Patrón permitido:`^[Yy][Ee][Ss]$`. Tipo: `String`.
   + **Autorizadores (obligatorio): **

     Una lista de los nombres de usuario o ARN de IAM de los aprobadores de la acción de automatización. Puede especificar los principales como nombre de usuario de IAM, ARN de usuario de IAM, ARN de rol de IAM o ARN de usuario de rol asumido de IAM. Mínimo: 1, máximo: 10. Tipo: `StringList`.
   + **MinRequiredApprovals (Opcional): **

     El número mínimo de aprobaciones necesario para reanudar la ejecución de la automatización. El valor no puede superar el número de aprobadores definido por el `Approvers` parámetro. Predeterminado: `1`. Valores permitidos: `1` —`10`. Tipo: `Integer`.
   + **SNSTopicArn (Obligatorio): **

     El ARN del tema de Amazon SNS utilizado para enviar la notificación de aprobación pendiente. El nombre del tema de Amazon SNS debe ir precedido de. `Automation` Tipo: `String`.

1. Elija Ejecutar.

1. Se inicia la automatización.

1. Este documento realiza los siguientes pasos:
   + **`getWorkSpaceInitialState`**: Recupera el estado actual de. WorkSpaces
   + **`assertWorkSpaceInitialState`**: Confirma que WorkSpaces se encuentra en un estado recuperable (`Available`,`Error`, `Stopped``Unhealthy`, o`Impaired`). La automatización finaliza si se WorkSpaces encuentra en cualquier otro estado.
   + **`branchOnWorkSpaceInitialState`**: Se bifurcan según el WorkSpaces estado inicial. Si`Stopped`, procede a iniciar el WorkSpaces. Si `Unhealthy``Error`, o`Impaired`, procede a recuperar las instantáneas.
   + **`startWorkSpace`**: Inicia WorkSpaces si estaba en un `Stopped` estado.
   + **`waitForStartWorkSpace`**: Espera hasta 10 minutos para WorkSpaces que alcance el `Starting` estado.
   + **`waitForStartWorkSpaceResult`**: Espera hasta 30 minutos para que alcance el WorkSpaces `Available` estado `Unhealthy` `Error``Impaired`, o después de empezar.
   + **`getWorkSpaceStateAfterStart`**: recupera el WorkSpaces estado tras el intento de inicio.
   + **`branchOnWorkSpaceStateAfterStart`**: Si WorkSpaces es`Available`, pasa a la afirmación final. De lo contrario, procede a recuperar las instantáneas.
   + **`getWorkSpaceSnapshots`**: recupera las instantáneas de reconstrucción y restauración disponibles para. WorkSpaces
   + **`approval`**: Envía una notificación de aprobación al tema de Amazon SNS especificado y detiene la automatización durante un máximo de 24 horas, a la espera de que los aprobadores designados aprueben o rechacen las acciones de recuperación.
   + **`branchOnRebootAllowed`**: Si `Reboot` está establecido en`Yes`, procede a reiniciar el. WorkSpaces De lo contrario, pasa a la rama de restauración.
   + **`rebootWorkSpace`**: Reinicia el WorkSpaces.
   + **`waitForRebootWorkSpace`**: Espera hasta 10 minutos para que alcance `Rebooting` el WorkSpaces estado.
   + **`waitForRebootWorkSpaceResult`**: Espera hasta 30 minutos para que alcance `Unhealthy` el WorkSpaces `Available` estado o `Error` se reinicie.
   + **`getWorkSpaceStateAfterReboot`**: recupera el WorkSpaces estado tras el intento de reinicio.
   + **`branchOnWorkSpaceStateAfterReboot`**: Si WorkSpaces es`Available`, pasa a la afirmación final. De lo contrario, pasa a la rama de restauración.
   + **`branchOnRestoreAllowed`**: Si `Restore` está establecido en`Yes`, procede a restaurar el WorkSpaces. De lo contrario, pasa a la rama de reconstrucción.
   + **`restoreWorkSpace`**: restaura la instantánea WorkSpaces de la más reciente. Si se produce un error en la restauración, la automatización pasa a la rama de reconstrucción.
   + **`waitForRestoreWorkSpace`**: Espera hasta 10 minutos para WorkSpaces que alcance el `Restoring` estado.
   + **`waitForRestoreWorkSpaceResult`**: Espera hasta 30 minutos para que alcance `Unhealthy` el WorkSpaces `Available` estado o `Error` se restablezca.
   + **`getWorkSpaceStateAfterRestore`**: recupera el WorkSpaces estado tras el intento de restauración.
   + **`branchOnWorkSpaceStateAfterRestore`**: Si WorkSpaces es`Available`, pasa a la afirmación final. De lo contrario, pasa a la rama de reconstrucción.
   + **`branchOnRebuildAllowed`**: Si `Rebuild` está establecido en`Yes`, continúa con la reconstrucción de WorkSpaces. De lo contrario, pasa a la afirmación final.
   + **`rebuildWorkSpace`**: Reconstruye la imagen WorkSpaces a partir de la imagen del paquete más reciente.
   + **`waitForRebuildWorkSpace`**: Espera hasta 10 minutos para que alcance `Rebuilding` el WorkSpaces estado.
   + **`waitForRebuildWorkSpaceResult`**: Espera hasta 30 minutos para que alcance `Unhealthy` el WorkSpaces `Available` estado o después `Error` de la reconstrucción.
   + **`getWorkSpaceStateAfterRebuild`**: recupera el WorkSpaces estado tras el intento de reconstrucción.
   + **`assertWorkSpaceFinalState`**: Confirma que el WorkSpaces estado es`Available`. La automatización falla si no WorkSpaces está en un `Available` estado.

1. Una vez finalizada, revise la sección Salidas para ver los resultados detallados de la ejecución.

Automatización de Systems Manager
+ [Ejecuta esta automatización (consola)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RecoverWorkSpaceWithApproval/description)
+ [Ejecución de una automatización](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing.html)
+ [Configuración de Automatización](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-setup.html)
+ [Cómo ejecutar una automatización con los aprobadores ](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing-approval.html)
+ [Soporta flujos de trabajo de automatización ](https://aws.amazon.com/premiumsupport/technology/saw/)