

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

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

Il `AWSSupport-RecoverWorkSpaceWithApproval` runbook esegue le fasi di ripristino sull'istanza Amazon WorkSpaces (WorkSpaces) specificata se il suo stato operativo è`Unhealthy`. A seconda dei valori specificati per i parametri di input e le istantanee disponibili, il runbook lo riavvia, ripristina e ricostruisce fino a raggiungere lo stato corrispondente. WorkSpaces `Available` Questo runbook utilizza l'azione di `aws:approve` automazione, che sospende temporaneamente l'automazione fino a quando i principali responsabili designati approvano o rifiutano le azioni di ripristino selezionate.

**Importante**  
Il ripristino o la ricostruzione di un WorkSpace è un'azione potenzialmente distruttiva che può causare la perdita di dati. Questo perché WorkSpace viene ripristinato dall'ultima istantanea disponibile e i dati recuperati dalle istantanee possono durare fino a 12 ore.  
L'opzione di ripristino ricrea sia il volume root che il volume utente in base alle istantanee più recenti. L'opzione rebuild ricrea il volume utente dall'istantanea più recente e ricrea quello WorkSpace dall'immagine associata al pacchetto da cui è stato creato. WorkSpace Le applicazioni installate o le impostazioni di sistema modificate dopo la WorkSpace creazione vengono perse. Per ulteriori informazioni sul ripristino e la ricostruzione WorkSpaces, consulta [Restore a WorkSpace e [Rebuild a WorkSpace](https://docs.aws.amazon.com/workspaces/latest/adminguide/rebuild-workspace.html)](https://docs.aws.amazon.com/workspaces/latest/adminguide/restore-workspace.html) nella *Amazon WorkSpaces * Administration Guide.

Prima di utilizzare questo runbook, ti consigliamo di consultare l'argomento [Risoluzione dei WorkSpaces problemi di Amazon](https://docs.aws.amazon.com/workspaces/latest/adminguide/amazon-workspaces-troubleshooting.html) nella Amazon WorkSpaces Administration Guide.

Il runbook esegue le seguenti azioni di ripristino in sequenza, interrompendosi non appena WorkSpaces raggiunge uno stato: `Available`
+ Recupera lo stato iniziale di WorkSpaces e conferma che si trova in uno stato ripristinabile (`Unhealthy`,,`Error`, `Impaired` o). `Stopped` `Available`
+ Se lo WorkSpaces è`Stopped`, lo avvia e attende il risultato.
+ Recupera le istantanee di ricostruzione e ripristino disponibili per. WorkSpaces
+ Invia una notifica di approvazione tramite Amazon Simple Notification Service (Amazon SNS) agli approvatori designati e mette in pausa fino all'approvazione o al rifiuto.
+ Se `Reboot` è approvata e impostata su`Yes`, riavvia WorkSpaces e attende il risultato.
+ Se non lo WorkSpaces è ancora `Available` ed `Restore` è impostato su`Yes`, ripristina l'istantanea WorkSpaces dell'ultima istantanea e attende il risultato.
+ Se non lo WorkSpaces è ancora `Available` ed `Rebuild` è impostato su`Yes`, ricostruisce l'immagine del pacchetto WorkSpaces dall'immagine del pacchetto più recente e attende il risultato.
+ Conferma lo stato finale di is. WorkSpaces `Available`

 [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/automation/execute/AWSSupport-RecoverWorkSpaceWithApproval) 

**Tipo di documento**

Automazione

**Proprietario**

Amazon

**Piattaforme**

/

**Autorizzazioni IAM richieste**

Il `AutomationAssumeRole` parametro richiede le seguenti azioni per utilizzare correttamente il runbook.
+ `sns:Publish`
+ `workspaces:DescribeWorkspaces`
+ `workspaces:DescribeWorkspaceSnapshots`
+ `workspaces:RebootWorkspaces`
+ `workspaces:RebuildWorkspaces`
+ `workspaces:RestoreWorkspace`
+ `workspaces:StartWorkspaces`

Policy IAM di esempio:

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

Segui questi passaggi per configurare l'automazione:

1. Aprire [AWSSupport-RecoverWorkSpaceWithApproval](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RecoverWorkSpaceWithApproval/description)in Systems Manager in Documenti.

1. Scegli Esegui automazione.

1. Per i parametri di input, immettete quanto segue:
   + **AutomationAssumeRole (Facoltativo):**

     L'ARN del ruolo AWS IAM che consente a Systems Manager Automation di eseguire le azioni per tuo conto. Se non viene specificato alcun ruolo, Systems Manager Automation utilizza le autorizzazioni dell'utente che avvia questo runbook. Tipo:`AWS::IAM::Role::Arn`.
   + **WorkspaceId (Obbligatorio):**

     L'ID del file WorkSpaces da ripristinare. Deve corrispondere allo schema`^ws-[0-9a-z]{8,63}$`. Tipo:`String`.
   + **Riavvio (opzionale):**

     Impostato `Yes` per consentire il WorkSpaces riavvio di. Default: `Yes`. Valori consentiti: \|`Yes`. `No` Tipo:`String`.
   + **Ripristina (opzionale):**

     `Yes`Impostare per consentire WorkSpaces il ripristino di. Nel sistema viene ripristinata l'istantanea più recente del volume principale. Tutte le applicazioni installate o le impostazioni di sistema modificate dopo la creazione dell'istantanea più recente vengono perse. Il volume utente viene ricreato a partire dall'istantanea più recente e il contenuto corrente viene sovrascritto. Default: `No`. Valori consentiti: \|. `Yes` `No` Tipo:`String`.
   + **Ricostruisci (opzionale):**

     Impostato `Yes` per consentire la ricostruzione WorkSpaces di. Il sistema viene aggiornato con l'immagine più recente del pacchetto da cui WorkSpaces è stato creato. Tutte le applicazioni installate o le impostazioni di sistema modificate dopo la WorkSpaces creazione vengono perse. Il volume utente viene ricreato a partire dall'istantanea più recente e il contenuto corrente viene sovrascritto. Default: `No`. Valori consentiti: \|. `Yes` `No` Tipo:`String`.
   + **Conferma (obbligatorio):**

     Inserisci `Yes` per confermare che entrambe le azioni di ripristino e ricostruzione ripristinano lo WorkSpaces snapshot più recente e che i dati ripristinati dalle istantanee possono risalire a 12 ore. Schema consentito:. `^[Yy][Ee][Ss]$` Tipo:`String`.
   + **Approvatori (obbligatorio):**

     Un elenco di nomi utente o ARN IAM degli approvatori per l'azione di automazione. Puoi specificare i principali come nome utente IAM, ARN utente IAM, ARN del ruolo IAM o ARN dell'utente IAM assume il ruolo. Minimo: 1, massimo: 10. Tipo:`StringList`.
   + **MinRequiredApprovals (Opzionale):**

     Il numero minimo di approvazioni necessarie per riprendere l'esecuzione dell'automazione. Il valore non può superare il numero di approvatori definito dal parametro. `Approvers` Default: `1`. Valori consentiti: `1` —. `10` Tipo:`Integer`.
   + **SNSTopicArn (Obbligatorio):**

     L'argomento ARN di Amazon SNS utilizzato per inviare la notifica di approvazione in sospeso. Il nome dell'argomento Amazon SNS deve essere preceduto da. `Automation` Tipo:`String`.

1. Scegli Esegui.

1. L'automazione si avvia.

1. Il documento esegue le seguenti operazioni:
   + **`getWorkSpaceInitialState`**: recupera lo stato corrente di WorkSpaces.
   + **`assertWorkSpaceInitialState`**: conferma che si WorkSpaces trova in uno stato recuperabile (`Available`,,, `Error` `Stopped``Unhealthy`, o). `Impaired` L'automazione termina se si WorkSpaces trova in qualsiasi altro stato.
   + **`branchOnWorkSpaceInitialState`**: filiali basate sullo WorkSpaces stato iniziale. Se`Stopped`, procede all'avvio di WorkSpaces. If`Unhealthy`, or `Error``Impaired`, procede al recupero delle istantanee.
   + **`startWorkSpace`**: avvia WorkSpaces se si trovava in uno stato. `Stopped`
   + **`waitForStartWorkSpace`**: Attende fino a 10 minuti prima che `Starting` lo stato WorkSpaces venga raggiunto.
   + **`waitForStartWorkSpaceResult`**: Attende fino a 30 minuti che `Available` lo stato WorkSpaces raggiunga`Unhealthy`, `Error``Impaired`, o dopo l'avvio.
   + **`getWorkSpaceStateAfterStart`**: recupera WorkSpaces lo stato dopo il tentativo di avvio.
   + **`branchOnWorkSpaceStateAfterStart`**: Se WorkSpaces è`Available`, passa all'asserzione finale. Altrimenti, procede al recupero delle istantanee.
   + **`getWorkSpaceSnapshots`**: recupera le istantanee di ricostruzione e ripristino disponibili per. WorkSpaces
   + **`approval`**: invia una notifica di approvazione all'argomento Amazon SNS specificato e sospende l'automazione per un massimo di 24 ore, in attesa che gli approvatori designati approvino o neghino le azioni di ripristino.
   + **`branchOnRebootAllowed`**: se `Reboot` è impostato su, procede al riavvio di. `Yes` WorkSpaces Altrimenti, passa al ramo di ripristino.
   + **`rebootWorkSpace`**: riavvia il. WorkSpaces
   + **`waitForRebootWorkSpace`**: Attende fino a 10 minuti prima che venga raggiunto WorkSpaces `Rebooting` lo stato.
   + **`waitForRebootWorkSpaceResult`**: Attende fino a 30 minuti per WorkSpaces raggiungere `Unhealthy` `Available` lo stato o dopo `Error` il riavvio.
   + **`getWorkSpaceStateAfterReboot`**: recupera WorkSpaces lo stato dopo il tentativo di riavvio.
   + **`branchOnWorkSpaceStateAfterReboot`**: Se WorkSpaces è`Available`, passa all'asserzione finale. Altrimenti, passa al ramo di ripristino.
   + **`branchOnRestoreAllowed`**: Se `Restore` è impostato su`Yes`, procede con il ripristino di. WorkSpaces Altrimenti, procede al ramo di ricostruzione.
   + **`restoreWorkSpace`**: ripristina l'istantanea WorkSpaces dall'istantanea più recente. Se il ripristino non riesce, l'automazione passa al ramo di ricostruzione.
   + **`waitForRestoreWorkSpace`**: Attende fino a 10 minuti prima che venga raggiunto lo WorkSpaces stato. `Restoring`
   + **`waitForRestoreWorkSpaceResult`**: Attende fino a 30 minuti prima che `Available` lo stato WorkSpaces `Unhealthy` raggiunga o dopo il ripristino. `Error`
   + **`getWorkSpaceStateAfterRestore`**: recupera WorkSpaces lo stato dopo il tentativo di ripristino.
   + **`branchOnWorkSpaceStateAfterRestore`**: Se WorkSpaces è`Available`, passa all'asserzione finale. Altrimenti, procede al ramo di ricostruzione.
   + **`branchOnRebuildAllowed`**: Se `Rebuild` è impostato su`Yes`, procede alla ricostruzione di. WorkSpaces Altrimenti, procede all'asserzione finale.
   + **`rebuildWorkSpace`**: ricostruisce l'immagine del WorkSpaces pacchetto più recente.
   + **`waitForRebuildWorkSpace`**: Attende fino a 10 minuti prima che lo stato venga raggiunto. WorkSpaces `Rebuilding`
   + **`waitForRebuildWorkSpaceResult`**: Attende fino a 30 minuti prima che `Available` lo stato WorkSpaces `Unhealthy` raggiunga o dopo la ricostruzione. `Error`
   + **`getWorkSpaceStateAfterRebuild`**: recupera WorkSpaces lo stato dopo il tentativo di ricostruzione.
   + **`assertWorkSpaceFinalState`**: conferma che lo WorkSpaces stato è. `Available` L'automazione fallisce se non WorkSpaces si trova in uno `Available` stato.

1. Dopo il completamento, consulta la sezione Output per i risultati dettagliati dell'esecuzione.

Systems Manager Automation
+ [Esegui questa automazione (console)](https://console.aws.amazon.com/systems-manager/documents/AWSSupport-RecoverWorkSpaceWithApproval/description)
+ [Esegui un'automazione](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing.html)
+ [Configurazione di un'automazione](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-setup.html)
+ [Esecuzione di un'automazione con approvatori](https://docs.aws.amazon.com/systems-manager/latest/userguide/automation-working-executing-approval.html)
+ [Flussi di lavoro di Support Automation](https://aws.amazon.com/premiumsupport/technology/saw/)