

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

# Ripristina un backup per tipo di risorsa
<a name="restoring-a-backup"></a>

## Come ripristinare
<a name="how-to-restore"></a>

Per le istruzioni di ripristino della console e i collegamenti alla documentazione per ogni tipo di risorsa AWS Backup supportata, consulta i collegamenti in fondo a questa pagina.

Per ripristinare un backup in modo programmatico, utilizza l'operazione API [StartRestoreJob](API_StartRestoreJob.md).

I valori di configurazione ("metadati di ripristino") necessari per ripristinare la risorsa variano a seconda della risorsa che si desidera ripristinare. Per ottenere i metadati di configurazione con cui è stato creato il backup, puoi chiamare [GetRecoveryPointRestoreMetadata](API_GetRecoveryPointRestoreMetadata.md). Esempi di metadati di ripristino sono disponibili anche nei collegamenti nella parte inferiore di questa pagina.

Il ripristino dallo storage a freddo richiede in genere 4 ore in più rispetto al ripristino dallo storage a caldo.

Per ciascun ripristino, viene creato un processo di ripristino con un ID processo univoco, ad esempio, `1323657E-2AA4-1D94-2C48-5D7A423E7394`.

**Nota**  
AWS Backup non fornisce alcun accordo sui livelli di servizio (SLAs) per i tempi di ripristino. I tempi di ripristino possono variare in base al carico e alla capacità del sistema, anche per ripristini contenenti le stesse risorse.

## Ripristini non distruttivi
<a name="non-destructive-restores"></a>

Quando si utilizza AWS Backup per ripristinare un backup, viene creata una nuova risorsa con il backup che si sta ripristinando. Questo serve a evitare che le risorse esistenti vengano distrutte dall'attività di ripristino.

## Test di ripristino
<a name="restore-testing-intro"></a>

È possibile eseguire i test sulle risorse per simulare un'esperienza di ripristino. In tal modo è possibile determinare se si soddisfa l'obiettivo del tempo di ripristino (RTO) dell'organizzazione e prepararsi per le future esigenze di ripristino.

Per ulteriori informazioni, consulta [Test di ripristino](https://docs.aws.amazon.com/aws-backup/latest/devguide/restore-testing.html).

## Copia dei tag durante un ripristino
<a name="tag-on-restore"></a>

**Nota**  
Attualmente, i ripristini di Amazon DynamoDB, Amazon S3, SAP HANA su istanze Amazon EC2, macchine virtuali e risorse Amazon Timestream non dispongono di questa funzionalità.

### Introduzione
<a name="w2aac17c31b9b5"></a>

Puoi copiare i tag durante il ripristino di una risorsa se i tag appartenevano alla risorsa protetta al momento del backup. I tag, che sono etichette contenenti una coppia chiave-valore, possono semplificare l'identificazione e la ricerca delle risorse. Quando si avvia un processo di ripristino, i tag che appartenevano alle risorse di backup originali possono essere aggiunti alla risorsa da ripristinare.

Quando si sceglie di includere i tag durante un processo di ripristino, questo passaggio può sostituire i costi operativi e la manodopera associati all'applicazione manuale dei tag alle risorse dopo il completamento di un processo di ripristino. Tieni presente che ciò è diverso dall'aggiunta di nuovi tag alle risorse ripristinate.

Quando ripristini un backup nel flusso della console, i tag di origine verranno copiati per impostazione predefinita. Nella console, deseleziona la casella se desideri escludere la copia dei tag in una risorsa ripristinata

Nell'operazione API `StartRestoreJob`, il parametro `CopySourceTagsToRestoredResource` è impostato su `false` per impostazione predefinita. Ciò escluderà i tag di origine originali dalla risorsa che stai ripristinando. Se desideri *includere* tag dalla sorgente originale, imposta questo valore su `True`.

### Considerazioni
<a name="w2aac17c31b9b7"></a>
+ Una risorsa può contenere un massimo di 50 tag, incluse le risorse ripristinate. Per ulteriori informazioni sui limiti di tag, consulta [Assegnazione di tag alle risorse AWS](https://docs.aws.amazon.com/tag-editor/latest/userguide/tagging.html).
+ Assicurati che il ruolo utilizzato per i ripristini dei tag di copia, disponga delle autorizzazioni corrette. Il ruolo predefinito per i ripristini contiene le autorizzazioni necessarie. Un ruolo personalizzato deve includere autorizzazioni aggiuntive per assegnare tag alle risorse. 
+ Le seguenti risorse non sono attualmente supportate per l'inclusione dei tag di ripristino: VMware Cloud™ on AWS, VMware Cloud™ on, sistemi locali AWS Outposts, SAP HANA su istanze Amazon EC2, Timestream, DynamoDB, Advanced DynamoDB e Amazon S3.
+ Per i backup continui, i tag sulla risorsa originale a partire dal backup più recente verranno copiati nella risorsa ripristinata.
+ I tag non verranno copiati per ripristini a livello di elemento.
+ I tag che sono stati aggiunti a un backup dopo il completamento del processo di backup ma che non erano presenti nella risorsa originale prima del backup non verranno copiati nella risorsa ripristinata. Solo i backup creati dopo il 22 maggio 2023 sono idonei per la copia dei tag al momento del ripristino.

### Interazione dei tag con risorse specifiche
<a name="backup-tag-resources"></a>
+ **Amazon EC2**
  + I tag applicati alle istanze **Amazon EC2** ripristinate vengono applicati anche ai volumi **Amazon** EBS ripristinati collegati.
  + I tag applicati ai volumi EBS collegati alle istanze di origine non vengono copiati sui volumi collegati alle istanze ripristinate. Se disponi di policy IAM che consentono o negano agli utenti l'accesso ai volumi EBS in base ai loro tag, devi riassegnare manualmente i tag richiesti ai volumi ripristinati per garantire che le policy rimangano in vigore.
+ Quando ripristini una risorsa **Amazon EFS**, questa deve essere copiata in un nuovo file system. Nei ripristini eseguiti in un file system esistente non è possibile copiare i tag su di essi.
+ **Amazon RDS**
  + Se il cluster RDS di cui è stato eseguito il backup è ancora attivo, i tag di questo cluster verranno copiati.
  + Se il cluster originale non è più attivo, verranno invece copiati i tag dello snapshot del cluster.
  + I tag presenti sulla risorsa al momento del backup, verranno copiati durante il ripristino a prescindere che il parametro booleano per `CopySourceTagsToRestoredResource` sia impostato su `True` o `False`. Tuttavia, se lo snapshot non contiene tag, verrà utilizzata l'impostazione booleana precedente.
+ Per impostazione predefinita, i cluster **Amazon Redshift** includono sempre i tag durante un processo di ripristino. 

### Copia dei tag tramite la console
<a name="w2aac17c31b9c15"></a>

1. Apri la [console AWS Backup](https://console.aws.amazon.com/backup/)

1. Nel riquadro di navigazione, scegli **Risorse protette** e seleziona l'ID della risorsa Amazon S3 che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionato. Per ripristinare una risorsa:

   1. Nel riquadro **Backup**, scegli l'ID del punto di ripristino della risorsa.

   1. Nell'angolo in alto a destra del riquadro, scegli **Ripristina** (in alternativa, puoi passare al vault di backup, trovare il punto di ripristino, quindi fare clic su **Azioni** e su **Ripristina**).

1. Nella **pagina Ripristina backup**, individua il pannello denominato Ripristina con tag. Per includere tutti i tag della risorsa originale, mantieni la casella di selezionata (nota che nella console questa casella è selezionata per impostazione predefinita).

1. Fai clic su **Ripristina backup** dopo aver selezionato tutte le impostazioni e i ruoli preferiti.

### Per includere tag in modo programmatico
<a name="w2aac17c31b9c17"></a>

Usa l'operazione API `StartRestoreJob`. Assicurati che il seguente parametro booleano sia impostato su `True`:

```
CopySourceTagsToRestoredResource = true
```

Se il parametro booleano `CopySourceTagsToRestoredResource` = `True`, il processo di ripristino copierà i tag dalle risorse originali nel materiale ripristinato. 

**Importante**  
Il processo di ripristino avrà esito negativo se questo parametro viene incluso per una risorsa non supportata (VMware, sistemi locali AWS Outposts, SAP HANA su istanze EC2, Timestream, DynamoDB, Advanced DynamoDB e Amazon S3).

```
{
    "RecoveryPointArn": "arn:aws:ec2:us-east-1::image/ami-1234567890a1b234",
    "Metadata": {
        "InstanceInitiatedShutdownBehavior": "stop",
        "DisableApiTermination": "false",
        "EbsOptimized": "false",
        "InstanceType": "t1.micro",
        "SubnetId": "subnet-123ab456cd7efgh89",
        "SecurityGroupIds": "[\"sg-0a1bc2d345ef67890\"]",
        "Placement": "{\"GroupName\":null,\"Tenancy\":\"default\"}",
        "HibernationOptions": "{\"Configured\":false}",
        "IamInstanceProfileName": "UseBackedUpValue",
        "aws:backup:request-id": "1a2345b6-cd78-90e1-2345-67f890g1h2ij"
    },
    "IamRoleArn": "arn:aws:iam::123456789012:role/EC2Restore",
    "ResourceType": "EC2",
    "IdempotencyToken": "34ab5678-9012-3c4d-5678-efg9h01f23i4",
    "CopySourceTagsToRestoredResource": true
}
```

### Risoluzione dei problemi di ripristino dei tag
<a name="w2aac17c31b9c19"></a>

**ERROR:** autorizzazioni insufficienti

**REMEDY:** assicurati di disporre delle autorizzazioni necessarie nel ruolo di ripristino in modo da poter includere i tag nella risorsa ripristinata. La policy predefinita relativa ai ruoli dei servizi [AWS gestiti](https://docs.aws.amazon.com/aws-backup/latest/devguide/security-iam-awsmanpol.html#aws-managed-policies) per i ripristini contiene le autorizzazioni necessarie per questa attività. [AWSBackupServiceRolePolicyForRestores](https://console.aws.amazon.com/iam/home#/policies/arn:aws:iam::aws:policy/service-role/AWSBackupServiceRolePolicyForRestores$jsonEditor) 

Se scegli di utilizzare un ruolo personalizzato, assicurati che siano presenti le seguenti autorizzazioni:
+ `elasticfilesystem:TagResource`
+ `storagegateway:AddTagsToResource`
+ `rds:AddTagsToResource`
+ `ec2:CreateTags`
+ `cloudformation:TagResource`

Per ulteriori informazioni, consulta [Autorizzazioni API](https://docs.aws.amazon.com/aws-backup/latest/devguide/access-control.html#backup-api-permissions-ref).

## Stati del processo di ripristino
<a name="restore-job-statuses"></a>

Puoi visualizzare lo stato di un processo di ripristino nella pagina **Processi** della console di AWS Backup . Gli stati del processo di ripristino includono: **pending** (in sospeso), **running** (in esecuzione), **aborted** (interrotto), **completed** (completato) e **failed** (non riuscito).

**Topics**
+ [Come ripristinare](#how-to-restore)
+ [Ripristini non distruttivi](#non-destructive-restores)
+ [Test di ripristino](#restore-testing-intro)
+ [Copia dei tag durante un ripristino](#tag-on-restore)
+ [Stati del processo di ripristino](#restore-job-statuses)
+ [Ripristino di un cluster Amazon Aurora](restoring-aur.md)
+ [Ripristino di Amazon Aurora DSQL](restore-auroradsql.md)
+ [Ripristina gli stack CloudFormation](restore-application-stacks.md)
+ [Ripristino di un cluster DocumentDB](restoring-docdb.md)
+ [Ripristina una tabella Amazon DynamoDB](restoring-dynamodb.md)
+ [Ripristino di un volume Amazon EBS](restoring-ebs.md)
+ [Ripristina un'istanza Amazon EC2](restoring-ec2.md)
+ [Ripristina un file system Amazon EFS](restoring-efs.md)
+ [Ripristina un cluster Amazon EKS](restoring-eks.md)
+ [Ripristinare un FSx file system](restoring-fsx.md)
+ [Ripristina un cluster Neptune](restoring-nep.md)
+ [Ripristina un database RDS](restoring-rds.md)
+ [Ripristino di un cluster Amazon Redshift](redshift-restores.md)
+ [Ripristino senza server di Amazon Redshift](redshift-serverless-restore.md)
+ [Ripristino di database SAP HANA su un'istanza Amazon EC2](saphana-restore.md)
+ [Ripristina i dati S3 utilizzando AWS Backup](restoring-s3.md)
+ [Ripristino di un volume Storage Gateway](restoring-storage-gateway.md)
+ [Ripristino di una tabella Amazon Timestream](timestream-restore.md)
+ [Ripristina una macchina virtuale utilizzando AWS Backup](restoring-vm.md)

# Ripristino di un cluster Amazon Aurora
<a name="restoring-aur"></a>

## Usa la AWS Backup console per ripristinare i punti di ripristino Aurora
<a name="aur-restore-console"></a>

AWS Backup ripristina il cluster Aurora; non crea o collega un'istanza Amazon RDS al cluster. Nei passaggi seguenti, viene illustrato come creare e collegare un'istanza Amazon RDS al cluster Aurora ripristinato tramite la CLI.

Per ripristinare un cluster Aurora è necessario specificare più opzioni di ripristino. Per informazioni su queste opzioni, consulta [Panoramica di backup e ripristino di un cluster di database Aurora](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/Aurora.Managing.Backups.html) nella *Guida per l'utente di Amazon Aurora*. Le specifiche per le opzioni di ripristino sono disponibili nella guida API per. [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromSnapshot.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromSnapshot.html)

**Per ripristinare un cluster Amazon Aurora**

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette** e l'ID della risorsa Aurora che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Per ripristinare una risorsa, nel riquadro **Backup** scegliere il pulsante di opzione accanto all'ID del punto di ripristino della risorsa. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. Nel riquadro **Specifiche dell'istanza** accettare i valori predefiniti o specificare le opzioni per le impostazioni **Motore database**, della**Versione motore database** e **Tipo di capacità**. 
**Nota**  
Se è selezionato il tipo di capacità **Serverless** viene visualizzato un riquadro **Impostazioni di capacità**. Specificare le opzioni per **Unità di capacità minima di Aurora** e **Unità di capacità massima di Aurora** oppure scegliere opzioni diverse dalla sezione **Configurazione di ridimensionamento aggiuntivo**.

1. Nel riquadro **Impostazioni**, specifica un nome univoco per tutte le istanze del cluster DB di proprietà dell'utente Account AWS nella regione corrente.

1. Nel riquadro **Rete e sicurezza**, accettare le impostazioni predefinite o specificare le opzioni per le impostazioni di **Cloud privato virtuale (VPC)**, **Gruppo di sottoreti**, e **Zona di disponibilità**. 

1. Nel riquadro **Opzioni database** accettare le impostazioni predefinite o specificare le opzioni per le impostazioni **Porta database**, **Gruppo di parametri del cluster DB** e **Autenticazione DB IAM abilitata**. 

1. Nel riquadro **Backup** accettare l'impostazione predefinita o specificare l'opzione per l'impostazione **Copia i tag sugli snapshot**. 

1. Nel riquadro **Backtrack** accettare l'impostazione predefinita o specificare le opzioni per le impostazioni **Abilita Backtrack** o **Disabilita Backtrack**. 

1. Nel riquadro **Crittografia** accettare l'impostazione predefinita o specificare le opzioni per le impostazioni **Abilita crittografia** o **Disabilita crittografia**. 

1. Nel riquadro **Esportazioni dei log**, scegli i tipi di log da pubblicare su Amazon CloudWatch Logs. Il **ruolo IAM** è già definito. 

1. Nel riquadro **Ripristina ruolo** scegliere il ruolo IAM che AWS Backup assumerà per questo ripristino. 

1. Dopo aver specificato tutte le impostazioni, scegli **Ripristina backup**.

   Viene visualizzato il riquadro **Lavori di ripristino**. Un messaggio nella parte superiore della pagina fornisce informazioni sul lavoro di ripristino.

1. Al termine del ripristino, collega il cluster Aurora ripristinato a un'istanza Amazon RDS.

   Utilizzo della AWS CLI:
   + Per Linux, macOS o Unix:

     ```
     aws rds create-db-instance --db-instance-identifier sample-instance \ 
                   --db-cluster-identifier sample-cluster --engine aurora-mysql --db-instance-class db.r4.large
     ```
   + Per Windows:

     ```
     aws rds create-db-instance --db-instance-identifier sample-instance ^ 
                   --db-cluster-identifier sample-cluster --engine aurora-mysql --db-instance-class db.r4.large
     ```

Vedi [backup e point-in-time ripristino continui (PITR)](https://docs.aws.amazon.com/aws-backup/latest/devguide/point-in-time-recovery.html) per informazioni sui backup continui e sul ripristino in un determinato momento.

## Usa l' AWS Backup API, la CLI o l'SDK per ripristinare i punti di ripristino di Amazon Aurora
<a name="aur-restore-cli"></a>

Utilizza `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`. I metadati che puoi includere per un processo di ripristino dipenderanno dal fatto che tu stia ripristinando un backup continuo su un punto nel tempo (PITR) o se stai ripristinando un'istantanea.

**Ripristina un cluster da un'istantanea**  
È possibile specificare i seguenti metadati per un processo di ripristino delle istantanee Aurora. Consulta il riferimento [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromSnapshot.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterFromSnapshot.html)all'*API di Amazon Relational Database Service* per ulteriori informazioni e valori accettati.

```
// Required metadata:
dbClusterIdentifier // string
engine // string

// Optional metadata:          
availabilityZones // array of strings
backtrackWindow // long
copyTagsToSnapshot // Boolean
databaseName // string
dbClusterParameterGroupName // string
dbSubnetGroupName // string
enableCloudwatchLogsExports // array of strings
enableIAMDatabaseAuthentication // Boolean
engineMode // string
engineVersion // string
kmsKeyId // string
optionGroupName // string
port // integer
scalingConfiguration // object
vpcSecurityGroupIds // array of strings
```

Esempio:

```
"restoreMetadata":"{\"EngineVersion\":\"5.6.10a\",\"KmsKeyId\":\"arn:aws:kms:us-east-1:234567890123:key/45678901-ab23-4567-8cd9-012d345e6f7\",\"EngineMode\":\"serverless\",\"AvailabilityZones\":\"[\\\"us-east-1b\\\",\\\"us-east-1e\\\",\\\"us-east-1c\\\"]\",\"Port\":\"3306\",\"DatabaseName\":\"\",\"DBSubnetGroupName\":\"default-vpc-05a3b07cf6e193e1g\",\"VpcSecurityGroupIds\":\"[\\\"sg-012d52c68c6e88f00\\\"]\",\"ScalingConfiguration\":\"{\\\"MinCapacity\\\":2,\\\"MaxCapacity\\\":64,\\\"AutoPause\\\":true,\\\"SecondsUntilAutoPause\\\":300,\\\"TimeoutAction\\\":\\\"RollbackCapacityChange\\\"}\",\"EnableIAMDatabaseAuthentication\":\"false\",\"DBClusterParameterGroupName\":\"default.aurora5.6\",\"CopyTagsToSnapshot\":\"true\",\"Engine\":\"aurora\",\"EnableCloudwatchLogsExports\":\"[]\"}"
```

**Ripristina un cluster a un punto nel tempo (PITR)**  
È possibile specificare i seguenti metadati quando si desidera ripristinare un backup continuo Aurora (punto di ripristino) in un punto temporale specifico (PITR). Consulta il riferimento [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterToPointInTime.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBClusterToPointInTime.html)all'*API di Amazon Relational Database Service* per ulteriori informazioni e valori accettati.

```
// Required metadata:
dbClusterIdentifier // string
engine // string
restoreToTime // timestamp; must be specified if UseLatestRestorableTime parameter isn't provided

// Optional metadata:          
backtrackWindow // long
copyTagsToSnapshot // Boolean
dbClusterParameterGroupName // string
dbSubnetGroupName // string
enableCloudwatchLogsExports // array of strings
enableIAMDatabaseAuthentication // Boolean
engineMode // string
engineVersion // string
kmsKeyId // string
optionGroupName // string
port // integer
scalingConfiguration // object
vpcSecurityGroupIds // array of strings
```

# Ripristino di Amazon Aurora DSQL
<a name="restore-auroradsql"></a>

**Topics**
+ [Panoramica di](#restore-auroradsql-overview)
+ [Ripristina il cluster Aurora DSQL a regione singola](#restore-auroradsql-singleregion)
+ [Ripristina un cluster multiregionale Aurora DSQL](#restore-auroradsql-multiregion)
+ [Risolvi i problemi di ripristino di Aurora DSQL](#restore-auroradsql-troubleshoot)
+ [Domande frequenti sul ripristino DSQL di Aurora](#restore-auroradsql-faq)

## Panoramica di
<a name="restore-auroradsql-overview"></a>

Per ripristinare un cluster Amazon Aurora DSQL Single-Region, utilizza la console AWS Backup o la CLI per selezionare il punto di ripristino (backup) che desideri ripristinare. Per ripristinare un cluster multiregionale Aurora DSQL, ora puoi utilizzare la console AWS Backup o la CLI.

Per il ripristino su una singola regione, includi il nome, la crittografia del cluster e la protezione dall'eliminazione, quindi avvia il ripristino su un cluster appena creato.

Per il ripristino in più regioni, è necessario specificare parametri aggiuntivi, tra cui una regione di riferimento, una o più regioni peer e impostazioni di configurazione regionali. Il ripristino in più regioni crea un cluster che si estende su più aree Regioni AWS, garantendo una maggiore disponibilità e funzionalità di disaster recovery.

## Ripristina il cluster Aurora DSQL a regione singola
<a name="restore-auroradsql-singleregion"></a>

È possibile ripristinare un cluster Aurora DSQL in una singola regione utilizzando la AWS Backup console o. AWS CLI

------
#### [ Console ]

****

1. [Aprire la AWS Backup console in https://console.aws.amazon.com /backup.](https://console.aws.amazon.com/backup)

1. Seleziona il pulsante «Ripristina» accanto al punto di ripristino che desideri ripristinare.

1. Configura le impostazioni per il nuovo cluster in cui verrà ripristinato il punto di ripristino.

   1. Per impostazione predefinita, verrà utilizzata l'AMK (chiave AWS gestita) per crittografare i dati ripristinati. In alternativa, è possibile specificare una chiave diversa.

   1. La [protezione da eliminazione](https://docs.aws.amazon.com/AmazonRDS/latest/AuroraUserGuide/USER_DeleteCluster.html#USER_DeletionProtection) per i cluster Aurora è abilitata per impostazione predefinita, ma deseleziona la casella per disattivare l'opzione.

1. **Rivedi le impostazioni; quando sono soddisfacenti, seleziona il pulsante Ripristina backup.**

AWS Backup creerà un nuovo cluster Aurora DSQL.

------
#### [ AWS CLI ]

**Ripristino in una singola regione**

1. Usa il comando CLI `aws backup start-restore-job` per ripristinare un cluster Aurora dal punto di ripristino specificato.

1. Includi i metadati necessari per il processo di ripristino. Esempio:  
**Example**  

   ```
   aws backup start-restore-job \
       --recovery-point-arn "arn:aws:dsql:us-east-1:123456789012:cluster/example-cluster/backup/example-backup" \
       --iam-role-arn "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole" \
       --metadata '{"regionalConfig":"[{\"region\":\"us-east-1\",\"isDeletionProtectionEnabled\":true,\"kmsKeyId\":\"my_key\"}]"}' \
       --copy-source-tags-to-restored-resource
   ```

------

## Ripristina un cluster multiregionale Aurora DSQL
<a name="restore-auroradsql-multiregion"></a>

Il ripristino del cluster multiregionale Aurora DSQL avviene all'interno di una tripletta di regioni chiusa, che è un gruppo di tre peer. Regioni AWS Il ripristino multiregionale richiede che le regioni specificate nell'operazione siano contenute in una tripletta. [Per ulteriori informazioni sui cluster multiregionali, vedere Configurazione dei cluster multiregionali.](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/configuring-multi-region-clusters.html)

Sono supportate le triplette dei seguenti gruppi. Se ci sono più di regioni, scegline tre nello stesso gruppo.
+ Stati Uniti orientali (Virginia settentrionale); Stati Uniti orientali (Ohio); Stati Uniti occidentali (California settentrionale)
+ Europa (Irlanda); Europa (Londra); Europa (Parigi); Europa (Francoforte)
+ Asia Pacifico (Tokyo); Asia Pacifico (Seoul); Asia Pacifico (Osaka)

Per completare il ripristino multiregionale, assicurati di disporre delle seguenti autorizzazioni:
+ `backup:StartRestoreJob`
+ `dsql:UpdateCluster`
+ `dsql:AddPeerCluster`
+ `dsql:RemovePeerCluster`

È possibile ripristinare un backup di un cluster Aurora DSQL in più regioni utilizzando la console AWS Backup o i comandi CLI.

**Suggerimento**  
Se disponi di un piano di backup con una regola che crea automaticamente una copia interregionale in una delle regioni indicate, la copia creata può essere utilizzata per questo ripristino multiregionale.

Il ripristino in più regioni inizia con la regione corrente. Avrai anche bisogno di:
+ Regione peer con una copia identica in più regioni del punto di ripristino nella regione corrente
+ Witness Region, una regione designata Regione AWS che partecipa alle configurazioni di cluster multiregionali supportando le scritture solo nei registri delle transazioni senza consumare spazio di archiviazione per i dati effettivi. [Per ulteriori informazioni sulle regioni di riferimento, vedere Creazione di un cluster multiregionale.](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/getting-started.html#getting-started-multi-region)

I singoli passaggi sono illustrati di seguito:

------
#### [ Console ]

La AWS Backup console ora supporta il ripristino multiregionale per i cluster Aurora DSQL, fornendo un processo semplificato per la creazione di cluster che si estendono su più regioni. [Per ulteriori informazioni sui cluster multiregionali, consulta Configurazione dei cluster multiregionali.](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/configuring-multi-region-clusters.html)

1. [Accedi alla console di AWS gestione e apri la console in /backup. AWS Backup https://console.aws.amazon.com](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione scegliere **Backup vaults (Vault di backup)**.

1. Scegli l'archivio di backup che contiene il punto di ripristino Aurora DSQL che desideri ripristinare.

1. **Seleziona il punto di ripristino che desideri ripristinare, quindi scegli Ripristina.**

1. Nella pagina di ripristino, in **Opzioni di ripristino**, seleziona **Aggiungi regioni peer per abilitare il ripristino in più regioni**.

1. Seleziona una **regione del cluster peer** dal menu a discesa. Questa regione deve trovarsi all'interno della stessa tripletta della regione corrente e deve contenere anche una copia interregionale dal punto di ripristino nella (prima) regione corrente.

1. Seleziona una **regione di riferimento** dal menu a discesa. Anche questa regione deve rientrare nella stessa tripletta.

1. Configura le **impostazioni del cluster** per i cluster primari e peer Region:

   1. Per il cluster primario, configura:
      + **Crittografia del cluster** (opzionale): seleziona una chiave KMS per la crittografia.
      + **Protezione da eliminazione**: abilita o disabilita la protezione da eliminazione.

   1. Per il cluster Peer Region, configura:
      + **Crittografia del cluster Peer Region (opzionale): seleziona una chiave KMS per la crittografia**.
      + Protezione dall'**eliminazione del cluster Peer Region: abilita o disabilita la protezione** dall'eliminazione.

1. Controlla le impostazioni e scegli **Ripristina backup**.

1. La console avvierà il processo di ripristino multiregionale, che crea cluster in entrambe le regioni e li collega automaticamente tra loro.

------
#### [ AWS CLI ]

Il ripristino multiregionale può ora essere ottenuto utilizzando i nuovi metadati di ripristino orchestrati con AWS Backup comandi CLI. Questo approccio semplifica il processo gestendo automaticamente il collegamento del cluster. Per ulteriori informazioni sulla creazione di cluster multiregione a livello di codice, vedere [Configurazione di cluster multiregione nella Guida per l'utente di Aurora DSQL](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/configuring-multi-region-clusters.html).

**Importante**  
Sia il cluster primario che il cluster peer devono trovarsi in regioni all'interno dello stesso gruppo. L'operazione avrà esito negativo se i cluster si trovano in regioni esterne al gruppo. I gruppi supportati includono:  
Stati Uniti orientali (Virginia settentrionale); Stati Uniti orientali (Ohio); Stati Uniti occidentali (California settentrionale)
Europa (Irlanda); Europa (Londra); Europa (Parigi); Europa (Francoforte)
Asia Pacifico (Tokyo); Asia Pacifico (Seoul); Asia Pacifico (Osaka)

**Ripristino in più regioni tramite l' AWS CLI utilizzo di metadati di ripristino orchestrati**

1. Crea un processo di ripristino utilizzando il comando CLI `aws backup start-restore-job` con i nuovi metadati di orchestrazione multiregione:  
**Example**  

   ```
   aws backup start-restore-job \
   --recovery-point-arn "arn:aws:backup:us-east-1:123456789012:recovery-point:abcd1234" \
   --iam-role-arn "arn:aws:iam::123456789012:role/service-role/AWSBackupDefaultServiceRole" \
   --metadata '{
       "witnessRegion":"us-west-1",
       "useMultiRegionOrchestration":"true",
       "peerRegion":"[\"us-east-2\"]",
       "regionalConfig":"[{\"region\":\"us-east-1\",\"isDeletionProtectionEnabled\":true,\"kmsKeyId\":\"arn:aws:kms:us-east-1:123456789012:key/ba4b3773-4bb8-4a7a-994c-46ede70202f5\"},{\"region\":\"us-west-2\",\"isDeletionProtectionEnabled\":true,\"kmsKeyId\":\"arn:aws:kms:us-west-2:123456789012:key/ba4b3773-4bb8-4a7a-994c-46ede70202f5\"}]"
   }' \
   --copy-source-tags-to-restored-resource
   ```

   La struttura dei metadati include:
   + `witnessRegion`: La regione che fungerà da testimone per il cluster multiregionale. Per ulteriori informazioni, consulta [Resilience in Amazon Aurora](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/disaster-recovery-resiliency.html) DSQL.
   + `useMultiRegionOrchestration`: impostato per abilitare l'orchestrazione `true` multiregionale.
   + `peerRegion`: Un array contenente le regioni con cluster peer nel cluster multiregionale. Per ulteriori informazioni, consulta [MultiRegionProperties](https://docs.aws.amazon.com/aurora-dsql/latest/APIReference/API_MultiRegionProperties.html)Aurora DSQL API Reference.
   + `regionalConfig`: Un array contenente la configurazione per ogni regione:
     + `region`: L' Regione AWS identificatore.
     + `isDeletionProtectionEnabled`: contrassegno booleano per enable/disable la protezione dall'eliminazione. Per ulteriori informazioni, consulta [CreateCluster](https://docs.aws.amazon.com/aurora-dsql/latest/APIReference/API_CreateCluster.html#API_CreateCluster_RequestSyntax)Aurora DSQL API Reference.
     + `kmsKeyId`: l'ARN della chiave KMS per la crittografia (opzionale).

     Se `regionalConfig` le proprietà non vengono specificate, verranno applicati i valori predefiniti: crittografia predefinita e `isDeletionProtectionEnabled` =. `TRUE`

1. Monitora lo stato del processo di ripristino utilizzando il `aws backup describe-restore-job` comando:

   ```
   aws backup describe-restore-job --restore-job-id job-12345678
   ```

1. Una volta completato il processo di ripristino, puoi verificare la configurazione del cluster multiregione utilizzando la CLI Aurora DSQL:

   ```
   aws dsql describe-cluster --cluster-identifier your-cluster-id
   ```

   Per ulteriori informazioni sulle operazioni di cluster multiregione, vedere [UpdateCluster](https://docs.aws.amazon.com/aurora-dsql/latest/APIReference/API_UpdateCluster.html)Aurora DSQL API Reference.

------

## Risolvi i problemi di ripristino di Aurora DSQL
<a name="restore-auroradsql-troubleshoot"></a>

**Errore: autorizzazioni insufficienti**

**Possibile causa:** se si tenta di copiare un punto di ripristino Aurora DSQL in un account (copia tra account) che non ha mai interagito con l'API DSQL, è possibile che si verifichi un errore di autorizzazione poiché il ruolo collegato al servizio DSQL non è impostato nell'account di destinazione.

**Rimedio:** collega la [policy gestita DSQL](https://docs.aws.amazon.com/aurora-dsql/latest/userguide/working-with-service-linked-roles.html) che include il ruolo collegato al servizio DSQL a un ruolo nell'account di destinazione. [AuroraDsqlServiceLinkedRolePolicy](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/             AuroraDsqlServiceLinkedRolePolicy.html)

Se riscontri altri problemi con il processo di backup o ripristino, puoi controllare lo stato dei processi di backup e ripristino nella AWS Backup console o utilizzando il. AWS CLI Inoltre, puoi esaminare AWS CloudTrail i log per eventuali messaggi di errore o eventi pertinenti relativi alle tue AWS Backup operazioni.

## Domande frequenti sul ripristino DSQL di Aurora
<a name="restore-auroradsql-faq"></a>

1. *«Posso usare AWS Backup per Aurora DSQL dalla console Aurora DSQL?»*

   No, puoi eseguire backup e ripristini, oltre a gestire i backup, solo dalla AWS Backup console, dall'SDK o dalla CLI.

   

1. *«Quale granularità di backup è disponibile per Aurora DSQL? Posso eseguire il backup di tabelle o database specifici nel mio cluster?»*

   È possibile eseguire il backup e il ripristino solo di un intero cluster Aurora DSQL. 

   

1. *«I backup di Aurora DSQL sono backup completi o incrementali?»*

   I punti di ripristino dei cluster Aurora DSQL (backup) sono backup completi dei cluster.

   

1. *«Posso creare backup per i miei cluster multiregionali Aurora DSQL?»*

   Sì, è possibile creare backup per ogni cluster in cluster multiregionali utilizzando gli stessi passaggi utilizzati per creare un backup di un singolo cluster in una singola regione.

    AWS Backup come procedura consigliata, consiglia di creare una copia interregionale del backup nell'altra regione da cui si intende ripristinare il cluster multiregione, poiché il ripristino multiregionale richiede una copia identica dello stesso punto di ripristino [*identico* in questa operazione significa che i punti di ripristino hanno lo stesso nome di risorsa e la stessa ora di creazione].

   

1. *«Il cluster ripristinato sovrascriverà il cluster esistente?»*

   No. Quando ripristini i dati di Aurora DSQL, AWS Backup crea un nuovo cluster dalle tue istantanee; il cluster ripristinato non sovrascriverà il cluster di origine.

   

# Ripristina gli stack CloudFormation
<a name="restore-application-stacks"></a>

Un backup CloudFormation composito è una combinazione di un CloudFormation modello e di tutti i punti di ripristino annidati associati. È possibile ripristinare un numero qualsiasi di punti di ripristino nidificati, ma il punto di ripristino composito (che è il punto di ripristino di primo livello) non può essere ripristinato.

Quando si ripristina un punto di ripristino del CloudFormation modello, si crea un nuovo stack con un set di modifiche per rappresentare il backup.

## Esegui il ripristino CloudFormation con la console AWS Backup
<a name="restoring-stack-console"></a>

Dalla [CloudFormation console](https://console.aws.amazon.com/cloudformation/) puoi vedere il nuovo stack e il nuovo set di modifiche. Per ulteriori informazioni sui set di modifiche, consulta [Aggiornamento di stack utilizzando i set di modifiche](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/using-cfn-updating-stacks-changesets.html) nella *Guida per l'utente di CloudFormation *.

Determina da quali punti di ripristino annidati desideri eseguire il ripristino con CloudFormation lo stack, quindi ripristinali utilizzando la console. AWS Backup 

1. [Apri la AWS Backup console in /backup. https://console.aws.amazon.com](https://console.aws.amazon.com/backup)

1. Passa a **Vault di backup**, seleziona il vault di backup contenente il punto di ripristino desiderato, quindi fai clic su **Punti di ripristino**.

1. Ripristina il punto CloudFormation di ripristino del modello.

   1. Fai clic sul punto di ripristino composito contenente i punti di ripristino nidificati che desideri ripristinare per visualizzare la pagina Dettagli relativa al punto di ripristino composito.

   1. In **Punti di ripristino nidificati**, verranno visualizzati i punti di ripristino nidificati. Ogni punto di ripristino avrà un ID del punto di ripristino, uno stato, un ID risorsa, un tipo di risorsa, un tipo di backup e l'ora di creazione del punto di ripristino. Fai clic sul pulsante di opzione accanto al punto di CloudFormation ripristino, quindi fai clic su **Ripristina**. Assicurati di selezionare il punto di ripristino con il **tipo di risorsa: CloudFormation** e il **tipo di backup: backup.** 

1. Una volta completato il processo di ripristino del CloudFormation modello, il CloudFormation modello ripristinato sarà visibile nella [CloudFormation console](https://console.aws.amazon.com/cloudformation/) sotto **Stacks**.

1. In **Nomi stack** è disponibile il modello ripristinato con lo stato di `REVIEW_IN_PROGRESS`.

1. Fai clic sul nome dello stack per visualizzarne i relativi dettagli.

1. Sotto il nome dello stack sono disponibili delle schede. Fai clic su **Set di modifiche**.

1. Esegui il set di modifiche.

1. Dopo questi processi, le risorse nello stack originale verranno ricreate nel nuovo stack. Le risorse stateful verranno ricreate vuote. Per ripristinare le risorse stateful, torna all'elenco dei punti di ripristino nella AWS Backup console, seleziona il punto di ripristino necessario e avvia un ripristino.

**Nota**  
Se un'operazione di CloudFormation ripristino fallisce, lo stack può rimanere nello `REVIEW_IN_PROGRESS` stato con un set di modifiche. `FAILED` Eliminate questi stack manualmente per evitare conflitti di denominazione quando riprovate a eseguire l'operazione di ripristino.  
 Per ulteriori informazioni, consultare [Deleting a stack](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/cfn-console-delete-stack.html) nella *Guida per l'utente di AWS CloudFormation *.

## Ripristina con CloudFormation AWS CLI
<a name="restoring-cfn-cli"></a>

Nell'interfaccia a riga di comando, [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/start-restore-job.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/start-restore-job.html)consente di ripristinare uno CloudFormation stack.

L'elenco seguente contiene i metadati accettati per ripristinare una CloudFormation risorsa.

```
// Mandatory metadata:
ChangeSetName // This is the name of the change set which will be created
StackName // This is the name of the stack that will be created by the new change set
        
// Optional metadata:
ChangeSetDescription // This is the description of the new change set
StackParameters // This is the JSON of the stack parameters required by the stack
aws:backup:request-id
```

# Ripristino di un cluster DocumentDB
<a name="restoring-docdb"></a>

## Usa la AWS Backup console per ripristinare i punti di ripristino di Amazon DocumentDB
<a name="docdb-restore-console"></a>

Per ripristinare un cluster Amazon DocumentDB è necessario specificare più opzioni di ripristino. Per informazioni su queste opzioni, consulta [Ripristino da uno snapshot del cluster](https://docs.aws.amazon.com/documentdb/latest/developerguide/backup_restore-restore_from_snapshot.html) nella *Guida per gli sviluppatori di Amazon DocumentDB*.

**Per ripristinare un cluster Amazon DocumentDB**

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette** e l'ID della risorsa Amazon DocumentDB che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Per ripristinare una risorsa, nel riquadro **Backup** scegliere il pulsante di opzione accanto all'ID del punto di ripristino della risorsa. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. Assicurati di essere sulla pagina della console **Ripristina gli snapshot del cluster Amazon DocumentDB**.

1. Per **le opzioni di ripristino**, puoi configurare quanto segue:
   + **Versione del motore**: selezionare la versione del motore DocumentDB per il cluster ripristinato.
**Nota**  
La classe e il numero di istanze non possono essere configurati durante il processo di ripristino. Il cluster DocumentDB ripristinato utilizzerà la configurazione di istanza predefinita. Puoi modificare la classe dell'istanza e aggiungere o rimuovere istanze al termine del ripristino utilizzando la console o l'API di Amazon DocumentDB.

1. Nel riquadro **Impostazioni**, inserisci un nome univoco per l'identificatore del cluster DB.

   È possibile utilizzare lettere, numeri e trattini, ma non è possibile avere due trattini consecutivi o terminare il nome con un trattino. Il nome finale sarà tutto minuscolo.

1. Nel riquadro **Opzioni del database**, seleziona la porta del database.

   Questa è la TCP/IP porta che l'istanza o il cluster DB utilizzerà per le connessioni alle applicazioni. La stringa di connessione di qualsiasi applicazione che si connette all’istanza database o al cluster di database deve specificare il numero di porta corrispondente. Sia il gruppo di sicurezza applicato all'istanza o al cluster DB che i firewall dell'organizzazione devono consentire le connessioni alla porta. Tutte le istanze database in un cluster di database utilizzano la stessa porta.

1. Inoltre, nel riquadro **Opzioni del database**, selezionate il gruppo di parametri del cluster DB.

   Questo è il gruppo di parametri associato al cluster DB di questa istanza. Il gruppo di parametri cluster di database funge da container per i valori di configurazione del motore applicati a ogni istanza database nel cluster.

1. Nel riquadro **Crittografia**, seleziona la chiave che verrà utilizzata per crittografare questo volume di database. Il valore predefinito è `aws/rds`. In alternativa, puoi utilizzare una chiave gestita dal cliente (CMK).

1. Nel riquadro **Esportazioni dei log**, scegli i tipi di log da pubblicare su Amazon CloudWatch Logs. Il **ruolo IAM** è già definito. 

1. Nel riquadro del **ruolo di ripristino**, scegli il ruolo IAM predefinito per il processo di ripristino o un ruolo IAM diverso.

1. Nel riquadro Protected resource tags, puoi facoltativamente scegliere di copiare i tag dal backup al cluster di database ripristinato.

1. Dopo aver specificato tutte le impostazioni, scegli **Ripristina backup**.

   Viene visualizzato il riquadro **Lavori di ripristino**. Un messaggio nella parte superiore della pagina fornisce informazioni sul lavoro di ripristino.

1. Al termine del ripristino, collega il cluster Amazon DocumentDB ripristinato a un'istanza Amazon RDS.

## Usa l' AWS Backup API, la CLI o l'SDK per ripristinare i punti di ripristino di Amazon DocumentDB
<a name="docdb-restore-cli"></a>

Innanzitutto, ripristina il cluster. Utilizza `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`. Durante i ripristini di Amazon DocumentDB puoi specificare i seguenti metadati:

```
availabilityZones
backtrackWindow
copyTagsToSnapshot // Boolean 
databaseName // string 
dbClusterIdentifier // string 
dbClusterParameterGroupName // string 
dbSubnetGroupName // string 
enableCloudwatchLogsExports // string 
enableIAMDatabaseAuthentication // Boolean 
engine // string 
engineMode // string 
engineVersion // string 
kmsKeyId // string 
port // integer 
optionGroupName // string 
scalingConfiguration
vpcSecurityGroupIds // string
```

 Quindi, collega il cluster Amazon DocumentDB ripristinato a un'istanza Amazon RDS utilizzando. `create-db-instance`
+ Per Linux, macOS o Unix:

  ```
  aws docdb create-db-instance --db-instance-identifier sample-instance / 
                    --db-cluster-identifier sample-cluster --engine docdb --db-instance-class db.r5.large
  ```
+ Per Windows:

  ```
  aws docdb create-db-instance --db-instance-identifier sample-instance ^ 
                    --db-cluster-identifier sample-cluster --engine docdb --db-instance-class db.r5.large
  ```

# Ripristina una tabella Amazon DynamoDB
<a name="restoring-dynamodb"></a>

## Usa la AWS Backup console per ripristinare i punti di ripristino DynamoDB
<a name="ddb-restore-console"></a>

**Per ripristinare una tabella DynamoDB**

1. [Apri la AWS Backup console in /backup. https://console.aws.amazon.com](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette** e l'ID della risorsa DynamoDB che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Per ripristinare una risorsa, nel riquadro **Backup** scegliere il pulsante di opzione accanto all'ID del punto di ripristino della risorsa. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. In **Impostazioni**, nel campo di testo**Nuovo nome tabella** immettere un nuovo nome di tabella.

1. Per il **ruolo Restore**, scegli il ruolo IAM che AWS Backup assumerai per questo ripristino.

1. Per **Impostazioni di crittografia**:

   1. Se il backup è gestito da DynamoDB (il suo ARN inizia `arn:aws:dynamodb` con) AWS Backup , cripta la tabella ripristinata utilizzando una chiave di proprietà. AWS

      Per scegliere una chiave diversa per crittografare la tabella ripristinata, è possibile utilizzare l' AWS Backup [StartRestoreJoboperazione](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html) o eseguire il ripristino dalla console [DynamoDB](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/Restore.Tutorial.html#restoretable_console).

   1. Se il backup supporta la AWS Backup gestione completa (il relativo ARN inizia con`arn:aws:backup`), puoi scegliere una delle seguenti opzioni di crittografia per proteggere la tabella ripristinata:
      + (Impostazione predefinita) Chiave KMS di proprietà di DynamoDB (nessun costo aggiuntivo per la crittografia)
      + Chiave KMS gestita da DynamoDB (soggetta ai costi KMS)
      + Chiave KMS gestita dal cliente (soggetta ai costi KMS)

      Le chiavi "di proprietà di DynamoDB" e "gestite da DynamoDB" sono identiche alle chiavi "di proprietà di AWS" e "di proprietà di AWS", rispettivamente. Per chiarezza, consulta [Crittografia dei dati inattivi: come funziona](https://docs.aws.amazon.com/amazondynamodb/latest/developerguide/encryption.howitworks.html) nella *Guida per gli sviluppatori di Amazon DynamoDB*.

      Per ulteriori informazioni sulla AWS Backup gestione completa, vedere[Backup di DynamoDB avanzato](advanced-ddb-backup.md).
**Nota**  
Le seguenti linee guida si applicano solo se si ripristina un backup copiato E si desidera crittografare la tabella ripristinata con la stessa chiave utilizzata per crittografare la tabella originale.  
Quando si ripristina un backup interregionale, per crittografare la tabella ripristinata utilizzando la stessa chiave utilizzata per crittografare la tabella originale, è necessario che la chiave sia una chiave multiregionale. AWS Le chiavi possedute e gestite non sono chiavi AWS multiregionali. Per ulteriori informazioni, consulta [Chiavi multi-regione](https://docs.aws.amazon.com/kms/latest/developerguide/multi-region-keys-overview.html) nella *Guida per gli sviluppatori di AWS Key Management Service *.  
Quando si ripristina un backup su più account, per crittografare la tabella ripristinata utilizzando la stessa chiave utilizzata per crittografare la tabella originale, è necessario condividere la chiave dell'account di origine con l'account di destinazione. AWS Le chiavi -owned e AWS-managed non possono essere condivise tra account. Per ulteriori informazioni, consulta [Consentire agli utenti in altri account di utilizzare una chiave KMS](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying-external-accounts.html) nella *Guida per gli sviluppatori di AWS Key Management Service *.

1. Scegli **Restore backup (Ripristina backup)**.

   Viene visualizzato il riquadro **Lavori di ripristino**. Un messaggio nella parte superiore della pagina fornisce informazioni sul lavoro di ripristino.

## Utilizza l' AWS Backup API, la CLI o l'SDK per ripristinare i punti di ripristino DynamoDB
<a name="ddb-restore-cli"></a>

Utilizza `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`. Durante i ripristini di DynamoDB è possibile specificare i seguenti metadati. I metadati non rilevano la distinzione tra maiuscole e minuscole.

```
targetTableName
encryptionType
kmsMasterKeyArn
aws:backup:request-id
```

Di seguito è riportato un esempio dell'argomento `restoreMetadata` per un'operazione `StartRestoreJob` nella CLI:

```
aws backup start-restore-job \
--recovery-point-arn "arn:aws:backup:us-east-1:123456789012:recovery-point:abcdef12-g3hi-4567-8cjk-012345678901" \
--iam-role-arn "arn:aws:iam::123456789012:role/YourIamRole" \
--metadata 'TargetTableName=TestRestoreTestTable,EncryptionType=KMS,kmsMasterKeyArn=arn:aws:kms:us-east-1:123456789012:key/abcdefg' \
--region us-east-1 \
--endpoint-url https://endpointurl.com
```

L'esempio precedente crittografa la tabella ripristinata utilizzando una chiave gestita dal cliente.

Per crittografare la tabella ripristinata utilizzando una chiave di AWS proprietà, specifica i seguenti metadati di ripristino:. `"encryptionType\":\"Default\"`

Per crittografare la tabella ripristinata utilizzando una chiave AWS-managed, ometti il parametro e specifica:. `kmsMasterKeyArn` `"encryptionType\":\"KMS\"`

Per crittografare la tabella ripristinata utilizzando una chiave gestita dal cliente, specifica i seguenti metadati di ripristino:. `"encryptionType\":\"KMS\",\"kmsMasterKeyArn\":\"arn:aws:kms:us-west-2:111122223333:key/1234abcd-12ab-34cd-56ef-1234567890ab\"`

# Ripristino di un volume Amazon EBS
<a name="restoring-ebs"></a>

Quando ripristini uno snapshot di Amazon Elastic Block Store (EBS), puoi scegliere di ripristinarlo come volume EBS, ripristinarlo su un volume o ripristinare elementi selezionati da esso in un Gateway di archiviazione AWS bucket Amazon S3.

## Ripristina su un volume EBS
<a name="restore-to-ebs-volume"></a>

Quando ripristini un'istantanea (backup periodico dei dati EBS) su un nuovo volume, specifichi il tipo di volume, la dimensione in GiB e una zona di disponibilità. Facoltativamente, puoi scegliere di crittografare il nuovo volume con una chiave esistente o nuova. AWS KMS 

## Ripristina su un volume gateway
<a name="restore-to-gateway-volume"></a>

Quando si esegue il ripristino su un volume gateway, è necessario specificare un gateway in uno stato raggiungibile, scegliere il nome di destinazione iSCSI e scegliere un ID disco se il gateway è un volume archiviato o una capacità uguale o superiore alla snapshot se il gateway è memorizzato nella cache di volume.

## Ripristino a livello di file in un bucket Amazon S3
<a name="restore-to-s3-bucket"></a>

Prima di iniziare un processo di ripristino delle risorse EBS su un bucket Amazon S3, [esamina le autorizzazioni [Autorizzazioni di ripristino Amazon S3](restoring-s3.md#s3-restore-permissions) EBS](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSBackupServiceRolePolicyForRestores.html) e i requisiti di accesso. Le autorizzazioni necessarie sono contenute nella policy gestita [AWSBackupServiceRolePolicyForItemRestores](security-iam-awsmanpol.md#AWSBackupServiceRolePolicyForItemRestores)e devono essere incluse nel [ruolo IAM](authentication.md) utilizzato per l'operazione di ripristino.

Tutti i caricamenti di nuovi oggetti, inclusi i dati ripristinati, su un bucket S3 vengono crittografati automaticamente. Quando scegli questo tipo di ripristino, specifica SSE-S3 (chiave gestita Amazon S3 lato server) o SSE-KMS (chiave gestita lato server). AWS KMS SSE-S3 è l'impostazione predefinita.

È possibile inserire fino a cinque percorsi durante il ripristino dalla AWS Backup console; è possibile specificare più percorsi tramite la riga di comando. Un percorso deve avere una lunghezza inferiore a 1024 byte nelle stringhe con codifica UTF-8, inclusi i prefissi designati e designati dall'utente AWS Backup

Se l'istantanea contiene più partizioni, specifica l'identificatore del file system della partizione che contiene i dati che intendi ripristinare. Questo identificatore può essere trovato utilizzando [Ricerca nei backup](backup-search.md) ed è lo stesso dell'UUID o dell'ID del disco del file system.


|  | Al nuovo volume EBS | Al gateway | Ripristino a livello di file nel bucket S3 | 
| --- | --- | --- | --- | 
| Encryption (Crittografia) | Facoltativo. Puoi scegliere una AWS KMS chiave esistente o creare una nuova chiave KMS. |  | Obbligatorio. Scegli tra SSE-S3, SSE-KMS o la crittografia predefinita del bucket di destinazione 1. | 
| Autorizzazioni e ruoli | Scegli il ruolo esistente; se non ne esiste nessuno, viene creato il ruolo predefinito con le autorizzazioni corrette. | Scegli il ruolo esistente; se non ne esiste nessuno, viene creato il ruolo predefinito con le autorizzazioni corrette | La scelta del ruolo deve avere un numero sufficiente di [EBS e.](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSBackupServiceRolePolicyForRestores.html) [Autorizzazioni di ripristino Amazon S3](restoring-s3.md#s3-restore-permissions) | 
| Ripristino da cold storage (EBS Archive Tier) | Disponibilità | Non disponibile | Non disponibile | 
| Impostazioni da specificare | Tipo di volume; dimensione (GiB); zona di disponibilità; velocità effettiva | Gateway (in uno stato raggiungibile); nome di destinazione iSCSI; ID del disco (per i gateway archiviati in volume); capacità (per i gateway con cache di volume) | Tipo di ripristino, tra cui: nome del bucket di destinazione; percorsi da ripristinare; tipo di crittografia; ID chiave KMS di ripristino a livello di file se SSE-KMS è impostato come tipo di crittografia | 

1 Nella AWS Backup console, selezionate una delle tre opzioni di crittografia; se utilizzate la CLI per il ripristino, omettete di ripristinare la `encryptionType` crittografia predefinita del bucket di destinazione.

## Ripristina un'istantanea EBS con la console AWS Backup
<a name="ebs-restore-console"></a>

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, seleziona **Risorse protette**, quindi scegli l'ID della risorsa EBS che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Per ripristinare una risorsa, nel riquadro **Backup** scegliere il pulsante di opzione accanto all'ID del punto di ripristino della risorsa. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. Specificare i parametri di ripristino per la risorsa. I parametri di ripristino immessi sono specifici del tipo di risorsa selezionato.

   Per **Tipo di risorsa**, scegli la AWS risorsa da creare durante il ripristino di questo backup.

1. Se si sceglie **Volume EBS**, specificare i valori per **Tipo di volume**, **Dimensioni (GiB)**, e scegliere una **Zona di disponibilità**. Dopo **Velocità di trasmissione effettiva**, sarà visualizzata una casella di controllo opzionale **Crittografa questo volume**. *Questa opzione rimarrà attiva se il punto di ripristino EBS è crittografato.* . È possibile specificare una chiave KMS o creare una AWS KMS chiave.

   Se scegli **Volume Storage Gateway**, seleziona un **Gateway** in uno stato raggiungibile. Scegli anche **Nome di destinazione iSCSI**. Per gateway *Volume archiviato*, scegli un **ID disco**. Per gateway *Volume memorizzato nella cache*, scegli una capacità pari almeno alla risorsa protetta.

   Se scegli **il ripristino a livello di file**, puoi includere fino a 5 oggetti o cartelle dall'istantanea. Puoi [cercare nei backup indicizzati](backup-search.md) per trovare il nome o il percorso del file.
   + Inserisci i percorsi dei file.
   + Scegli di utilizzare un bucket Amazon S3 esistente o crearne uno nuovo per la destinazione in cui verranno ripristinati gli oggetti o le cartelle.
   + Imposta la crittografia degli oggetti ripristinati. È possibile scegliere la crittografia predefinita del bucket di destinazione, SSE-S3 o SSE-KMS. Per [Ripristina i dati S3 utilizzando AWS Backup](restoring-s3.md) ulteriori dettagli, vedere.

1. Per il **ruolo Restore**, scegli il ruolo IAM che AWS Backup assumerai per questo ripristino. Se il ruolo AWS Backup predefinito non è presente nel tuo account, viene creato un **ruolo predefinito** con le autorizzazioni corrette. Puoi eliminare questo ruolo predefinito o renderlo inutilizzabile.

1. Scegli **Ripristina backup** (**gli elementi di ripristino** vengono visualizzati per il ripristino a livello di file).

   Verrà visualizzato il riquadro **Restore jobs**. Un messaggio nella parte superiore della pagina fornisce informazioni sul lavoro di ripristino.

### Ripristina da istantanee EBS archiviate
<a name="restore-archived-ebs"></a>

Il ripristino di uno snapshot EBS archiviato lo sposta temporaneamente dall'archiviazione a freddo a quella a caldo per creare un nuovo volume EBS. Questo tipo di ripristino comporta un costo di recupero una tantum. I costi per l'archiviazione a caldo e a freddo vengono fatturati durante il periodo di ripristino.

**Suggerimento**  
I volumi EBS in cold storage non possono essere ripristinati su un volume gateway o ripristinati a livello di file. 

È possibile ripristinare uno snapshot EBS archiviato nell'archiviazione a freddo utilizzando la [console AWS Backup](https://console.aws.amazon.com/backup/) o la riga di comando. Il ripristino dall'archiviazione a freddo può richiedere fino a 72 ore. Per ulteriori informazioni, consulta [Snapshot Archive Amazon EBS](https://docs.aws.amazon.com/ebs/latest/userguide/snapshot-archive.html) nella *Guida per l'utente di Amazon EBS*.

------
#### [ Console ]

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Vai a **Backup vault** > *Vault* > **Ripristina istantanea EBS archiviata**.

1. Nella sezione **Impostazioni** inserisci un valore compreso tra 0 e 180 inclusi, per indicare il numero di giorni del periodo di ripristino temporaneo di uno snapshot archiviato.

1. Immetti altre impostazioni: tipo di volume, dimensione, IOPS, zona di disponibilità, velocità di trasmissione effettiva e crittografia.

1. Scegli il **ruolo di ripristino**.

1. Seleziona **Ripristina backup**. Nella finestra popup che viene visualizzata, verifica gli snapshot e il tipo di ripristino. Quindi, seleziona **Ripristina snapshot**.

------
#### [ AWS CLI ]

1. Utilizzare [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/start-restore-job.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/start-restore-job.html)

1. Includi i parametri richiesti per il ripristino degli snapshot EBS archiviati:

   ```
   --recovery-point-arn arn:aws:backup:region:account-id:recovery-point:recovery-point-id
   --metadata '{"temporaryRestoreDays":"value","volumeType":"value","volumeSize":"value","availabilityZone":"value"}'
   --iam-role-arn arn:aws:iam::account-id:role/service-role/AWSBackupDefaultServiceRole
   --resource-type EBS
   ```

1. Specificare la durata del ripristino temporaneo (0-180 giorni) nel parametro. `temporaryRestoreDays` Ciò determina per quanto tempo l'istantanea archiviata sarà disponibile nella memoria a caldo.

1. Configura le nuove impostazioni del volume EBS tra cui `volumeType` (gp2, gp3, io1, io2, st1, sc1), in GiB e target. `volumeSize` `availabilityZone`

1. Monitora lo stato del processo di ripristino utilizzando l'ID del processo di ripristino restituito. [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/describe-restore-job.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/describe-restore-job.html) Il completamento dei ripristini degli archivi può richiedere fino a 72 ore.

------

## Ripristina un'istantanea EBS tramite AWS CLI
<a name="ebs-restore-cli"></a>

Per ripristinare Amazon EBS utilizzando l'API o la CLI, utilizza `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`. Puoi specificare i seguenti metadati durante un ripristino di Amazon EBS:

```
aws:backup:request-id
availabilityZone
encrypted // if set to true, encryption will be enabled as volume is restored
iops
kmsKeyId // if included, this key will be used to encrypt the restored volume instead of default KMS Key Id
restoreType // include for file level restore - see details below
throughput
temporaryRestoreDays
volumeType
volumeSize
```

Esempio:

```
"restoreMetadata": "{\"encrypted\":\"false\",\"volumeId\":\"vol-04cc95f3490b5ceea\",\"availabilityZone\":null}"
```

**Specifiche di ripristino a livello di file**

`restoreType`è necessario per il ripristino a livello di file. Per questo tipo di ripristino, sono necessari i seguenti metadati univoci:

```
destinationBucketName //
pathsToRestore //
encryptionType // You can specify SSE-S3 or SSE-KMS; do not include if you want to restore to default encryption
kmsKeyId //
```

L'identificatore del filesystem è facoltativo per le istantanee a partizione singola. Se queste informazioni non vengono trasmesse, verrà accettato solo il percorso assoluto senza il separatore «:» (ad esempio). `{"/data/process/abc.txt", "/data/department/xyz.txt"}`

# Ripristina un'istanza Amazon EC2
<a name="restoring-ec2"></a>

Quando ripristini un'istanza EC2, AWS Backup crea un'Amazon Machine Image (AMI), un'istanza, il volume root di Amazon EBS, i volumi di dati Amazon EBS (se la risorsa protetta aveva volumi di dati) e gli snapshot di Amazon EBS. Puoi personalizzare alcune impostazioni dell'istanza utilizzando la AWS Backup console o un numero maggiore di impostazioni utilizzando o un SDK. AWS CLI AWS 

Le seguenti considerazioni si applicano al ripristino delle istanze EC2:
+ AWS Backup configura l'istanza ripristinata per utilizzare la stessa coppia di chiavi utilizzata originariamente dalla risorsa protetta. Non è possibile specificare una coppia di chiavi diversa per l'istanza ripristinata durante il processo di ripristino.
+ AWS Backup non esegue il backup e il ripristino dei dati utente utilizzati durante l'avvio di un'istanza Amazon EC2.
+ Quando configuri l'istanza ripristinata, puoi scegliere tra l'utilizzo dello stesso profilo di istanza utilizzato originariamente dalla risorsa protetta o l'avvio senza un profilo di istanza. In questo modo si impediscono possibili escalation dei privilegi. Puoi aggiornare il profilo dell'istanza ripristinata utilizzando la console Amazon EC2.

  Se utilizzi il profilo dell'istanza originale, devi concedere AWS Backup le seguenti autorizzazioni, dove l'ARN della risorsa è l'ARN del ruolo IAM associato al profilo dell'istanza.

  ```
  {
        "Effect": "Allow",
        "Action": "iam:PassRole",
        "Resource": "arn:aws:iam::account-id:role/role-name"
  },
  ```

  Sostituisci *role-name* con il nome del ruolo del profilo dell'istanza EC2 che verrà associato all'istanza EC2 ripristinata. Questo non è il ruolo di AWS Backup servizio, ma piuttosto il ruolo IAM che fornisce le autorizzazioni alle applicazioni in esecuzione sull'istanza EC2.
+ Durante un ripristino, si applicano tutte le quote e le limitazioni di configurazione di Amazon EC2.
+ Se il vault contenente i punti di ripristino Amazon EC2 ha un blocco del vault, [Ulteriori considerazioni sulla sicurezza](vault-lock.md#using-vault-lock-with-backup) consulta per ulteriori informazioni.

## Usa la AWS Backup console per ripristinare i punti di ripristino di Amazon EC2
<a name="restoring-ec2-console"></a>

Puoi ripristinare un'intera istanza Amazon EC2 da un singolo punto di ripristino, inclusi il volume root, i volumi di dati e alcune impostazioni di configurazione dell'istanza, come il tipo di istanza e la key pair.

**Per ripristinare le risorse Amazon EC2 utilizzando la console AWS Backup**

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette**, quindi scegli l'ID della risorsa Amazon EC2 per aprire la pagina dei dettagli della risorsa.

1. Nel riquadro **Punti di ripristino**, scegli il pulsante di opzione accanto all'ID del punto di ripristino da ripristinare. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. Nel riquadro **Impostazioni di rete**, utilizziamo le impostazioni dell'istanza protetta per selezionare i valori predefiniti per il tipo di istanza, VPC, sottorete, gruppo di sicurezza e ruolo IAM dell'istanza. È possibile utilizzare questi valori predefiniti o modificarli in base alle esigenze.

1. Nel riquadro **Ripristina ruolo**, utilizza il **ruolo predefinito** o utilizza **Scegli un ruolo IAM per specificare un ruolo** IAM che concede l' AWS Backup autorizzazione per il ripristino del backup.

1. Nel riquadro **Tag delle risorse protette**, selezioniamo **Copia i tag dalla risorsa protetta alla risorsa ripristinata** per impostazione predefinita. Se non desideri copiare questi tag, deseleziona la casella di controllo.

1. Nel riquadro **Impostazioni avanzate**, accettate i valori predefiniti per le impostazioni dell'istanza o modificateli secondo necessità. Per informazioni su queste impostazioni, scegliete **Informazioni** per l'impostazione per aprire il relativo riquadro di aiuto.

1. Al termine della configurazione dell'istanza, scegli **Ripristina backup**.

## Ripristina Amazon EC2 con AWS CLI
<a name="restoring-ec2-cli"></a>

Nell'interfaccia a riga di comando, [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/start-restore-job.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/start-restore-job.html)consente di eseguire il ripristino con un massimo di 32 parametri (inclusi alcuni parametri che non sono personalizzabili tramite la AWS Backup console).

Di seguito è riportato l'elenco dei metadati che possono essere passati per ripristinare un punto di ripristino di Amazon EC2.

```
InstanceType
KeyName
SubnetId
Architecture
EnaSupport
SecurityGroupIds
IamInstanceProfileName
CpuOptions
InstanceInitiatedShutdownBehavior
HibernationOptions
DisableApiTermination
CreditSpecification
Placement
RootDeviceType
RamdiskId
KernelId
UserData
Monitoring
NetworkInterfaces
ElasticGpuSpecification
CapacityReservationSpecification
InstanceMarketOptions
LicenseSpecifications
EbsOptimized
VirtualizationType
Platform
RequireIMDSv2
BlockDeviceMappings
aws:backup:request-id
```

AWS Backup accetta i seguenti attributi di sola informazione. Tuttavia, la loro specifica non influisce sul ripristino:

```
vpcId
```

[https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-block-device-mapping.html#create-ami-bdm](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/ami-block-device-mapping.html#create-ami-bdm)è un parametro opzionale che è possibile includere. AWS Backup supporta i seguenti `BlockDeviceMappings` attributi.

**Nota**  
`SnapshotId` e `OutpostArn` non sono supportate.

```
{
  "BlockDeviceMappings": [
    {
        "DeviceName" : string,
        "NoDevice" : string,
        "VirtualName" : string,
        "Ebs": {
            "DeleteOnTermination": boolean,
            "Iops": number,
            "VolumeSize": number,
            "VolumeType": string,
            "Throughput": number,
            "Encrypted": boolean,
            "KmsKeyId": string
        }
    }
 }
```

Esempio:

```
{
  "BlockDeviceMappings": [
    {
      "DeviceName": "/def/tuvw",
      "Ebs": {
        "DeleteOnTermination": true,
        "Iops": 3000,
        "VolumeSize": 16,
        "VolumeType": "gp3",
        "Throughput": 125,
        "Encrypted": true,
        "KmsKeyId": "arn:aws:kms:us-west-2:123456789012:key/ab3cde45-67f8-9g01-hi2j-3456klmno7p8"
      }
    },
    {
      "DeviceName": "/abc/xyz",
      "Ebs": {
        "DeleteOnTermination": false,
        "Iops": 3000,
        "VolumeSize": 16,
        "VolumeType": "gp3",
        "Throughput": 125,
        "Encrypted": false
      }
    }
  ]
}
```

È inoltre possibile ripristinare un'istanza Amazon EC2 senza includere parametri archiviati. Questa opzione è disponibile nella scheda **Risorse protette** della AWS Backup console.

**Importante**  
Se non sovrascrivi la AWS KMS chiave inserita `BlockDeviceMappings` durante il ripristino da backup tra account o più regioni, il ripristino potrebbe non riuscire. Per ulteriori informazioni, consulta [Risolvi i problemi di ripristino delle istanze Amazon EC2](#restoring-ec2-troubleshooting).

## Risolvi i problemi di ripristino delle istanze Amazon EC2
<a name="restoring-ec2-troubleshooting"></a>

**Topics**
+ [Errori di ripristino tra account](#cross-account-kms-issue)
+ [Errori di ripristino tra regioni](#cross-region-kms-issue)

### Errori di ripristino tra account
<a name="cross-account-kms-issue"></a>

**Descrizione:** il ripristino delle istanze di Amazon EC2 non riesce quando si tenta di eseguire il ripristino da un backup condiviso con il tuo account.

**Possibili problemi:** il tuo account potrebbe non avere accesso alle AWS KMS chiavi utilizzate per crittografare i volumi di origine nell'account di condivisione. Le chiavi KMS potrebbero non essere condivise con il tuo account.

Oppure, i volumi collegati all'istanza di origine non sono crittografati.

**Soluzione:** per risolvere questo problema, impostate l'`encrypted`attributo su `true` ed effettuate una delle seguenti operazioni:
+ Sostituisci le chiavi KMS presenti in `BlockDeviceMappings` e specifica una chiave KMS di tua proprietà nel tuo account.
+ Richiedi all'account proprietario di concederti l'accesso alle chiavi KMS utilizzate per crittografare i volumi aggiornando la politica delle chiavi KMS. Per ulteriori informazioni, consulta [Consentire agli utenti di altri account di utilizzare](https://docs.aws.amazon.com/kms/latest/developerguide/key-policy-modifying-external-accounts.html) una chiave KMS.

### Errori di ripristino tra regioni
<a name="cross-region-kms-issue"></a>

**Descrizione:** il ripristino delle istanze di Amazon EC2 non riesce quando si tenta di eseguire il ripristino da un backup interregionale.

**Problema:** i volumi del backup potrebbero essere crittografati con AWS KMS chiavi a regione singola che non sono disponibili nella regione di destinazione. Oppure, i volumi collegati all'istanza di origine non sono crittografati.

**Soluzione:** per risolvere questo problema, imposta l'`encrypted`attributo `true` su e sostituisci la chiave KMS `BlockDeviceMappings` con una chiave KMS nella regione di destinazione.

# Ripristina un file system Amazon EFS
<a name="restoring-efs"></a>

Se è in corso il ripristino di un'istanza Amazon Elastic File System (Amazon EFS), puoi eseguire un ripristino completo o un ripristino a livello di elemento.

**Ripristino completo**

Quando si esegue il ripristino completo, viene ripristinato l'intero file system.

AWS Backup non supporta ripristini distruttivi con Amazon EFS. Un ripristino distruttivo si verifica quando un file system ripristinato elimina o sovrascrive il file system di origine o esistente. Invece, AWS Backup ripristina il file system in una directory di ripristino esterna alla directory principale. 

**Ripristino a livello di elemento**

Quando esegui un ripristino a livello di elemento, AWS Backup ripristina un file o una directory specifici. È necessario specificare il percorso relativo alla radice del file system. Ad esempio, se il file system è montato in `/user/home/myname/efs` e il percorso del file è `user/home/myname/efs/file1`, immettere **/file1**. I percorsi fanno distinzione tra maiuscole e minuscole. I caratteri jolly e le stringhe regex non sono supportati. Il percorso potrebbe essere diverso da quello presente nell'host se il file system viene montato utilizzando un punto di accesso.

Quando si utilizza la console per eseguire un ripristino EFS, è possibile selezionare fino a 10 elementi. Quando si utilizza la CLI per ripristinare, non esiste un limite di elementi; tuttavia, esiste un limite di 200 KB sulla lunghezza dei metadati di ripristino che possono essere passati.

È possibile ripristinare tali elementi in un file system nuovo o esistente. In entrambi i casi, AWS Backup crea una nuova directory Amazon EFS (`aws-backup-restore_datetime`) esterna alla directory principale per contenere gli elementi. La gerarchia completa degli elementi specificati viene mantenuta nella directory di ripristino. Ad esempio, se la directory A contiene le sottodirectory B, C e D, AWS Backup mantiene la struttura gerarchica quando A, B, C e D vengono ripristinate. A prescindere che si esegua un ripristino a livello di elemento Amazon EFS su un file system nuovo o esistente, ogni tentativo di ripristino crea una nuova directory di ripristino fuori dalla directory principale per contenere i file ripristinati. Se si tenta di eseguire più ripristini per lo stesso percorso, potrebbero esistere diverse directory contenenti gli elementi ripristinati.

**Nota**  
 Se si conserva un solo backup settimanale, è possibile ripristinare lo stato del file system solo come era al momento in cui è stato eseguito il backup. Non è possibile eseguire il ripristino da backup incrementali precedenti.

## Usa la AWS Backup console per ripristinare un punto di ripristino Amazon EFS
<a name="efs-restore-console"></a>

**Per ripristinare un file system Amazon EFS**

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Il vault di backup EFS riceve la policy di accesso `Deny` `backup:StartRestoreJob` al momento della creazione. Se è la prima volta che si esegue il ripristino del vault di backup, è necessario modificare la policy di accesso come segue.

   1. Scegliere **Vault di Backup**.

   1. Scegli il vault di backup contenente il punto di ripristino che desideri ripristinare.

   1. Scorri verso il basso fino alla **policy di accesso** del vault.

   1. Se presente, elimina `backup:StartRestoreJob` da `Statement`. A tale scopo, scegli **Modifica**, elimina `backup:StartRestoreJob`, quindi scegli **Salva policy**.

1. Nel riquadro di navigazione, scegli **Risorse protette** e l'ID del file system EFS che si desidera ripristinare.

1. Nella pagina **Dettagli della risorsa**, viene visualizzato un elenco di punti di ripristino per l'ID del file system selezionato. Per ripristinare un file system, nel riquadro **Backup** scegli il pulsante di opzione accanto all'ID del punto di ripristino del file system. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. Specifica i parametri di ripristino per il file system. I parametri di ripristino immessi sono specifici del tipo di risorsa selezionato. 

   È possibile eseguire un **ripristino completo**, che consente di ripristinare l'intero file system. In alternativa, è possibile ripristinare file e directory specifici utilizzando un **Ripristino a livello di elemento**.
   + Scegli l'opzione **Ripristino completo** per ripristinare il file system nella suo insieme, incluse tutte le cartelle e i file di livello root.
   + Scegliere l'opzione **Ripristino a livello di elemento** per ripristinare un file o una directory specifici. Puoi selezionare e ripristinare fino a cinque elementi all'interno di Amazon EFS.

     Per ripristinare un file o una directory specifici, è necessario specificare il percorso relativo al punto di montaggio. Ad esempio, se il file system è montato in `/user/home/myname/efs` e il percorso del file è `user/home/myname/efs/file1`, immettere **/file1**. I percorsi fanno distinzione tra maiuscole e minuscole e non possono contenere caratteri speciali, caratteri jolly e stringhe regex. 

     1. Nella casella di testo **Percorso della voce** immettere il percorso del file o della cartella.

     1. Scegliere **Aggiungi elemento** per aggiungere ulteriori file o directory. Puoi selezionare e ripristinare fino a cinque elementi nel file system EFS.

1. Per **Posizione di ripristino**
   + Scegli l'opzione **Ripristina nella directory nel file system di origine** se desideri eseguire il ripristino nel file system di origine.
   + Scegli **Ripristina su un nuovo file system** se desideri eseguire il ripristino in un file system diverso.

1. Per **Tipo di file system**
   + (Consigliato) Scegliete **Regionale** se desiderate ripristinare il file system su più zone di AWS disponibilità.
   + Scegli **One Zone** se desideri ripristinare il file system in una singola zona di disponibilità. Quindi, nel menu a discesa **Zona di disponibilità**, scegli la destinazione per il ripristino.

   Per ulteriori informazioni, consulta [Gestione delle classi di storage Amazon EFS](https://docs.aws.amazon.com/efs/latest/ug/storage-classes.html) nella *Guida per l'utente di Amazon EFS*.

1. Per **Prestazioni**
   + Se hai scelto di eseguire un ripristino **regionale**, seleziona **(Consigliato) Uso generale** o **I/O max**.
   + Se hai scelto di eseguire un ripristino **One Zone**, devi selezionare **(Consigliato) Uso generale**. I ripristini One Zone non supportano **I/O max**.

1. Per **Abilita la crittografia**
   + Scegliere **Abilita crittografia**, se si desidera crittografare il file system. La chiave KMS IDs e gli alias vengono visualizzati nell'elenco dopo essere stati creati utilizzando la console AWS Key Management Service (AWS KMS).
   + Nella casella di testo **Chiave KMS**, scegli la chiave che desideri utilizzare dall'elenco.

1. Per il **ruolo Restore**, scegli il ruolo IAM che AWS Backup assumerai per questo ripristino.
**Nota**  
Se il ruolo AWS Backup predefinito non è presente nel tuo account, viene creato un **ruolo predefinito** con le autorizzazioni corrette. Puoi eliminare questo ruolo predefinito o renderlo inutilizzabile.

1. Scegli **Restore backup (Ripristina backup)**.

   Viene visualizzato il riquadro **Lavori di ripristino**. Un messaggio nella parte superiore della pagina fornisce informazioni sul lavoro di ripristino.
**Nota**  
 Se si conserva un solo backup settimanale, è possibile ripristinare lo stato del file system solo come era al momento in cui è stato eseguito il backup. Non è possibile eseguire il ripristino da backup incrementali precedenti.

## Usa l' AWS Backup API, la CLI o l'SDK per ripristinare i punti di ripristino Amazon EFS
<a name="efs-restore-cli"></a>

Utilizza `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`. Durante il ripristino di un'istanza Amazon EFS, è possibile ripristinare un intero file system oppure file o directory specifici. Per ripristinare le risorse Amazon EFS, sono necessarie le seguenti informazioni:
+ `file-system-id`— L'ID del file system Amazon EFS di cui è eseguito il backup AWS Backup. Restituito in `GetRecoveryPointRestoreMetadata`. Questo non è necessario quando viene ripristinato un **nuovo** file system (questo valore viene ignorato se il parametro lo `newFileSystem` è`True`).
+ `Encrypted`: un valore booleano che, se true, specifica che il file system è crittografato. Se è specificato `KmsKeyId`, `Encrypted` deve essere impostato su `true`.
+ `KmsKeyId`— specifica la AWS KMS chiave utilizzata per crittografare il file system ripristinato.
+ `PerformanceMode`: specifica la modalità di velocità di trasmissione effettiva del file system. I valori validi sono `generalPurpose` (default) e `maxIO`. La `generalPurpose` modalità offre la latenza più bassa per operazione e può eseguire fino a 7.000 operazioni sui file al secondo. La `maxIO` modalità può essere scalata fino a livelli più elevati di velocità effettiva aggregata e operazioni al secondo con una latenza leggermente superiore per le operazioni sui file.
+ `CreationToken`: un valore fornito dall'utente che garantisce l'univocità (idempotenza) della richiesta.
+ `newFileSystem`: un valore booleano che, se true, specifica che il punto di ripristino viene ripristinato in un nuovo file system Amazon EFS.
+ `ItemsToRestore `: un array di un massimo di cinque stringhe in cui ogni stringa è un percorso di file. Utilizza `ItemsToRestore` per ripristinare file o directory specifici anziché l'intero file system. Questo parametro è facoltativo.

Puoi anche includere `aws:backup:request-id`.

I ripristini One Zone possono essere eseguiti includendo i seguenti parametri:

```
"singleAzFilesystem": "true" 
"availabilityZoneName": "ap-northeast-3"
```

Per ulteriori informazioni sui valori di configurazione di Amazon EFS, consulta [create-file-system](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/efs/create-file-system.html).

## Disabilitazione dei backup automatici in Amazon EFS
<a name="efs-backup-disable"></a>

Per impostazione predefinita, [Amazon EFS crea automaticamente backup di dati](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups). Questi backup sono rappresentati come punti di ripristino in AWS Backup. I tentativi di rimuovere il punto di ripristino generano un messaggio di errore che indica che i privilegi non sono sufficienti per eseguire l'azione.

Come best practice, si consiglia di mantenere attivo questo backup automatico. In particolare in caso di cancellazione accidentale dei dati, questo backup consente il ripristino del contenuto del file system alla data dell'ultimo punto di ripristino creato.

Nell'improbabile eventualità che si desideri disattivarli, è necessario modificare la policy di accesso da `"Effect": "Deny"` a `"Effect": "Allow"`. Consulta la *Guida per l'utente di Amazon EFS* per ulteriori informazioni sull'attivazione/disattivazione dei [backup automatici](https://docs.aws.amazon.com/efs/latest/ug/awsbackup.html#automatic-backups).

# Ripristina un cluster Amazon EKS
<a name="restoring-eks"></a>

È possibile ripristinare i backup dei cluster EKS utilizzando la AWS Backup console o la CLI. I backup EKS sono punti di ripristino compositi che includono sia backup dello stato del cluster EKS che backup di volume persistente.

AWS Backup supporta diverse esperienze di ripristino, tra cui ripristini granulari a livello di namespace. I ripristini non sono distruttivi e non sovrascrivono alcun oggetto Kubernetes esistente nel cluster EKS di destinazione. Inoltre, i ripristini non sovrascriveranno le versioni Kubernetes del cluster EKS di destinazione.

I backup EKS devono essere ripristinati su un cluster EKS di destinazione, ovvero su un cluster Amazon EKS che è stato predisposto. Come parte del flusso di lavoro di ripristino, puoi scegliere di creare un nuovo cluster EKS che AWS Backup verrà creato per tuo conto.

**Nota**  
AWS Backup fornirà un set limitato di opzioni per la creazione di un nuovo cluster EKS come parte di un ripristino. Per tutte le funzionalità di creazione di cluster EKS, i clienti possono creare un nuovo cluster [EKS utilizzando la console EKS](https://console.aws.amazon.com/eks/home) o APIs selezionarlo come obiettivo di ripristino.

**Funzionalità di ripristino per Amazon EKS**


| Tipo di ripristino | Ripristina l'obiettivo | Ripristina il comportamento | 
| --- | --- | --- | 
| Ripristino del cluster esistente | Ripristina nel cluster EKS di origine o nel cluster EKS esistente | Ripristina tutte le risorse Kubernetes e i volumi persistenti nei cluster EKS esistenti. Tutti i ripristini non sono distruttivi e gli oggetti esistenti non vengono sovrascritti. [Per gli oggetti che vengono ignorati, è possibile sottoscrivere le notifiche SNS](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-notifications.html) | 
| Nuovo ripristino del cluster | Crea un nuovo cluster Amazon EKS come parte del ripristino EKS | Restore crea un nuovo cluster EKS e ripristina tutte le risorse Kubernetes e i volumi persistenti nel cluster appena creato | 
| Ripristino dello spazio dei nomi | Cluster Amazon EKS esistente | Ripristina solo i namespace specificati, le relative risorse Kubernetes e i corrispondenti ripristini di storage persistenti non sono distruttivi e gli oggetti esistenti non vengono sovrascritti. Per gli oggetti che vengono ignorati, puoi iscriverti alle notifiche SNS | 
| Storage e ripristino persistenti | Dipende dallo storage persistente | Ripristina lo storage persistente individuale come ripristini autonomi. Vedi il comportamento di ripristino di [Amazon EBS](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ebs.html), [Amazon S3, [Amazon](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-efs.html)](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-s3.html) EFS. | 

**Autorizzazioni**

Le autorizzazioni richieste dipendono dal tipo di ripristino e dalla destinazione di destinazione.
+ AWS Backup[AWSBackupServiceRolePolicyForRestores](https://docs.aws.amazon.com/aws-backup/latest/devguide/security-iam-awsmanpol.html#AWSBackupServiceRolePolicyForRestores)contiene le autorizzazioni necessarie per ripristinare il cluster Amazon EKS e lo storage persistente EBS ed EFS.
+ [Se il tuo cluster EKS contiene un bucket S3 o stai ripristinando solo il punto di ripristino S3 secondario, dovrai assicurarti che le seguenti politiche o autorizzazioni siano assegnate al tuo ruolo S3Restore. AWSBackup ServiceRolePolicyFor](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSBackupServiceRolePolicyForS3Restore.html)

**Considerazioni prima del ripristino**

Prima di iniziare un processo di ripristino EKS, esaminate quanto segue. Se stai ripristinando un backup EKS che è stato copiato su più account o regioni, assicurati di controllare queste considerazioni prima dei ripristini per evitare errori di ripristino.

1. **Ruoli IAM**: durante il ripristino su un cluster diverso, i ruoli IAM utilizzati nel cluster di origine (come Pod identity, IRSA). Le configurazioni del provider OIDC, ecc.) devono essere presenti nell'account o nella regione come cluster di destinazione.

1. **Garantisci la versione e la compatibilità EKS**: le versioni API degli oggetti che desideri ripristinare devono essere la stessa versione (o la più simile possibile) e supportate nel nuovo cluster. AWS Backup eseguirà al meglio il ripristino tra le versioni EKS, sebbene possano sorgere problemi di compatibilità durante il ripristino tra versioni significativamente diverse.

1. **Classi di storage corrispondenti**: per i ripristini su un cluster EKS esistente, assicuratevi che i componenti aggiuntivi CSI Storage Driver appropriati siano installati prima del ripristino

1. Bucket **S3: quando ripristini un cluster EKS con bucket** S3, assicurati che il bucket S3 abbia una versione e sia accessibile nell'account o nella regione di destinazione.

1. **Archivio di immagini**: quando ripristini un cluster EKS, assicurati che l'account o la regione del cluster EKS di destinazione abbia accesso alle immagini a cui si fa riferimento nell'ambito del ripristino. Verificate che il registro disponga delle autorizzazioni necessarie per le politiche interregionali o relative agli account.

1. **Gruppi di** sicurezza: i gruppi di sicurezza devono essere precreati per ALB, Pod Identities, EKS Node Groups ecc. nell'account e nella regione di destinazione se si crea un nuovo cluster EKS come parte del ripristino

1. **Zone e nodi di disponibilità EBS**: le zone di disponibilità in cui recuperare i volumi EBS devono essere mappate alla zona di disponibilità di un nodo EKS esistente

1. Ripristini **non distruttivi: tutti i ripristini** EKS saranno non distruttivi e non sovrascriveranno gli oggetti Kubernetes del ripristino di destinazione.

1. **Abilita i registri di controllo EKS: abilita i registri di controllo EKS** per ulteriori registrazioni e risoluzione dei problemi prima del ripristino. È inoltre possibile abbonarsi alle [notifiche SNS](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-notifications.html) per notificare gli oggetti ignorati o non riusciti durante il ripristino.

**Configurazioni EKS**

Quando ripristini l'Amazon composito AWS Backup, scegli il tipo di ripristino e la destinazione di destinazione. Puoi scegliere di eseguire il ripristino sul cluster EKS di origine, su un cluster EKS esistente o creare un nuovo cluster EKS come destinazione di ripristino. Per i nuovi cluster EKS, puoi scegliere di utilizzare le stesse impostazioni dell'infrastruttura esistenti (ad esempio VPC, sottoreti) del cluster di backup o configurarne di nuove. AWS Backup è progettato per eseguire un ripristino non distruttivo che non sovrascriva le risorse esistenti.

Per il ripristino dello spazio dei nomi, è possibile specificare fino a 5 namespace da ripristinare in modo selettivo. Vengono ripristinate solo le risorse con ambito namespace, mentre le risorse con ambito cluster vengono escluse ad eccezione dei volumi persistenti correlati.

Come impostazione avanzata puoi scegliere di modificare l'ordine di ripristino degli oggetti Kubernetes. Per impostazione predefinita, AWS Backup ripristinerà tutti gli oggetti Kubernetes nel seguente ordine: 

**Risorse Kubernetes con ambito cluster**

1. Definizioni di risorse personalizzate

1. Namespace (lo spazio dei nomi stesso, non le risorse all'interno di tale spazio dei nomi)

1. StorageClasses

1. PersistentVolumes

**Risorse Kubernetes con ambito di namespace**

1. PersistentVolumeClaims

1. Segreti

1. ConfigMaps

1. ServiceAccounts

1. LimitRanges

1. Pod

1. ReplicaSets

**Configurazioni di storage persistenti**

Come parte del ripristino di backup composito di Amazon EKS, il secondo passaggio consisterà nella configurazione delle configurazioni di Persistent Storage. Questo varierà in base allo storage persistente di cui è stato eseguito il backup come parte del cluster EKS.

Per gli snapshot di Amazon EBS è necessario fornire una zona di disponibilità, in cui ripristinare e creare il volume Amazon EBS. AWS Backup tenterà quindi di creare il pod EKS nella stessa zona di disponibilità selezionata in modo che il volume possa essere rimontato sul cluster EKS come parte del ripristino.

Come parte del ripristino, AWS Backup rimonterà i volumi Amazon EBS e i bucket Amazon S3 sul cluster EKS ripristinato. I file system Amazon EFS eseguono il ripristino su prefissi casuali e richiedono la creazione manuale dei punti di accesso dopo il ripristino per il rimontaggio sul cluster EKS. AWS Backup [https://docs.aws.amazon.com/efs/latest/ug/create-access-point.html](https://docs.aws.amazon.com/efs/latest/ug/create-access-point.html)

## Procedura di ripristino di Amazon EKS
<a name="eks-restore-backup-section"></a>

Segui questi passaggi per ripristinare i backup di Amazon EKS utilizzando la AWS Backup console o AWS CLI:

------
#### [ Console ]

**Per ripristinare il tuo cluster Amazon EKS**

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione scegliere **Backup vaults (Vault di backup)**.

1. Scegli l'archivio di backup che contiene il tuo backup Amazon EKS, quindi seleziona il punto di ripristino per il tuo backup Amazon EKS.

1. Scegli **Restore** (Ripristina).

1. Nel riquadro **Opzioni di ripristino**, scegli il tipo di ripristino:
   + **Ripristina il cluster EKS completo**: ripristina l'intero punto di ripristino composito Amazon EKS
   + **Seleziona i namespace da ripristinare: ripristina fino a** cinque namespace specifici

1. Configura la destinazione di destinazione:
   + Per il ripristino del cluster, scegli di creare un nuovo cluster o utilizzare un cluster esistente
   + Per i nuovi cluster, specifica il nome del cluster, la versione di Kubernetes, la configurazione VPC, i ruoli IAM, le sottoreti, i gruppi di sicurezza aggiuntivi, le impostazioni del gruppo di nodi, i profili fargate e i ruoli IAM di Pod identity
   + Per i cluster esistenti, seleziona il cluster di destinazione dal menu a discesa
   + Per il ripristino dello spazio dei nomi, specifica i nomi del cluster di destinazione e dello spazio dei nomi

1. Facoltativamente, configura le impostazioni avanzate per l'ordine di ripristino personalizzato per le risorse Kubernetes.

1. Scegli il ruolo di ripristino IAM per il job. Se non utilizzi il ruolo predefinito, assicurati che il ruolo selezionato includa l'PassRole autorizzazione iam:.

1. Scegli **Restore backup (Ripristina backup)**.

------
#### [ AWS CLI ]

Usa il `aws backup start-restore-job` comando con metadati specifici di Amazon EKS.

I metadati richiesti dipendono dal tipo di ripristino. Tutte le operazioni di ripristino richiedono il `clusterName` parametro.

**Ripristina i punti di ripristino di Amazon EKS tramite AWS CLI**

Usa StartRestoreJob. Puoi specificare i seguenti metadati durante i ripristini di Amazon EKS:

**Metadati obbligatori:**
+ `clusterName`- Nome del cluster in cui eseguire il ripristino

**Metadati opzionali:**
+ `newCluster`- (true/false) Se dovessimo creare un nuovo cluster EKS durante il ripristino. Se newCluster è «true», si applicano i seguenti campi di metadati:
  + `eksClusterVersion`- Versione K8s del cluster desiderata se si desidera aumentare la versione del cluster durante il ripristino
  + `clusterRole`- L'ARN del ruolo IAM da collegare al cluster EKS creato
  + `encryptionConfigProviderKeyArn`- Specificare l'ARN della chiave KMS per crittografare il cluster di destinazione. Può essere la chiave KMS del cluster di origine o una chiave KMS diversa. È necessario fornire una chiave KMS diversa quando si esegue il ripristino tra regioni o più account. Ometti completamente questi metadati se il cluster di origine non è crittografato.
  + `clusterVpcConfig`- VPC/Networking configurazione per il cluster EKS creato. Questo campo contiene i seguenti campi annidati:
    + `vpcId`- Il VPC associato al cluster
    + `subnetIds [Required]`- Le sottoreti associate al cluster
    + `securityGroupIds [Required]`- I gruppi di sicurezza aggiuntivi associati al cluster
  + `nodeGroups`- I gruppi di nodi gestiti da creare sul cluster EKS. Il file NodeGroups da ripristinare deve avere tutti gli stessi gruppi di nodi utilizzati in fase di backup e avere una corrispondenza nodeGroupId.
    + `nodeGroupId [Required]`- L'ID del gruppo di nodi
    + `subnetIds [Required]`- Le sottoreti specificate per il gruppo Auto Scaling associato al gruppo di nodi
    + `instanceTypes`- Se il gruppo di nodi non è stato distribuito con un modello di avvio, questo è il tipo di istanza associato al gruppo di nodi
    + `nodeRole [Required]`- Il ruolo IAM associato al tuo gruppo di nodi
    + `securityGroupIds`- Il gruppo di sicurezza a IDs cui è consentito l'accesso SSH ai nodi
    + `remoteAccessEc2SshKey`- Il nome della chiave SSH di Amazon EC2 che fornisce l'accesso per la comunicazione SSH con i nodi del gruppo di nodi gestiti
    + `launchTemplateId`- Specificare l'ID del modello di lancio per creare il gruppo di nodi. Può essere l'ID del modello di avvio del cluster di origine o un ID del modello di lancio diverso. Se il modello di avvio del cluster di origine contiene un endpoint codificato che punta al cluster di origine stesso, è necessario fornire un ID del modello di avvio diverso. Omettete completamente questi metadati se il cluster di origine non utilizza un modello di avvio.
    + `launchTemplateVersion`- Avvia la versione del modello di avvio associata all'ID del modello di lancio specificato.
  + `fargateProfiles`- I profili Fargate da creare sul cluster EKS. I profili Fargate da ripristinare devono avere tutti gli stessi profili Fargate in fase di backup e avere il nome corrispondente.
    + `name [Required]`- Il nome del profilo Fargate
    + `subnetIds`- Le IDs sottoreti in cui lanciare un Pod
    + `podExecutionRoleArn [Required]`- L'ARN del ruolo IAM del ruolo di esecuzione Pod da utilizzare per un Pod che corrisponde ai selettori nel profilo Fargate
  + `podIdentityAssociations`- Le associazioni Pod Identity da creare sul cluster EKS
    + `associationId`- L'ID della Pod Identity Association
    + `roleArn`- L'ARN del ruolo IAM per la Pod Identity Association
+ `kubernetesRestoreOrder`- Sostituisci l'ordine in cui vengono ripristinati i manifesti di Kubernetes. Questo ordine avrà la precedenza sull'ordine di ripristino del servizio predefinito. Questo segue il formato: group/version/kind or version/kind

  Ad esempio: `["v1/persistentvolumes","v1/pods","customresource/v2/custom"]`
+ `namespaceLevelRestore`- (true/false) Se si desidera eseguire un ripristino a livello di namespace
+ `namespaces`- Un elenco di namespace da ripristinare se è «true». namespaceLevelRestore Può fornire fino a 5 namespace da ripristinare.

  Ad esempio: `["ns-1","ns-2","ns-3","ns-4","ns-5"]`
+ `restoreKubernetesManifestsOnly`- (true/false) Se desideri ripristinare solo i file manifest di Kubernetes e non i sistemi di storage persistenti (EBS, S3, EFS, ecc.)
+ `nestedRestoreJobs`- Ripristina la configurazione dei metadati di tutti i punti di ripristino annidati per i sistemi di storage nel punto di ripristino composito. PersistentVolume Questa è una mappa di RecoveryPointArn: di quel punto RestoreMetadata di ripristino

**Ripristina su un cluster esistente**

```
aws backup start-restore-job \
    --recovery-point-arn "arn:aws:backup:us-west-2:123456789012:recovery-point:composite:eks/my-cluster-20240115" \
    --iam-role-arn "arn:aws:iam::123456789012:role/AWSBackupDefaultServiceRole" \
    --metadata '{"clusterName":"existing-cluster","newCluster":"false"}' \
    --resource-type "EKS"
```

**Ripristina namespace specifici in un cluster esistente:**

```
aws backup start-restore-job \
    --recovery-point-arn "arn:aws:backup:us-west-2:123456789012:recovery-point:composite:eks/my-cluster-20240115" \
    --iam-role-arn "arn:aws:iam::123456789012:role/AWSBackupDefaultServiceRole" \
    --metadata '{"clusterName":"existing-cluster","newCluster":"false","namespaceLevelRestore":"true","namespaces":"[\"ns-1\",\"ns-2\",\"ns-3\",\"ns-4\",\"ns-5\"]"}' \
    --resource-type "EKS"
```

**Ripristina i volumi persistenti annidati in un cluster esistente:**

```
aws backup start-restore-job \
    --recovery-point-arn "arn:aws:backup:us-west-2:123456789012:recovery-point:composite:eks/my-cluster-20240115" \
    --iam-role-arn "arn:aws:iam::123456789012:role/AWSBackupDefaultServiceRole" \
    --metadata '{"clusterName":"existing-cluster","newCluster":"false","namespaceLevelRestore":"true","nestedrestorejobs":"{\"arn:aws:ec2:us-west-2::snapshot/snap-abc123\":\"{\\\"AvailabilityZone\\\":\\\"us-west-2a\\\"}\",\"arn:aws:backup:us-west-2:123456789012:recovery-point:fa71a304-2555-4c37-8128-f154b9578032\":\"{\\\"DestinationBucketName\\\":\\\"bucket-name\\\"}\"}"}' \
    --resource-type "EKS"
```

**Ripristina su un nuovo cluster**

```
aws backup start-restore-job \
    --recovery-point-arn "arn:aws:backup:us-west-2:123456789012:recovery-point:composite:eks/my-cluster-20240115" \
    --iam-role-arn "arn:aws:iam::123456789012:role/AWSBackupDefaultServiceRole" \
    --metadata '{"clusterName":"new-cluster","newCluster":"true","clusterRole":"arn:aws:iam::123456789012:role/EKSClusterRole","eksClusterVersion":"1.33","encryptionConfigProviderKeyArn":"arn:aws:kms:us-west-2:123456789012:key/ecb2b326-784d-4ec0-8d07-20ab826b5a13","clusterVpcConfig":"{\"vpcId\":\"vpc-1234\",\"subnetIds\":[\"subnet-1\",\"subnet-2\",\"subnet-3\"],\"securityGroupIds\":[\"sg-123\"]}","nodeGroups":"[{\"nodeGroupId\":\"nodegroup-1\",\"subnetIds\":[\"subnet-1\",\"subnet-2\",\"subnet-3\"],\"nodeRole\":\"arn:aws:iam::123456789012:role/EKSNodeGroupRole\",\"instanceTypes\":[\"t3.small\"],\"launchTemplateId\":\"lt-0b13949aae3f2b867\",\"launchTemplateVersion\":\"1\"}]","fargateProfiles":"[{\"name\":\"fargate-profile-1\",\"subnetIds\":[\"subnet-1\",\"subnet-2\",\"subnet-3\"],\"podExecutionRoleArn\":\"arn:aws:iam::123456789012:role/EKSFargateProfileRole\"}]"}' \
    --resource-type "EKS"
```

Dopo aver avviato il processo di ripristino, usa `describe-restore-job` per monitorare l'avanzamento:

```
aws backup describe-restore-job --restore-job-id restore-job-id
```

------

È possibile sottoscrivere **gli eventi di notifica per gli** oggetti non riusciti e ignorati per il ripristino. Per ulteriori informazioni, consulta [Opzioni di notifica con AWS Backup](https://docs.aws.amazon.com/aws-backup/latest/devguide/backup-notifications.html).

# Ripristinare un FSx file system
<a name="restoring-fsx"></a>

Le opzioni di ripristino disponibili quando si utilizza AWS Backup per ripristinare i FSx file system Amazon sono le stesse dell'utilizzo del FSx backup nativo di Amazon. Puoi utilizzare il punto di ripristino di un backup per creare un nuovo file system e ripristinare un' point-in-timeistantanea di un altro file system. 

AWS Backup supporta il ripristino di file system che utilizzano lo storage Intelligent Tiering sia per Lustre che FSx per i file system FSx OpenZFS. I file system Intelligent Tiering hanno requisiti di configurazione specifici durante le operazioni di ripristino.

Quando ripristini i FSx file system Amazon, AWS Backup crea un nuovo file system e lo popola con i dati (Amazon FSx for NetApp ONTAP consente di ripristinare un volume su un file system esistente). È simile al modo in cui Amazon nativo esegue il FSx backup e il ripristino dei file system. Il ripristino di un backup su un nuovo file system richiede lo stesso tempo della creazione di un nuovo file system. I dati ripristinati dal backup vengono caricati in modo differito sul file system. Pertanto, si potrebbe verificare una latenza leggermente superiore durante il processo.

**Nota**  
Non puoi ripristinare un FSx file system Amazon esistente e non puoi ripristinare singoli file o cartelle.  
FSx for ONTAP non supporta il backup di determinati tipi di volumi, inclusi volumi DP (protezione dei dati), volumi LS (condivisione del carico), volumi completi o volumi su file system pieni. [Per ulteriori informazioni, consulta ONTAP Working with backups. FSx ](https://docs.aws.amazon.com/fsx/latest/ONTAPGuide/using-backups.html)  
 AWS Backup gli archivi che contengono punti di ripristino dei FSx file system Amazon sono visibili all'esterno di AWS Backup. Puoi ripristinare i punti di ripristino utilizzando Amazon FSx ma non puoi eliminarli.

Puoi vedere i backup creati dalla funzionalità di backup FSx automatico integrata di Amazon dalla AWS Backup console. Puoi anche ripristinare questi backup utilizzando. AWS Backup Tuttavia, non puoi eliminare questi backup o modificare le pianificazioni di backup automatiche dei tuoi FSx file system Amazon che utilizzano AWS Backup.

## Usa la AWS Backup console per ripristinare i punti FSx di ripristino Amazon
<a name="fsx-restore-console"></a>

Puoi ripristinare la maggior parte dei FSx backup Amazon creati AWS Backup utilizzando la AWS Backup console, l'API o AWS CLI.

Questa sezione mostra come utilizzare la AWS Backup console per ripristinare i FSx file system Amazon.

**Topics**

### Ripristino di un file system FSx per Windows File Server
<a name="fsx-windows"></a>

**Per ripristinare un file system FSx per Windows File Server**

1. Aprire la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette**, quindi scegli l'ID di FSx risorsa Amazon che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Scegli l'ID del punto di ripristino della risorsa.

1.  Nell'angolo in alto a destra del riquadro, scegli **Ripristina** per aprire la pagina **Ripristina backup**.

1. Nella sezione **Dettagli del file system**, l'ID del backup viene visualizzato in **ID backup** e il tipo di file system viene visualizzato in **Tipo di file system**. Puoi eseguire il ripristino sia FSx per Windows File Server che FSx per i file system Lustre.

1. Per **Tipo di distribuzione**, accetta l'impostazione predefinita. Non puoi modificare il tipo di implementazione di un file system durante il ripristino.

1. Scegli il **Tipo di storage** da utilizzare. Se la capacità di storage del file system è inferiore a 2.000 GiB, non puoi utilizzare il tipo di storage **HDD**.

1. Per Capacità di **throughput, scegliete Capacità** di **throughput consigliata** per utilizzare la velocità consigliata di 16 MB al secondo (MBps) oppure scegliete **Specificate la capacità di throughput** e immettete una nuova velocità. 

1. Nella sezione **Rete e sicurezza**, fornisci le informazioni richieste.

1. Se state ripristinando un file system FSx per Windows File Server, fornite le informazioni di **autenticazione Windows** utilizzate per accedere al file system oppure potete crearne uno nuovo. 
**Nota**  
Durante il ripristino di un backup, non puoi modificare il tipo di Active Directory sul file system.

   Per ulteriori informazioni su Microsoft Active Directory, consulta [Working with Active Directory in Amazon FSx for Windows File Server](https://docs.aws.amazon.com/fsx/latest/WindowsGuide/aws-ad-integration-fsxW.html) nella *Amazon FSx for Windows File Server User Guide*.

1. (Facoltativo) Nella sezione **Backup e manutenzione**, fornisci le informazioni per impostare le preferenze di backup.

1. Nella sezione **Ripristina ruolo**, scegli il ruolo IAM utilizzato da AWS Backup per creare e gestire automaticamente i backup. Ti consigliamo di scegliere il **Ruolo predefinito**. Se non esiste un ruolo predefinito, verrà creato automaticamente con le autorizzazioni corrette. Puoi anche fornire il ruolo IAM.

1. Verifica tutte le voci e scegli **Ripristina backup**.

### Ripristino di un file system Amazon FSx for Lustre
<a name="restore-fsx-lustre"></a>

 AWS Backup supporta i file system Amazon FSx for Lustre che hanno un tipo di distribuzione di storage persistente e non sono collegati a un repository di dati come Amazon S3. 

**Nota**  
Puoi ripristinare il backup solo su un file system dello stesso tipo di distribuzione, classe di storage, capacità di throughput, capacità di storage, tipo di compressione dei dati e AWS regione dell'originale. È possibile aumentare la capacità di archiviazione del file system ripristinato non appena sarà disponibile.

**Per ripristinare un file system Amazon FSx for Lustre**

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette**, quindi scegli l'ID di FSx risorsa Amazon che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Scegli l'ID del punto di ripristino della risorsa. 

1.  Nell'angolo in alto a destra del riquadro, scegli **Ripristina** per aprire la pagina **Ripristina backup in un nuovo file system**.

1. Nella sezione **Impostazioni**, l'ID del backup viene visualizzato in **ID backup** e il tipo di file system viene visualizzato in **Tipo di file system**. **Tipo di file system** deve essere **Lustre**.

1. Scegli un **tipo di distribuzione**. AWS Backup supporta solo il tipo di distribuzione persistente. Non puoi modificare il tipo di implementazione di un file system durante il ripristino.

   Il tipo di implementazione persistente è destinato allo storage a lungo termine. Per informazioni dettagliate sulle opzioni di distribuzione di FSx for Lustre, consulta [Using Available Deployment Options for Amazon FSx for Lustre File Systems](https://docs.aws.amazon.com/fsx/latest/LustreGuide/using-fsx-lustre.html) nella *Amazon FSx for Lustre User Guide*.

1. Scegli la **velocità di trasmissione effettiva per unità di storage** che desideri utilizzare.
**Nota**  
Il throughput per unità di storage non può essere configurato per i file system che utilizzano la classe di storage Intelligent-Tiering.

1. (Facoltativo) Per i file system che utilizzano la classe di storage Intelligent-Tiering, scegli la modalità e la capacità di dimensionamento della cache di lettura SSD. [Per ulteriori informazioni, consulta la FSx documentazione per la gestione della cache di lettura SSD fornita.](https://docs.aws.amazon.com/fsx/latest/LustreGuide/managing-ssd-read-cache.html) 

1. (Facoltativo) Per i file system che utilizzano la classe di storage Intelligent-Tiering, scegli se abilitare EFA (Elastic Fabric Adapter). Per abilitare EFA, assicurati che il tuo gruppo di sicurezza consenta tutto il traffico in entrata e in uscita all'interno del gruppo di sicurezza.

1. Specifica la **Capacità di storage** da utilizzare. Immetti una capacità compresa tra 32 GiB e 64.436 GiB.
**Nota**  
Per i file system Intelligent Tiering, la capacità di archiviazione è elastica e non può essere specificata durante il ripristino. La capacità verrà scalata automaticamente in base all'utilizzo dei dati.

1. Nella sezione **Rete e sicurezza**, fornisci le informazioni richieste.

1. (Facoltativo) Nella sezione **Backup e manutenzione**, fornisci le informazioni per impostare le preferenze di backup.

1. Nella sezione **Ripristina ruolo**, scegli il ruolo IAM utilizzato da AWS Backup per creare e gestire automaticamente i backup. Ti consigliamo di scegliere il **Ruolo predefinito**. Se non esiste un ruolo predefinito, verrà creato automaticamente con le autorizzazioni corrette. Puoi anche fornire il ruolo IAM.

1. Verifica tutte le voci e scegli **Ripristina backup**.

## Ripristino dei volumi Amazon FSx for NetApp ONTAP
<a name="restore-fsx-ontap"></a>

**Per ripristinare i volumi Amazon FSx for NetApp ONTAP:**

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette**, quindi scegli l'ID di FSx risorsa Amazon che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Scegli l'ID del punto di ripristino della risorsa. 

1.  Nell'angolo in alto a destra del riquadro, scegli **Ripristina** per aprire la pagina **Ripristina**.

   Nella prima sezione, **Dettagli del file system**, viene visualizzato l'ID del punto di ripristino, l'ID del file system e il tipo di file system.

1. In **Opzioni di ripristino**, sono disponibili diverse selezioni. Innanzitutto, scegli il **File system** dal menu a discesa.

1. Quindi, scegli la **Macchina virtuale per lo storage** preferita dal menu a discesa.

1. Immetti un nome per il volume.

1. Specifica il **Percorso di collegamento**, che è la posizione all'interno del file system in cui verrà montato il volume.

1. Specifica le **Dimensioni del volume** in megabyte (MB) in corso di creazione.

1. (*Facoltativo*) Puoi abilitare la casella **Abilita efficienza di archiviazione**. Ciò consentirà la deduplicazione, la compressione e la compattazione.

1. Nel menu a discesa **Policy per la suddivisione della capacità del pool**, seleziona la preferenza di suddivisione in più livelli.

1. In **Ripristina autorizzazioni**, scegli il ruolo IAM che verrà utilizzato da AWS Backup per ripristinare i backup.

1. Verifica tutte le voci e scegli **Ripristina backup**.

## Ripristino di un file system Amazon FSx for OpenZFS
<a name="restore-fsx-openzfs"></a>

**Nota**  
Il ripristino da un backup con una determinata classe di archiviazione su un file system con una classe di archiviazione diversa non è supportato.

**Per ripristinare un file system FSx per OpenZFS**

1. [Apri la AWS Backup console in /backup. https://console.aws.amazon.com](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette**, quindi scegli l'ID di FSx risorsa Amazon che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Scegli l'ID del punto di ripristino della risorsa. 

1.  Nell'angolo in alto a destra del riquadro, scegli **Ripristina** per aprire la pagina **Ripristina backup**.

   Nella sezione **Dettagli del file system**, l'ID del backup viene visualizzato in **ID backup** e il tipo di file system viene visualizzato in **Tipo di file system**. Il tipo di file system deve essere **FSx per OpenZFS.**

1. In **Opzioni di ripristino**, puoi selezionare **Ripristino rapido** o **Ripristino standard**. Il ripristino rapido utilizzerà le impostazioni predefinite del file system di origine. Se stai eseguendo Ripristino rapido, vai al passaggio 7.

   Se scegli Ripristino standard, specifica le seguenti configurazioni aggiuntive:

   1. **IOPS dell'SSD assegnati**: puoi scegliere il **pulsante di opzione Automatico** oppure puoi scegliere l'opzione **Assegnati dall'utente**, se disponibile.
**Nota**  
Gli IOPS SSD non possono essere impostati per i file system che utilizzano la classe di archiviazione Intelling-Tiering

   1. **Capacità di throughput****: è possibile scegliere la capacità di **throughput consigliata di 64 MB/sec (per la classe di archiviazione SSD) e 160 MB/sec (per la classe di archiviazione Intelligent-Tiering), oppure è possibile scegliere di specificare la capacità** di throughput.**

   1. (*Facoltativo*) **Gruppi di sicurezza VPC**: puoi specificare i gruppi di sicurezza VPC da associare all'interfaccia di rete del file system.

   1. Chiave di **crittografia: specifica la chiave** per proteggere i dati del AWS Key Management Service file system ripristinati a riposo.

   1. (*Facoltativo*) **Configurazione del volume di root**: questa configurazione è compressa per impostazione predefinita. Puoi espanderla facendo clic sull'accento circonflesso (freccia) rivolto verso il basso. La creazione di un file system da un backup creerà un nuovo file system; i volumi e gli snapshot manterranno le configurazioni di origine.

   1. (*Facoltativo*) **Backup e manutenzione**: per impostare un backup pianificato, fai clic sull'Accento circonflesso (freccia) rivolto verso il basso per espandere la sezione. Puoi scegliere la finestra di backup, ora e minuto, periodo di conservazione e finestra di manutenzione settimanale.

1. La **Capacità di archiviazione dell'SSD** visualizzerà la capacità di storage del file system.
**Nota**  
Per i file system Intelligent Tiering, la capacità di archiviazione è elastica e non può essere specificata durante il ripristino. La capacità verrà scalata automaticamente in base all'utilizzo dei dati.

1. (Facoltativo) Per i file system che utilizzano la classe di storage Intelligent-Tiering, scegli la modalità e la capacità di dimensionamento della cache di lettura SSD. [Per ulteriori informazioni, consulta la FSx documentazione per la gestione della cache di lettura SSD fornita.](https://docs.aws.amazon.com/fsx/latest/OpenZFSGuide/managing-ssd-read-cache.html) 

1. Scegli il **cloud privato virtuale (VPC)** da cui è possibile accedere al file system.

1. Nel menu a discesa **Sottorete**, scegli la sottorete in cui risiede l'interfaccia di rete del file system.

1. Nella sezione **Ripristina ruolo**, scegli il ruolo IAM utilizzato da AWS Backup per creare e gestire automaticamente i backup. Ti consigliamo di scegliere il **Ruolo predefinito**. Se non esiste un ruolo predefinito, verrà creato automaticamente con le autorizzazioni corrette. Puoi anche scegliere un ruolo IAM.

1. Verifica tutte le voci e scegli **Ripristina backup**.

## Usa l' AWS Backup API, la CLI o l'SDK per ripristinare i punti di ripristino Amazon FSx
<a name="fsx-restore-cli"></a>

Per ripristinare Amazon FSx utilizzando l'API o la CLI, usa. `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)` Puoi specificare i seguenti metadati durante un FSx ripristino Amazon:

```
StorageCapacity
StorageType
VpcId
KmsKeyId
SecurityGroupIds
SubnetIds
DeploymentType
WeeklyMaintenanceStartTime
DailyAutomaticBackupStartTime
AutomaticBackupRetentionDays
CopyTagsToBackups
WindowsConfiguration
LustreConfiguration
OntapConfiguration
OpenZFSConfiguration
aws:backup:request-id
```

**Nota**  
La capacità di storage non può essere specificata per i file system Intelligent Tiering poiché utilizzano uno storage elastico che si ridimensiona automaticamente in base all'utilizzo dei dati.

### FSx per Windows File Server, ripristina i metadati
<a name="fsx-restore-metadata-windows"></a>

È possibile specificare i seguenti metadati durante un ripristino FSx per Windows File Server:
+ ThroughputCapacity
+ PreferredSubnetId
+ ActiveDirectoryId

### FSx per i metadati di ripristino di Lustre
<a name="fsx-restore-metadata-lustre"></a>

È possibile specificare i seguenti sottocampi nei metadati durante un FSx ripristino di `LustreConfiguration` for Lustre:
+ `PerUnitStorageThroughput`- Speciifica la capacità di throughput per unità di storage fornita, misurata in MB/s TiB di storage. 
+ `DriveCacheType`- Il tipo di cache dell'unità utilizzata dai `PERSISTENT_1` file system dotati di dispositivi di archiviazione HDD. Questo parametro è obbligatorio quando `StorageType` è impostato su HDD.
+ `DataReadCacheConfiguration`- Speciifica la cache di lettura SSD fornita per i file system Intelligent Tiering. Obbligatorio quando `StorageType` è impostato su `INTELLIGENT_TIERING`. Per ulteriori dettagli, vedere [ LustreReadCacheConfiguration](https://docs.aws.amazon.com/fsx/latest/APIReference/API_LustreReadCacheConfiguration.html).
+ `EfaEnabled`- Speciifica se il supporto Elastic Fabric Adapter (EFA) e GPUDirect Storage (GDS) è abilitato per il file system for Lustre. FSx 

Per informazioni complete su tutti i parametri disponibili in`LustreConfiguration`, consulta [ CreateFileSystemLustreConfiguration](https://docs.aws.amazon.com/fsx/latest/APIReference/API_CreateFileSystemLustreConfiguration.html)*Amazon FSx API Reference*.

### FSx per i metadati di ripristino ONTAP
<a name="fsx-restore-metadata-ontap"></a>

È possibile specificare i seguenti metadati durante un ripristino di FSx for ONTAP:
+ Nome \$1name del volume da creare
+ OntapConfiguration: \$1 configurazione ontap
+ `junctionPath`
+ `sizeInMegabytes`
+ `storageEfficiencyEnabled`
+ `storageVirtualMachineId`
+ `tieringPolicy`

### FSx per i metadati di ripristino di OpenZFS
<a name="fsx-restore-metadata-openzfs"></a>

È possibile specificare i seguenti sottocampi nei metadati durante un ripristino per OpenZFS: `OpenZFSConfiguration` FSx 
+ `ThroughputCapacity`- Speciifica la capacità di trasmissione del file system ripristinato, misurata in MB/s.
+ `DiskIopsConfiguration`- Quando si specificano gli Iops per la classe di archiviazione SSD, utilizzare un valore compreso tra 0 e 160.000. Non includere la modalità quando viene specificato Iops.
+ `ReadCacheConfiguration`- Speciifica la cache di lettura SSD fornita per i file system Intelligent Tiering. Obbligatorio quando `StorageType` è impostato su `INTELLIGENT_TIERING`. Per ulteriori dettagli, consulta [Open ZFSRead CacheConfiguration](https://docs.aws.amazon.com/fsx/latest/APIReference/API_OpenZFSReadCacheConfiguration.html).

Per informazioni complete su tutti i parametri disponibili in`OpenZFSConfiguration`, consulta [ CreateFileSystemOpenZFSConfiguration](https://docs.aws.amazon.com/fsx/latest/APIReference/API_CreateFileSystemOpenZFSConfiguration.html)*Amazon FSx API Reference*.

Esempio di comando di ripristino CLI:

```
aws backup start-restore-job --recovery-point-arn "arn:aws:fsx:us-west-2:1234:backup/backup-1234" --iam-role-arn "arn:aws:iam::1234:role/Role" --resource-type "FSx" --region us-west-2 --metadata 'SubnetIds="[\"subnet-1234\",\"subnet-5678\"]",StorageType=HDD,SecurityGroupIds="[\"sg-bb5efdc4\",\"sg-0faa52\"]",WindowsConfiguration="{\"DeploymentType\": \"MULTI_AZ_1\",\"PreferredSubnetId\": \"subnet-1234\",\"ThroughputCapacity\": \"32\"}"'
```

Esempio di metadati di ripristino:

```
"restoreMetadata":  "{\"StorageType\":\"SSD\",\"KmsKeyId\":\"arn:aws:kms:us-east-1:123456789012:key/123456a-123b-123c-defg-1h2i2345678\",\"StorageCapacity\":\"1200\",\"VpcId\":\"vpc-0ab0979fa431ad326\",\"FileSystemType\":\"LUSTRE\",\"LustreConfiguration\":\"{\\\"WeeklyMaintenanceStartTime\\\":\\\"4:10:30\\\",\\\"DeploymentType\\\":\\\"PERSISTENT_1\\\",\\\"PerUnitStorageThroughput\\\":50,\\\"CopyTagsToBackups\\\":true}\",\"FileSystemId\":\"fs-0ca11fb3d218a35c2\",\"SubnetIds\":\"[\\\"subnet-0e66e94eb43235351\\\"]\"}"
```

# Ripristina un cluster Neptune
<a name="restoring-nep"></a>

## Usa la AWS Backup console per ripristinare i punti di ripristino di Amazon Neptune
<a name="nep-restore-console"></a>

Per ripristinare un database Amazon Neptune è necessario specificare più opzioni di ripristino. Per informazioni su queste opzioni, consulta [Ripristino da uno snapshot cluster database](https://docs.aws.amazon.com/neptune/latest/userguide/backup-restore-restore-snapshot.html) nella *Guida per l'utente di Neptune*.

**Per ripristinare un database Neptune**

1. [Apri la AWS Backup console in /backup. https://console.aws.amazon.com](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione scegli **Risorse protette** e l'ID della risorsa Neptune che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Per ripristinare una risorsa, nel riquadro **Backup** scegliere il pulsante di opzione accanto all'ID del punto di ripristino della risorsa. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. Nel riquadro **Specifiche dell'istanza**, accetta le impostazioni predefinite o specifica il **Motore DB** e la **Versione**.

1. Nel riquadro **Impostazioni**, specifica un nome univoco per tutte le istanze del cluster DB di proprietà dell'utente Account AWS nella regione corrente. L'identificatore del cluster DB non fa distinzione tra maiuscole e minuscole ma è archiviato in sole lettere minuscole, come in "`mydbclusterinstance`". Questo è un campo obbligatorio. 

1. Nel riquadro **Opzioni del database**, accetta le impostazioni predefinite o specificare le opzioni per le impostazioni **Porta del database** e **Gruppo di parametri del cluster DB**. 

1. Nel riquadro **Crittografia** accettare l'impostazione predefinita o specificare le opzioni per le impostazioni **Abilita crittografia** o **Disabilita crittografia**.

1. Nel riquadro **Esportazioni dei log**, scegli i tipi di log da pubblicare su Amazon CloudWatch Logs. Il **ruolo IAM** è già definito. 

1. Nel riquadro **Ripristina ruolo** scegliere il ruolo IAM che AWS Backup assumerà per questo ripristino.

1. Dopo aver specificato tutte le impostazioni, scegli **Ripristina backup**.

   Viene visualizzato il riquadro **Lavori di ripristino**. Un messaggio nella parte superiore della pagina fornisce informazioni sul lavoro di ripristino.

1. Al termine del ripristino, collega il cluster Neptune ripristinato a un'istanza Amazon RDS.

## Usa l' AWS Backup API, la CLI o l'SDK per ripristinare i punti di ripristino di Neptune
<a name="nep-restore-cli"></a>

Innanzitutto, ripristina il cluster. Utilizza `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`. Durante i ripristini di Amazon DocumentDB puoi specificare i seguenti metadati:

```
availabilityZones
backtrackWindow
copyTagsToSnapshot // Boolean 
databaseName // string 
dbClusterIdentifier // string 
dbClusterParameterGroupName // string 
dbSubnetGroupName // string 
enableCloudwatchLogsExports // string 
enableIAMDatabaseAuthentication // Boolean 
engine // string 
engineMode // string 
engineVersion // string 
kmsKeyId // string 
port // integer 
optionGroupName // string 
scalingConfiguration
vpcSecurityGroupIds // string
```

Quindi, collega il cluster Neptune ripristinato a un'istanza Amazon RDS utilizzando. `create-db-instance`
+ Per Linux, macOS o Unix:

  ```
  aws neptune create-db-instance --db-instance-identifier sample-instance \ 
                    --db-instance-class db.r5.large --engine neptune --engine-version 1.0.5.0 --db-cluster-identifier sample-cluster --region us-east-1
  ```
+ Per Windows:

  ```
  aws neptune create-db-instance --db-instance-identifier sample-instance ^
                    --db-instance-class db.r5.large --engine neptune --engine-version 1.0.5.0 --db-cluster-identifier sample-cluster --region us-east-1
  ```

Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/neptune/latest/userguide/api-snapshots.html#RestoreDBClusterFromSnapshot](https://docs.aws.amazon.com/neptune/latest/userguide/api-snapshots.html#RestoreDBClusterFromSnapshot) nella *Documentazione di riferimento delle API di gestione Neptune* e [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/neptune/restore-db-cluster-from-snapshot.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/neptune/restore-db-cluster-from-snapshot.html) nella *Neptune CLI guide*.

# Ripristina un database RDS
<a name="restoring-rds"></a>

Per ripristinare un database Amazon RDS è necessario specificare più opzioni di ripristino. Per ulteriori informazioni su queste opzioni, consulta [Backup e ripristino di un'istanza database di Amazon RDS](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_CommonTasks.BackupRestore.html) nella *Guida per l'utente di Amazon RDS*.

## Usa la AWS Backup console per ripristinare i punti di ripristino Amazon RDS
<a name="rds-restore-console"></a>

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette** e l'ID della risorsa Amazon RDS che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Per ripristinare una risorsa, nel riquadro **Backup** scegliere il pulsante di opzione accanto all'ID del punto di ripristino della risorsa. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. Nel riquadro **Specifiche dell'istanza**, accetta le impostazioni predefinite o specifica le opzioni di cui hai bisogno.

1. Nel riquadro **Impostazioni**, specifica un nome univoco per tutte le istanze DB e i cluster di proprietà dell'utente Account AWS nella regione corrente. L'identificatore istanze DB non fa distinzione tra maiuscole e minuscole ma è archiviato in sole lettere minuscole, come in "`mydbinstance`". Questo è un campo obbligatorio. 

1. Nel riquadro **Rete e sicurezza**, accettate le impostazioni predefinite o specificate le opzioni di cui avete bisogno. 

1. Nel riquadro **Opzioni del database**, accetta le impostazioni predefinite o specifica le opzioni necessarie. 

1. Nel riquadro **Crittografia**, utilizza le impostazioni di default. Se l'istanza database di origine per lo snapshot è stata crittografata, anche l'istanza database ripristinata verrà crittografata. Questa crittografia non può essere rimossa.

1. Nel riquadro **Esportazioni dei log**, scegli i tipi di log da pubblicare su Amazon CloudWatch Logs. Il **ruolo IAM** è già definito. 

1. Nel riquadro **Manutenzione** accettare l'impostazione predefinita o specificare l'opzione per **Aggiornamento automatico della versione secondaria**. 

1. Nel riquadro **Ripristina ruolo** scegliere il ruolo IAM che AWS Backup assumerà per questo ripristino. 

1. Scegli **Restore backup (Ripristina backup)**.

   Viene visualizzato il riquadro **Lavori di ripristino**. Un messaggio nella parte superiore della pagina fornisce informazioni sul lavoro di ripristino.

## Usa l' AWS Backup API, la CLI o l'SDK per ripristinare i punti di ripristino Amazon RDS
<a name="rds-restore-cli"></a>

Utilizza `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`. Per informazioni sui metadati e sui valori accettati, consulta [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceFromDBSnapshot.html)e [https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html](https://docs.aws.amazon.com/AmazonRDS/latest/APIReference/API_RestoreDBInstanceToPointInTime.html)nell'*Amazon RDS API* Reference. Inoltre, AWS Backup accetta i seguenti attributi di sola informazione. Tuttavia, la loro specifica non influisce sul ripristino:

```
EngineVersion
KmsKeyId       
Encrypted       
vpcId
```

# Ripristino di un cluster Amazon Redshift
<a name="redshift-restores"></a>

È possibile ripristinare istantanee automatiche e manuali nella AWS Backup console o tramite CLI.

Quando ripristini un cluster Amazon Redshift, le impostazioni cluster originali vengono inserite nella console per impostazione predefinita. Puoi specificare diverse impostazioni per le configurazioni seguenti. Durante il ripristino di una tabella, è necessario specificare i database di origine e di destinazione. Per ulteriori informazioni su queste configurazioni, consulta [Ripristino di un cluster da uno snapshot](https://docs.aws.amazon.com/redshift/latest/mgmt/working-with-snapshots.html#working-with-snapshot-restore-cluster-from-snapshot) nella *Guida alla gestione di Amazon Redshift*.
+ **Tabella singola o cluster**: puoi scegliere di ripristinare un intero cluster o una singola tabella. Se scegli di ripristinare una singola tabella, sono necessari il database di origine, lo schema di origine e il nome della tabella di origine, nonché il cluster di destinazione, lo schema e il nome della nuova tabella.
+ **Tipo di nodo**: ciascun cluster Amazon Redshift è costituito da un nodo principale e da almeno un nodo di calcolo. Durante il ripristino di un cluster, è necessario specificare il tipo di nodo che soddisfa i requisiti di CPU, RAM, capacità di storage e tipo di unità.
+ **Numero di nodi**: durante il ripristino di un cluster, è necessario specificare il numero di nodi necessari.
+ **Riepilogo della configurazione**
+ **Autorizzazioni del cluster**

## Per ripristinare un cluster o una tabella Amazon Redshift utilizzando la console AWS Backup
<a name="redshift-restore-console"></a>

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette** e l'ID della risorsa Amazon Redshift che si desidera ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Per ripristinare una risorsa, nel riquadro **Punti di ripristino** scegli il pulsante di opzione accanto all'ID del punto di ripristino della risorsa. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. Opzioni di ripristino

   1. Ripristina il cluster dallo snapshot, oppure

   1. Ripristina una singola tabella all'interno di uno snapshot in un nuovo cluster. Se scegli queste opzioni, devi configurare quanto segue:

      1. Attiva o disattiva i nomi con distinzione tra maiuscole e minuscole.

      1. Immetti i valori della tabella di origine, inclusi il database, lo schema e la tabella. Le informazioni sulla tabella di origine sono disponibili nella [console Amazon Redshift](https://console.aws.amazon.com/rds/).

      1. Immetti i valori della tabella di origine, inclusi il database, lo schema e il nome della nuova tabella.

1. Specifica le nuove impostazioni di configurazione del cluster.

   1. Per il ripristino del cluster: scegli l'identificatore del cluster, il tipo di nodo e il numero di nodi.

   1. Specifica la zona di disponibilità e le finestre di manutenzione.

   1. Puoi associare ruoli aggiuntivi facendo clic su **Associa ruoli IAM**.

1. *Opzionale:* configurazioni aggiuntive:

   1. **Utilizza valori predefiniti** è attivata per impostazione predefinita.

   1. Utilizza i menu a discesa per selezionare le impostazioni per Reti e sicurezza, gruppi di sicurezza del VPC, gruppo di sottoreti del cluster e zona di disponibilità.

   1. Attiva o disattiva il **routing VPC avanzato**.

   1. Determina se desideri rendere l'endpoint del cluster **accessibile pubblicamente**. In tal caso, le istanze e i dispositivi esterni al VPC possono connettersi al database tramite l'endpoint del cluster. Se questa opzione è attivata, inserisci l'indirizzo IP elastico.

1. *Opzionale:* configurazione del database. Puoi scegliere di inserire 

   1. Porta del database (digitando nel campo di testo)

   1. Gruppi di parametri

1. Manutenzione: puoi scegliere 

   1. Finestra di manutenzione

   1. Traccia di manutenzione, scegliendo tra corrente, finale o anteprima. Questo consente di controllare quale versione del cluster viene applicata durante una finestra di manutenzione.

1. Lo snapshot automatico è impostato come predefinito.

   1. Periodo di conservazione automatica degli snapshot. Il periodo di conservazione deve essere compreso tra 0 e 35 giorni. Scegli 0 per non creare snapshot automatici.

   1. Il periodo di conservazione degli snapshot manuali è compreso tra 1 e 3653 giorni.

   1. È disponibile una casella di controllo opzionale per il trasferimento del cluster. Se questa casella è selezionata, è possibile trasferire il cluster in un'altra zona di disponibilità. Dopo avere abilitato il trasferimento, puoi utilizzare l'endpoint VPC.

1. Monitoraggio: dopo il ripristino di un cluster, puoi configurare il monitoraggio tramite CloudWatch o Amazon Redshift.

1. Scegli il ruolo IAM da passare per eseguire i ripristini. Puoi utilizzare il ruolo predefinito o specificarne uno diverso.

I processi di ripristino saranno visibili in **Processi**. Per visualizzare lo stato attuale del processo di ripristino, fai clic sul pulsante di aggiornamento o premi CTRL-R.

## Ripristino di un cluster Amazon Redshift tramite API, CLI o SDK
<a name="redshift-restore-api"></a>

Utilizza [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html) per ripristinare un cluster Amazon Redshift.

Per ripristinare un Amazon Redshift utilizzando AWS CLI, usa il comando `start-restore-job` e specifica i seguenti metadati:

```
ClusterIdentifier // required string
AdditionalInfo // optional string
AllowVersionUpgrade // optional Boolean
AquaConfigurationStatus // optional string
AutomatedSnapshotRetentionPeriod // optional integer 0 to 35
AvailabilityZone // optional string
AvailabilityZoneRelocation // optional Boolean
ClusterParameterGroupName // optional string
ClusterSecurityGroups // optional array of strings
ClusterSubnetGroupName // optional strings
DefaultIamRoleArn // optional string
ElasticIp // optional string
Encrypted // Optional TRUE or FALSE 
EnhancedVpcRouting // optional Boolean 
HsmClientCertificateIdentifier // optional string
HsmConfigurationIdentifier // optional string
IamRoles // optional array of strings
KmsKeyId // optional string
MaintenanceTrackName // optional string
ManageMasterPassword // optional Boolean
ManualSnapshotRetentionPeriod // optional integer
MasterPasswordSecretKmsKeyId // optional string
NodeType // optional string
NumberOfNodes // optional integer
OwnerAccount // optional string
Port // optional integer
PreferredMaintenanceWindow // optional string
PubliclyAccessible // optional Boolean
ReservedNodeId // optional string
SnapshotClusterIdentifier // optional string
SnapshotScheduleIdentifier // optional string
TargetReservedNodeOfferingId // optional string
VpcSecurityGroupIds // optional array of strings
RestoreType // CLUSTER_RESTORE or TABLE_RESTORE or NAMESPACE_RESTORE
```

 Per ulteriori informazioni, consulta [https://docs.aws.amazon.com/redshift/latest/APIReference/API_RestoreFromClusterSnapshot.html](https://docs.aws.amazon.com/redshift/latest/APIReference/API_RestoreFromClusterSnapshot.html) nella *Documentazione di riferimento delle API Amazon Redshift* e [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/restore-from-cluster-snapshot.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/redshift/restore-from-cluster-snapshot.html) nella *Guida di AWS CLI *. 

Di seguito è riportato un modello di esempio:

```
aws backup start-restore-job \
-\-recovery-point-arn "arn:aws:backup:region:account:snapshot:name
-\-iam-role-arn "arn:aws:iam:account:role/role-name" \
-\-metadata
-\-resource-type Redshift \
-\-region Regione AWS
-\-endpoint-url URL
```

Ecco un esempio:

```
aws backup start-restore-job \
-\-recovery-point-arn "arn:aws:redshift:us-west-2:123456789012:snapshot:redshift-cluster-1/awsbackup:job-c40dda3c-fdcc-b1ba-fa56-234d23209a40" \
-\-iam-role-arn "arn:aws:iam::974288443796:role/Backup-Redshift-Role" \
-\-metadata 'RestoreType=CLUSTER_RESTORE,ClusterIdentifier=redshift-cluster-restore-78,Encrypted=true,KmsKeyId=45e261e4-075a-46c7-9261-dfb91e1c739c' \
-\-resource-type Redshift \
-\-region us-west-2 \
```

Inoltre, puoi utilizzare [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_DescribeRestoreJob.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_DescribeRestoreJob.html) per fornire assistenza con le informazioni di ripristino.

In AWS CLI, utilizza l'operazione `describe-restore-job` e utilizza i seguenti metadati:

```
Region
```

Di seguito è riportato un modello di esempio:

```
aws backup describe-restore-job —restore-job-id restore job ID
-\-region Regione AWS
```

Ecco un esempio:

```
aws backup describe-restore-job -\-restore-job-id BEA3B353-576C-22C0-9E99-09632F262620 \
-\-region us-west-2 \
```

# Ripristino senza server di Amazon Redshift
<a name="redshift-serverless-restore"></a>

Puoi ripristinare istantanee manuali di database o tabelle utilizzando la console o. AWS Backup AWS CLI

Redshift Serverless e AWS Backup supportano il *ripristino intercambiabile* per le istantanee del data warehouse. Ciò significa che puoi ripristinare i backup Serverless di Redshift su cluster con [provisioning di Amazon Redshift o ripristinare i backup forniti su namespace Redshift](redshift-backups.md) Serverless. Questo vale solo per il ripristino completo del database, non per il ripristino di una singola tabella.


**Funzionalità di ripristino per Redshift Serverless**  

| Funzionalità di ripristino | Namespace | Tabella singola | 
| --- | --- | --- | 
| Tipo di istantanea | Manuale | Manuale | 
| Informazioni necessarie |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/aws-backup/latest/devguide/redshift-serverless-restore.html)  |  [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/aws-backup/latest/devguide/redshift-serverless-restore.html)  | 
| Ripristina l'effetto bersaglio | Ripristina uno spazio dei nomi esistente tramite un ripristino distruttivo che sovrascrive i dati esistenti | Ripristina su una nuova tabella | 
| Ripristino intercambiabile? |  Sì. [\[See the AWS documentation website for more details\]](http://docs.aws.amazon.com/it_it/aws-backup/latest/devguide/redshift-serverless-restore.html)  | Non supportato. | 

Per ulteriori informazioni sulle configurazioni, consulta [Snapshot e punti di ripristino](https://docs.aws.amazon.com/redshift/latest/mgmt/serverless-snapshots-recovery-points.html) nella *Amazon Redshift Management Guide*.

## Considerazioni prima del ripristino
<a name="redshift-serverless-restore-considerations"></a>

Prima di iniziare un processo di ripristino, esaminate quanto segue:

**Configurazioni**

Quando ripristini uno snapshot Redshift Serverless, scegli lo spazio dei nomi di destinazione in cui desideri ripristinare tutti i database o una singola tabella. 

Quando si ripristinano i database in uno snapshot in un namespace Serverless, si tratta di un ripristino distruttivo. Ciò significa che tutti i dati precedentemente esistenti nello spazio dei nomi di ripristino di destinazione vengono sovrascritti quando si esegue il ripristino in tale spazio dei nomi.

Quando si ripristina una singola tabella, non si tratta di un ripristino distruttivo. Per ripristinare una tabella, specifica il gruppo di lavoro, l'istantanea, il database di origine, la tabella di origine, lo spazio dei nomi di ripristino della destinazione e il nuovo nome della tabella.

**Autorizzazioni**

Le autorizzazioni richieste sono determinate dal data warehouse di destinazione (ovvero lo spazio dei nomi o il cluster fornito in cui verranno ripristinati i database o la tabella). La tabella seguente può aiutarti a determinare le autorizzazioni, il ruolo e la politica da utilizzare. Per ulteriori informazioni sulla gestione delle policy IAM, consulta [Gestione delle identità e degli accessi in Amazon Redshift](https://docs.aws.amazon.com/redshift/latest/mgmt/redshift-iam-authentication-access-control.html).


**Autorizzazioni e ruoli richiesti per le operazioni di ripristino**  

| Ripristina l'obiettivo | Autorizzazioni necessarie | Ruolo e policy IAM | 
| --- | --- | --- | 
| Cluster con provisioning di Amazon Redshift | redshift:RestoreFromClusterSnapshot | AWSBackupServiceRolePolicyForRestorescontiene questa autorizzazione; può essere utilizzata per. aws backup start-restore-job | 
| Spazio dei nomi Redshift Serverless | redshift-serverless:RestoreFromSnapshot |  È necessario aggiungere questa autorizzazione al ruolo e alla policy che verranno utilizzati per la chiamata. **aws backup start-restore-job** Poiché si tratta di un processo di ripristino distruttivo, non è possibile utilizzare la politica del ruolo di servizio per i ripristini.  | 

## Procedura di ripristino Serverless Redshift
<a name="redshift-serverless-restore-procedure"></a>

Segui questi passaggi per ripristinare i backup Redshift Serverless utilizzando la console oppure: AWS Backup AWS CLI

------
#### [ Console ]

1. [Apri la AWS Backup console in /backup. https://console.aws.amazon.com](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Impostazioni** e seleziona l'ID risorsa Redshift Serverless da ripristinare.

1. **Nella pagina dei **dettagli della risorsa**, seleziona l'ID del punto di ripristino nel riquadro **Punti di ripristino**, quindi scegli Ripristina.**

1. Nel riquadro **Opzioni di ripristino**, scegli di ripristinare l'intero data warehouse o una singola tabella.

1. Seleziona la destinazione di destinazione nel riquadro di **configurazione del data warehouse di Target**.
   + Per un ripristino completo del data warehouse, scegli tra il cluster con provisioning di Amazon Redshift o lo spazio dei nomi Redshift Serverless.
   + Per il ripristino di una singola tabella, specifica lo snapshot di origine, il database, lo schema, il nome della tabella e i dettagli della destinazione.

1. Scegli il ruolo di ripristino IAM per il job. Se non utilizzi il ruolo predefinito, assicurati che il ruolo selezionato includa l'`iam:PassRole`autorizzazione.

------
#### [ AWS CLI ]

Utilizza il comando **aws backup start-restore-job**.

AWS Backup funziona con Redshift Serverless per orchestrare il processo di ripristino. Il comando CLI verrà preceduto `aws backup` ma conterrà anche i metadati relativi a Redshift Serverless o Amazon Redshift. 

I metadati obbligatori e opzionali dipendono dal fatto che tu stia ripristinando un intero data warehouse o una singola tabella.
+ Per il ripristino di una singola tabella, consulta la sezione [restore-table-from-snapshot AWS CLI](https://docs.aws.amazon.com/cli/latest/reference/redshift-serverless/restore-table-from-snapshot.html)*Command Reference*.
+ Per il ripristino dello spazio dei nomi, vedere [restore-from-snapshot](https://docs.aws.amazon.com/cli/latest/reference/redshift-serverless/restore-from-snapshot.html)nel *AWS CLI Command* Reference.
+ *Per eseguire il ripristino in un cluster con provisioning di Amazon Redshift, consulta Command [restore-from-cluster-snapshot](https://docs.aws.amazon.com/cli/latest/reference/redshift/restore-from-cluster-snapshot.html)Reference.AWS CLI *

**Example modello per il ripristino `start-restore-job` in uno spazio dei nomi Serverless:**  

```
aws backup start-restore-job \
--recovery-point-arn "arn:aws:backup:region:account:snapshot:name--iam-role-arn "arn:aws:iam:account:role/role-name" \
--metadata \
--resource-type Redshift Serverless \
--region Region \
--endpoint-url URL
```

**Example Esempio per il ripristino `start-restore-job` in uno spazio dei nomi Serverless:**  

```
aws backup start-restore-job \
--recovery-point-arn "arn:aws:redshift-serverless:us-east-1:123456789012:snapshot/a12bc34d-567e-890f-123g-h4ijk56l78m9" \
--iam-role-arn "arn:aws:iam::974288443796:role/Backup-Redshift-Role" \
--metadata 'RestoreType=NAMESPACE_RESTORE,NamespaceIdentifier=redshift-namespace-1-restore' \
--resource-type "RedshiftServerless" \
--region us-west-2
```

Dopo aver avviato il processo di ripristino, utilizzare **describe-restore-job** per monitorare l'avanzamento.

------

# Ripristino di database SAP HANA su un'istanza Amazon EC2
<a name="saphana-restore"></a>

I database SAP HANA su istanze EC2 possono essere ripristinati utilizzando la AWS Backup console, utilizzando l'API o utilizzando. AWS CLI

**Topics**
+ [Ripristina un database SAP HANA con la console AWS Backup](#w2aac17c31c43b9)
+ [[StartRestoreJob API](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html) per SAP HANA su EC2](#w2aac17c31c43c11)
+ [CLI per SAP HANA su EC2](#w2aac17c31c43c13)
+ [Ripristino di SAP HANA High Availability (HA)](#saphanarestoreha)
+ [Risoluzione dei problemi](#saphanarestoretroubleshooting)

## Ripristina un database SAP HANA con la console AWS Backup
<a name="w2aac17c31c43b9"></a>

Tieni presente che i processi di backup e ripristino che coinvolgono lo stesso database non possono essere eseguiti contemporaneamente. Quando si verifica un processo di ripristino del database SAP HANA, i tentativi di eseguire il backup dello stesso database generano un errore: "Database cannot be backed up while it is stopped".

1. Accedi alla AWS Backup console utilizzando le credenziali dei prerequisiti.

1. Nel menu a discesa **Posizione di ripristino di destinazione**, scegli un database da sovrascrivere con il punto di ripristino utilizzato per il ripristino (tieni presente che l'istanza che ospita il database di destinazione di ripristino deve anche disporre delle autorizzazioni previste dai prerequisiti).
**Importante**  
I ripristini del database SAP HANA sono distruttivi. Il ripristino di un database sovrascriverà il database nella posizione di ripristino di destinazione specificata.

1. Completa questo passaggio solo se stai eseguendo un ripristino della copia del sistema; in caso contrario, vai al passaggio 4.

   I ripristini delle copie del sistema sono processi di ripristino che eseguono il ripristino in un database di destinazione diverso dal database di origine che ha generato il punto di ripristino. Per i ripristini delle copie del sistema, nota il comando `aws ssm-sap put-resource-permission` fornito sulla console. Questo comando deve essere copiato, incollato ed eseguito sul computer che ha completato i prerequisiti. Durante l'esecuzione del comando, utilizza le credenziali del ruolo nel prerequisito in cui imposti le autorizzazioni richieste per la registrazione delle applicazioni.

   ```
   // Example command
   aws ssm-sap put-resource-permission \
   --region us-east-1 \
   --action-type RESTORE \
   --source-resource-arn arn:aws:ssm-sap-east-1:112233445566:HANA/Foo/DB/HDB \
   --resource-arn arn:aws:ssm-sap:us-east-1:112233445566:HANA/Bar/DB/HDB
   ```

1. Dopo aver scelto la posizione di ripristino, puoi visualizzare **ID risorsa**, **Nome applicazione**, **Tipo di database** e **Istanza EC2** del database di destinazione.

1. *Facoltativamente*, puoi espandere **le impostazioni di ripristino avanzate** per modificare l'opzione di ripristino del catalogo. Le opzioni disponibili variano in base alle impostazioni di ripristino selezionate.

1. Fai clic su **Ripristina backup**.

1. La posizione di destinazione verrà sovrascritta durante il ripristino (**"ripristino distruttivo"**), quindi è necessario confermare l'autorizzazione nella successiva finestra di dialogo pop-up.

   1. Per procedere, è necessario comprendere che il database esistente verrà sovrascritto da quello che si sta ripristinando.

   1. Dopodiché, è necessario confermare che i dati esistenti verranno sovrascritti. Per confermare e procedere, digita **overwrite** nel campo di immissione di testo.

1. Fai clic su **Ripristina backup**.

Se la procedura è andata a buon fine, nella parte superiore della console verrà visualizzato un banner blu. Ciò significa che il processo di ripristino è in corso. Verrà eseguito il reindirizzamento automatico alla pagina Processi e il processo di ripristino verrà visualizzato nell'elenco dei processi di ripristino. Lo stato del processo più recente sarà `Pending`. Puoi cercare e quindi fare clic sull'ID del processo di ripristino per visualizzare i dettagli di ciascun processo di ripristino. Puoi aggiornare l'elenco dei processi di ripristino facendo clic sul pulsante di aggiornamento per visualizzare le modifiche apportate allo stato del processo di ripristino.

## [StartRestoreJob API](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html) per SAP HANA su EC2
<a name="w2aac17c31c43c11"></a>

Questa azione recupera la risorsa salvata identificata da un nome della risorsa Amazon (ARN).

**Sintassi della richiesta**

```
PUT /restore-jobs HTTP/1.1
Content-type: application/json
{
   "[IdempotencyToken](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html#Backup-StartRestoreJob-request-IdempotencyToken)": "string",
   "[Metadata](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html#Backup-StartRestoreJob-request-Metadata)": { 
      "string" : "string" 
   },
   "[RecoveryPointArn](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html#Backup-StartRestoreJob-request-RecoveryPointArn)": "string",
   "[ResourceType](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html#Backup-StartRestoreJob-request-ResourceType)": "string"
}
```

**Parametri della richiesta URI**: la richiesta non utilizza parametri URI.

**Corpo della richiesta**: la richiesta accetta i seguenti dati in formato JSON:

**IdempotencyToken**Una stringa scelta dal cliente che puoi usare per distinguere tra chiamate altrimenti identiche a. `StartRestoreJob` Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.

▬Tipo: stringa

Obbligatorio: no

**Metadati**

Un set di coppie chiave-valore di metadati. Contiene informazioni, come il nome di una risorsa, necessarie per ripristinare un punto di ripristino. Puoi ottenere i metadati di configurazione relativi a una risorsa al momento del backup chiamando `GetRecoveryPointRestoreMetadata`. Tuttavia, per ripristinare una risorsa potrebbero essere necessari altri valori oltre a quelli forniti da `GetRecoveryPointRestoreMetadata`. Ad esempio, potrebbe essere necessario fornire un nuovo nome di risorsa se l'originale esiste già.

È necessario includere metadati specifici per ripristinare un'istanza SAP HANA su Amazon EC2. Visualizza i [ StartRestoreJob metadati](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html#API_StartRestoreJob_RequestBody) per gli elementi specifici di SAP HANA.

Per recuperare i metadati pertinenti, puoi utilizzare la chiamata [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_GetRecoveryPointRestoreMetadata.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_GetRecoveryPointRestoreMetadata.html).

Esempio di un punto di ripristino standard del database SAP HANA:

```
"RestoreMetadata": {
        "BackupSize": "1660948480", 
        "DatabaseName": "DATABASENAME",
        "DatabaseType": "SYSTEM",
        "HanaBackupEndTime": "1674838362",
        "HanaBackupId": "1234567890123",
        "HanaBackupPrefix": "1234567890123_SYSTEMDB_FULL",
        "HanaBackupStartTime": "1674838349",
        "HanaVersion": "2.00.040.00.1553674765",
        "IsCompressedBySap": "FALSE",
        "IsEncryptedBySap": "FALSE",
        "SourceDatabaseArn": "arn:aws:ssm-sap:region:accountID:HANA/applicationID/DB/DATABASENAME",
        "SystemDatabaseSid": "HDB",
        "aws:backup:request-id": "46bbtt4q-7unr-2897-m486-yn378k2mrw9c"
    }
```

Esempio di un punto di ripristino continuo del database SAP HANA:

```
"RestoreMetadata": {
        "AvailableRestoreBases": "[1234567890123,9876543210987,1472583691472,7418529637418,1678942598761]",
        "BackupSize": "1711284224",
        "DatabaseName": "DATABASENAME",
        "DatabaseType": "TENANT",
        "EarliestRestorablePitrTimestamp": "1674764799789",
        "HanaBackupEndTime": "1668032687",
        "HanaBackupId": "1234567890123",
        "HanaBackupPrefix": "1234567890123_HDB_FULL",
        "HanaBackupStartTime": "1668032667",
        "HanaVersion": "2.00.040.00.1553674765",
        "IsCompressedBySap": "FALSE",
        "IsEncryptedBySap": "FALSE",
        "LatestRestorablePitrTimestamp": "1674850299789",
        "SourceDatabaseArn": "arn:aws:ssm-sap:region:accountID:HANA/applicationID/DB/SystemDatabaseSid",
        "SystemDatabaseSid": "HDB",
        "aws:backup:request-id": "46bbtt4q-7unr-2897-m486-yn378k2mrw9d"
    }
```

## CLI per SAP HANA su EC2
<a name="w2aac17c31c43c13"></a>

Il comando `start-restore-job` recupera la risorsa salvata identificata da un nome della risorsa Amazon (ARN). La CLI seguirà le linee guida API di cui sopra.

**Riepilogo:**

```
start-restore-job
--recovery-point-arn value
--metadata value
--aws:backup:request-id value          
[--idempotency-token value]
[--resource-type value]
[--cli-input-json value]
[--generate-cli-skeleton value]
[--debug]
[--endpoint-url value]
[--no-verify-ssl]
[--no-paginate]
[--output value]
[--query value]
[--profile value]
[--region value]
[--version value]
[--color value]
[--no-sign-request]
[--ca-bundle value]
[--cli-read-timeout value]
[--cli-connect-timeout value]
```

**Opzioni**

`--recovery-point-arn` (stringa) è una stringa sotto forma di un nome della risorsa Amazon (ARN) che identifica in modo univoco un punto di ripristino; ad esempio `arn:aws:backup:region:123456789012:recovery-point:46bbtt4q-7unr-2897-m486-yn378k2mrw9d`

`--metadata` (mappa): un set di coppie chiave-valore di metadati. Contiene informazioni, come il nome di una risorsa, necessarie per ripristinare un punto di ripristino. Puoi ottenere i metadati di configurazione relativi a una risorsa al momento del backup chiamando `GetRecoveryPointRestoreMetadata`. Tuttavia, per ripristinare una risorsa potrebbero essere necessari altri valori oltre a quelli forniti da `GetRecoveryPointRestoreMetadata`. È necessario specificare metadati per ripristinare un'istanza SAP HANA su Amazon EC2:
+ `aws:backup:request-id`: questa è una qualsiasi stringa UUID utilizzata per idempotenza. Non altera in alcun modo l'esperienza di ripristino.
+ `aws:backup:TargetDatabaseArn`: specifica il database in cui eseguire il ripristino. Questo è l'ARN del database SAP HANA su Amazon EC2.
+ `CatalogRestoreOption`: specifica da dove ripristinare il catalogo. Uno di `NO_CATALOG`, `LATEST_CATALOG_FROM_AWS_BACKUP`, `CATALOG_FROM_LOCAL_PATH`
+ `LocalCatalogPath`: Se il valore CatalogRestoreOption dei metadati è`CATALOG_FROM_LOCAL_PATH`, specifica il percorso del catalogo locale sull'istanza EC2. Questo deve essere un percorso di file valido nell'istanza EC2.
+ `RecoveryType`: attualmente sono supportati i tipi di ripristino `FULL_DATA_BACKUP_RECOVERY`, `POINT_IN_TIME_RECOVERY` e `MOST_RECENT_TIME_RECOVERY`.

key = (stringa); value = (stringa). Sintassi abbreviata:

```
KeyName1=string,KeyName2=string
```

Sintassi JSON:

```
{"string": "string"
  ...}
```

`--idempotency-token` è una stringa scelta dal cliente che puoi utilizzare per distinguere tra chiamate a `StartRestoreJob` altrimenti identiche. Riprovare una richiesta riuscita con lo stesso token di idempotenza restituisce un messaggio di completamento senza alcuna azione eseguita.

`--resource-type` è una stringa che avvia un processo per ripristinare un punto di ripristino per una delle seguenti risorse: `SAP HANA on Amazon EC2` per SAP HANA su Amazon EC2. *Facoltativamente*, le risorse SAP HANA possono essere contrassegnate utilizzando il comando `aws ssm-sap tag-resource`

**Output**: `RestoreJobId` è una stringa che identifica in modo univoco il processo che ripristina un punto di ripristino.

## Ripristino di SAP HANA High Availability (HA)
<a name="saphanarestoreha"></a>

Ci sono considerazioni importanti e passaggi aggiuntivi da includere quando si ripristina un sistema ad alta disponibilità (HA) di SAP HANA. Espandi la sezione seguente che meglio si adatta al tuo caso d'uso.

Scenario di ripristino:

### Database di sistema su un target SAP HANA HA
<a name="systemdbtargetha"></a>

Prima di eseguire il ripristino sul sistema SAP HANA HA di destinazione (destinazione),

1. Se è installato un cluster, metti tutte le note del cluster in modalità Manutenzione.

1. Arresta il database SAP HANA su tutti i nodi, compresi quelli primari e secondari.

1. *(Consigliato)* Disattiva tutti i piani di backup per assicurarti che non interferiscano con l'operazione di ripristino.

Al termine del processo di ripristino, accedi al sistema SAP HANA HA ripristinato, quindi:

1. Avvia il database SAP HANA nella modalità principale.

1. Avvia manualmente qualsiasi database tenant in cui il database di sistema è stato ripristinato ma i relativi tenant non sono stati ripristinati.

1. Ristabilisci la replica del sistema SAP HANA (HSR) tra i nodi primario e secondario.

1. Avvia il database SAP HANA sul nodo secondario.

1. Se è installato un cluster, assicurati che tutti i nodi del cluster siano online.

1. Abilita tutti i piani di backup che hai disabilitato prima dell'operazione di ripristino.

*(Facoltativo)* È possibile mantenere l'applicazione sincronizzata su [AWS Systems Manager for SAP [https://docs.aws.amazon.com/ssmsap/latest/APIReference/API_StartApplicationRefresh.html](https://docs.aws.amazon.com/ssmsap/latest/APIReference/API_StartApplicationRefresh.html)](https://docs.aws.amazon.com/ssm-sap/latest/userguide/what-is-ssm-for-sap.html)chiamando oppure è possibile attendere l'aggiornamento pianificato dell'applicazione che porterà i metadati SAP più recenti.

### Database di sistema su una destinazione SAP HANA a nodo singolo
<a name="systemdbtargetsingle"></a>

Prima di iniziare un processo di ripristino, vai al sistema SAP HANA a nodo singolo di destinazione, quindi:

1. Arresta il database SAP HANA sul sistema SAP HANA di destinazione.

1. *(Consigliato)* Disattiva tutti i piani di backup per assicurarti che non interferiscano con l'operazione di ripristino.

Al termine del processo di ripristino, vai al sistema SAP HANA a nodo singolo di destinazione, quindi:

1. Avvia SAP HANA sul sistema SAP HANA di destinazione.

1. Avvia manualmente ogni database tenant sul nodo di destinazione.

1. Abilita tutti i piani di backup disabilitati prima dell'operazione di ripristino.

*(Facoltativo)* È possibile mantenere l'applicazione sincronizzata su [AWS Systems Manager for SAP [https://docs.aws.amazon.com/ssmsap/latest/APIReference/API_StartApplicationRefresh.html](https://docs.aws.amazon.com/ssmsap/latest/APIReference/API_StartApplicationRefresh.html)](https://docs.aws.amazon.com/ssm-sap/latest/userguide/what-is-ssm-for-sap.html)chiamando oppure è possibile attendere l'aggiornamento pianificato dell'applicazione che porterà i metadati SAP più recenti.

### Database dei tenant (esistente o copia di sistema)
<a name="tenantdb"></a>

Prima di iniziare un processo di ripristino, vai al sistema SAP HANA di destinazione, quindi:

1. *(Facoltativo, ma consigliato)* Metti tutti i cluster installati in modalità di manutenzione per evitare un'acquisizione imprevista durante l'operazione di ripristino.

1. Assicurati che il database di sistema sia in esecuzione sul sistema SAP HANA di destinazione.

1. *(Consigliato)* Disattiva tutti i piani di backup per assicurarti che non interferiscano con l'operazione di ripristino.

Al termine del processo di ripristino:
+ Abilita tutti i piani di backup disabilitati prima dell'operazione di ripristino.

## Risoluzione dei problemi
<a name="saphanarestoretroubleshooting"></a>

Se durante il tentativo di eseguire un'operazione di backup si verifica uno dei seguenti errori, consulta la risoluzione associata.
+ **Errore: errore** nel registro di backup continuo

  Per mantenere i punti di ripristino per i backup continui, i log vengono creati da SAP HANA per tutte le modifiche. Quando i log non sono disponibili, lo stato di ciascuno di questi punti di ripristino continui è `STOPPED`. L'ultimo punto di ripristino valido che può essere utilizzato per il ripristino è quello con lo stato `AVAILABLE`. Se i dati di log mancano per il tempo tra i punti di ripristino con uno stato `STOPPED` e i punti con uno stato `AVAILABLE`, non è possibile garantire che il ripristino abbia esito positivo in questi orari. Se inserisci una data e un'ora comprese in questo intervallo, AWS Backup tenterà di eseguire il backup, ma utilizzerà l'ora ripristinabile più vicina disponibile. Questo errore verrà visualizzato dal messaggio `“Encountered an issue with log backups. Please check SAP HANA for details."`

  **Risoluzione:** nella console, viene visualizzata l'ora ripristinabile più recente, in base ai log. Puoi inserire un'ora più recente di quella visualizzata. Tuttavia, se i dati relativi a questo periodo non sono disponibili nei registri, AWS Backup utilizzerà l'ora di ripristino più recente.
+ **Errore:** `Internal error`

  **Soluzione:** crea una richiesta di supporto dalla tua console o contatta Supporto i dettagli del ripristino, ad esempio l'ID del processo di ripristino.
+ **Errore:** `The provided role arn:aws:iam::ACCOUNT_ID:role/ServiceLinkedRole cannot be assumed by AWS Backup`

  **Risoluzione:** assicurati che il ruolo assunto durante la chiamata al ripristino disponga delle autorizzazioni necessarie per creare ruoli collegati al servizio.
+ **Errore:** `User: arn:aws:sts::ACCOUNT_ID:assumed-role/ServiceLinkedRole/AWSBackup-ServiceLinkedRole is not authorized to perform: ssm-sap:GetOperation on resource: arn:aws:ssm-sap:us-east-1:ACCOUNT_ID:...`

  **Risoluzione:** assicurati che il ruolo assunto durante la chiamata alle autorizzazioni di ripristino descritte nei prerequisiti sia inserito correttamente.
+ **Errore:** `b* 449: recovery strategy could not be determined: [111014] The backup with backup id '1660627536506' cannot be used for recovery SQLSTATE: HY000\n`

  **Risoluzione:** assicurati che l'agente Backint sia stato installato correttamente. Verifica tutti i prerequisiti, in particolare [Install AWS BackInt Agent and AWS Systems Manager for SAP](https://docs.aws.amazon.com/sap/latest/sap-hana/aws-backint-agent-installing-configuring.html) sul tuo server delle applicazioni SAP, quindi riprova a installare l'agente. BackInt 
+ **Errore:** `IllegalArgumentException: Restore job provided is not ready to return chunks, current restore job status is: CANCELLED`

  **Risoluzione:** il processo di ripristino è stato annullato dal flusso di lavoro del servizio. Riprova il processo di ripristino.
+ **Errore:** è stato riscontrato un problema durante il ripristino di un database tenant su un sistema SAP HANA High Availability: `b* -10709: Connection failed (RTE:[89006] System call 'connect' failed, rc=111:Connection refused ([::1]:40404 → localhost:30013))\n`

  **Risoluzione:** controlla SAP HANA per assicurarti che SYSTEMDB sia attivo e funzionante.
+ **Errore:** `b'* 448: recovery could not be completed: [301102] exception 301153: Sending root key to secondary failed: connection refused. This may be caused by a stopped system replication secondary. Please keep the secondary online to receive the restored root key. Alternatively you could unregister the secondary site in case of an urgent recovery.\n SQLSTATE: HY000\n'`

  **Risoluzione:** su un sistema SAP HANA High Availability, SAP HANA potrebbe non essere in esecuzione sul nodo secondario mentre è in esecuzione un'operazione di ripristino attiva. Avvia SAP HANA sul nodo secondario, quindi riprova il processo di ripristino.
+ **Errore:** `RequestError: send request failed\ncaused by: read tcp 10.0.131.4:40482->35.84.99.47:443: read: connection timed out"`

  **Risoluzione:** instabilità di rete temporanea si verifica sull'istanza. Riprova a eseguire il ripristino. Se questo problema si verifica costantemente, prova ad aggiungere `ForceRetry: "true"` al file di configurazione dell'agente in `/hana/shared/aws-backint-agent/aws-backint-agent-config.yaml.` 

Per qualsiasi altro problema relativo all'agente AWS Backint, consulta [Risoluzione dei problemi di Backint AWS Agent](https://docs.aws.amazon.com/sap/latest/sap-hana/aws-backint-agent-troubleshooting.html) per SAP HANA.

# Ripristina i dati S3 utilizzando AWS Backup
<a name="restoring-s3"></a>

Puoi ripristinare i dati S3 di cui hai eseguito il backup nella classe AWS Backup di storage S3 Standard. Puoi ripristinare tutti gli oggetti in un bucket o oggetti specifici. Puoi ripristinarli in un bucket nuovo o esistente.

## Autorizzazioni di ripristino Amazon S3
<a name="s3-restore-permissions"></a>

Prima di iniziare a ripristinare le risorse, assicurati che il ruolo che stai utilizzando disponga di autorizzazioni sufficienti.

Per ulteriori informazioni, consulta le seguenti voci sulle politiche:

1. [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSBackupServiceRolePolicyForS3Restore.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSBackupServiceRolePolicyForS3Restore.html)

1. [https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSBackupServiceRolePolicyForRestores.html](https://docs.aws.amazon.com/aws-managed-policy/latest/reference/AWSBackupServiceRolePolicyForRestores.html)

1. [Politiche gestite per AWS Backup](security-iam-awsmanpol.md)

## Considerazioni sul ripristino di Amazon S3
<a name="s3-restore-considerations"></a>
+ Se ACLs sono state abilitate durante il backup, il bucket di destinazione per il ripristino deve essere ACLs abilitato; in caso contrario, il processo di ripristino avrà esito negativo.
+ Se Block Public Access è abilitato nel bucket di destinazione, il processo di ripristino viene completato correttamente, ma gli oggetti con public non ACLs vengono ripristinati.
+ I ripristini degli oggetti vengono ignorati se il bucket di destinazione ha un oggetto con lo stesso nome o ID di versione.
+ Quando ripristini il bucket S3 originale,
  + AWS Backup non esegue un ripristino distruttivo, il che significa AWS Backup che non inserisce un oggetto in un bucket al posto di un oggetto già esistente, indipendentemente dalla versione.
  + Un marker di eliminazione nella versione corrente viene considerato come un oggetto inesistente, quindi può verificarsi un ripristino.
  + AWS Backup non elimina oggetti (senza marcatori di eliminazione) da un bucket durante un ripristino (esempio: le chiavi attualmente nel bucket che non erano presenti durante il backup rimarranno).
+ **Ripristino di copie tra regioni**
  + Sebbene i backup S3 possano essere copiati tra regioni, i processi di ripristino vengono eseguiti solo nella stessa regione in cui si trova il backup o la copia originale.  
**Example**  

    **Esempio:** un bucket S3 creato nella regione Stati Uniti orientali (Virginia settentrionale) può essere copiato nella regione Canada (Centrale). Il processo di ripristino può essere avviato utilizzando il bucket originale nella regione Stati Uniti orientali (Virginia settentrionale) e ripristinato in tale regione, oppure il processo di ripristino può essere avviato utilizzando la copia nella regione Canada (Centrale) e ripristinato in tale regione.
  + Il metodo di crittografia originale non può essere utilizzato per ripristinare un punto di ripristino (backup) copiato da un'altra regione. La AWS KMS crittografia delle copie tra regioni non è disponibile per le risorse Amazon S3; utilizza invece un tipo di crittografia diverso per un processo di ripristino.

## Ripristino dei tag e degli oggetti ACLs
<a name="s3-restore-acl-options"></a>

Quando ripristini i dati di Amazon S3, scegli ACLs se far parte del ripristino.

Se ACLs sono disponibili nel punto di ripristino, scegli di ripristinarli o escluderli ACLs utilizzando l' ACLs impostazione Ripristina; se non ACLs sono presenti nel backup, non possono essere ripristinati indipendentemente dall'impostazione. Se si tenta di creare un processo di ripristino con i dati ACls abilitati ma non facevano parte del backup, è possibile che venga visualizzato un errore del tipo`Unable to restore Access Control Lists (ACLs) for bucket because backup was created with the 'BackupACLs' option disabled. Please proceed with restoring without ACLs`.

I tag degli oggetti vengono ripristinati automaticamente se erano inclusi nel backup originale

**Nota**  
Ripristino dei punti di ripristino senza ACLs  
 AWS CLI Se si tenta di eseguire il ripristino ACLs da un backup escluso ACLs, l'operazione di ripristino avrà esito negativo e verrà visualizzato un messaggio di errore che indica parametri di ripristino non validi.

## Ripristina più versioni
<a name="s3-restore-versions"></a>

Per impostazione predefinita, AWS Backup ripristina solo la versione più recente degli oggetti. È possibile scegliere di ripristinare versioni aggiuntive o tutte le versioni degli oggetti.

Per informazioni su come ripristinare le 10 versioni più recenti o tutte le versioni utilizzando la AWS Backup console, consultate il passaggio 6 nella sezione seguente.

Vedi [Ripristina i punti di ripristino di Amazon S3 tramite AWS CLI](#s3-restore-cli) più avanti in questa pagina per i dettagli sui metadati da includere durante il ripristino a livello di codice.

## Esegui il ripristino tramite la console AWS Backup
<a name="s3-restore-console"></a>

**Per ripristinare i dati di Amazon S3 utilizzando la AWS Backup console:**

1. Apri la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette** e seleziona l'ID della risorsa Amazon S3 che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionato. Per ripristinare una risorsa:

   1. Nel riquadro **Backup**, scegli l'ID del punto di ripristino della risorsa.

   1. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

      In alternativa, puoi accedere al vault di backup, trovare il punto di ripristino, quindi fare clic su **Azioni** e scegliere **Ripristina**.

1. Se stai ripristinando un backup continuo, nel riquadro **Ora di ripristino**, seleziona una delle opzioni:

   1. Accetta l'impostazione predefinita per ripristinare all'**Ora ripristinabile più recente**.

   1. **Specifica data e ora** in cui eseguire il ripristino.

1. Nel riquadro **Impostazioni**, seleziona **Ripristina l'intero bucket** o **Ripristino a livello di elemento**. 

   1. Se si sceglie il **ripristino a livello di elemento**, si ripristinano fino a 5 elementi (oggetti o cartelle in un bucket) per processo di ripristino specificando l'[URI S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html) di ciascun elemento che identifica in modo univoco l'oggetto.

      (Per ulteriori informazioni sul bucket S3 URIs, consulta [Metodi per accedere a un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/access-bucket-intro.html) nella Guida per l'*utente di Amazon Simple Storage Service*.)

   1. Scegli **Aggiungi elemento** per specificare un altro elemento da ripristinare.

1. Per impostazione predefinita, viene ripristinata solo la versione più recente di un oggetto. È possibile ripristinare fino alle 10 versioni più recenti o ripristinare tutte le versioni degli oggetti. Seleziona la tua preferenza dal menu a discesa.

1. Scegli la **Destinazione di ripristino**. Puoi scegliere **Ripristina nel bucket della fonte**, **Utilizza bucket esistente** o **Crea nuovo bucket**.
**Nota**  
Il bucket di destinazione di ripristino deve avere il controllo delle versioni attivato. AWS Backup ti avvisa se il bucket selezionato non soddisfa questo requisito.

   1. Se scegli **Usa bucket esistente, seleziona il bucket** S3 di destinazione dal menu che mostra tutti i bucket esistenti nella tua regione corrente. AWS 

   1. Se scegli **Crea un nuovo bucket**, digita il **Nome del nuovo bucket**. Dopo aver creato il bucket, puoi modificare le impostazioni predefinite di versione BPA (Block Public Access) e S3.

1. **Per la crittografia degli oggetti nel bucket S3, puoi scegliere la crittografia degli oggetti ripristinata.** Utilizza **chiavi di crittografia originali** (di default), **chiave Amazon S3 (SSE-S3)** o **chiave AWS Key Management Service (SSE-KMS)**.

   Queste impostazioni si applicano solo alla crittografia degli oggetti nel bucket S3. Ciò non influisce sulla crittografia del bucket stesso.

   1. **Usa chiavi di crittografia originali (impostazione predefinita)** ripristina gli oggetti con le stesse chiavi di crittografia utilizzate dall'oggetto di origine. Se un oggetto di origine non era crittografato, questo metodo ripristina l'oggetto senza crittografia.

      Questa opzione di ripristino consente di scegliere facoltativamente una chiave di crittografia sostitutiva per crittografare gli oggetti di ripristino se la chiave originale non è disponibile.

   1. Se scegli **Chiave Amazon S3 (SSE-S3)**, non è necessario specificare altre opzioni.

   1. **Se scegli **AWS Key Management Service la chiave (SSE-KMS)**, puoi effettuare le seguenti scelte: **Chiave gestita da AWS (aws/s3)**, **Scegli tra le tue AWS KMS ** chiavi o Inserisci la chiave ARN. AWS KMS **

      1. Se scegli **Chiave gestita da AWS (aws/s3)**, non è necessario specificare altre opzioni.

      1. Se **scegli tra le tue AWS KMS chiavi, seleziona una chiave dal** menu a discesa. AWS KMS In alternativa, scegli **Crea chiave**.

      1. Se **inserisci AWS KMS la chiave ARN**, digita l'ARN nella casella di testo. In alternativa, scegli **Crea chiave**.

1. Nel riquadro **Ripristina ruolo** scegliere il ruolo IAM che AWS Backup assumerà per questo ripristino. 

1. Scegli **Restore backup (Ripristina backup)**. Viene visualizzato il riquadro **Lavori di ripristino**. Un messaggio nella parte superiore della pagina fornisce informazioni sul lavoro di ripristino.

## Ripristina i punti di ripristino di Amazon S3 tramite AWS CLI
<a name="s3-restore-cli"></a>

Utilizza `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`. Durante i ripristini di Amazon S3 puoi specificare i seguenti metadati:

```
// Mandatory metadata:
DestinationBucketName // The destination bucket for your restore.
        
// Optional metadata:
RestoreACLs // Boolean. If ACLs were part of the backup, include and set to TRUE. If the backup 
does not include ACLs and this parameter is included, set to FALSE.
EncryptionType // The type of encryption to encrypt your restored objects. Options are original (same encryption as the original object), SSE-S3, or SSE-KMS).
ItemsToRestore // A list of up to five paths of individual objects to restore. Only required for item-level restore.
KMSKey // Specifies the SSE-KMS key to use. Only needed if encryption is SSE-KMS.
RestoreLatestVersionsUpTo // Include this optional parameter to multiple versions.
RestoreTime // The restore time (only valid for continuous recovery points where it is required, in format 2021-11-27T03:30:27Z).
```

`RestoreLatestVersionsUpTo`è una coppia chiave-valore di metadati opzionale. Per impostazione predefinita, o se viene omessa, viene ripristinata la versione più recente. Includi questi metadati per ripristinare versioni aggiuntive dei tuoi oggetti. I valori accettati sono:
+ `1`(per ripristinare la versione più recente)
+ `n`, dove *n* è un numero intero positivo maggiore di 1. Verranno ripristinate le ultime *n* versioni degli oggetti. Se il numero effettivo di versioni di un oggetto è inferiore a *n*, quel numero di versioni verrà ripristinato per quell'oggetto.
+ `all`(per ripristinare tutte le versioni)

## Stato del punto di ripristino
<a name="s3-recovery-point-status"></a>

I punti di ripristino sono caratterizzati da uno stato.

`EXPIRED`lo stato indica che il punto di ripristino ha superato il periodo di conservazione, ma non AWS Backup dispone dell'autorizzazione o non è altrimenti in grado di eliminarlo. Per eliminare manualmente questi punti di ripristino, consulta [Passaggio 3: Eliminare i punti di ripristino](https://docs.aws.amazon.com/aws-backup/latest/devguide/gs-cleanup-resources.html#cleanup-backups) nella sezione *Pulizia delle risorse* di *Nozioni di base*.

Lo stato `STOPPED` si verifica in un backup continuo in cui un utente ha eseguito alcune azioni che causano la disabilitazione del backup continuo. Ciò può essere causato dalla rimozione delle autorizzazioni, dalla disattivazione del controllo delle versioni, dalla disattivazione degli eventi inviati ad Amazon EventBridge o dalla disattivazione delle EventBridge regole messe in atto da. AWS Backup

Per risolvere lo stato `STOPPED`, assicurati che tutte le autorizzazioni richieste siano in essere e che il controllo delle versioni sia abilitato sul bucket S3. Una volta soddisfatte queste condizioni, l'istanza successiva di una regola di backup in esecuzione comporterà la creazione di un nuovo punto di ripristino continuo. Non è necessario eliminare i punti di ripristino con stato STOPPED.

## Messaggi di ripristino S3
<a name="s3-restore-messages"></a>

Quando un processo di ripristino viene completato o fallito, è possibile che venga visualizzato il seguente messaggio. La tabella seguente può aiutarti a determinare la possibile causa del messaggio di stato.


| Scenario | Stato di un processo | Messaggio | Esempio | 
| --- | --- | --- | --- | 
| Impossibile ripristinare tutti gli oggetti. | `FAILED` | «Nessun oggetto è stato ripristinato dal **RecoveryPointARN** al**bucket**. Per ricevere notifiche di questi errori, abilita le notifiche degli eventi SNS». |  Il ruolo utilizzato per avviare il processo di ripristino non è autorizzato a inserire oggetti nel bucket di destinazione. Il ruolo di ripristino non dispone dell'autorizzazione per verificare se la versione dell'oggetto esiste nel bucket di destinazione.  | 
| Uno o più oggetti (ma non tutti) non sono stati ripristinati. | COMPLETED |  «Impossibile ripristinare uno o più oggetti da **RecoveryPointARN** a**bucket**. Per ricevere notifiche di questi errori, abilita le notifiche degli eventi SNS».  |  Il ruolo utilizzato per avviare il processo di ripristino non ha accesso alla chiave KMS utilizzata da uno o più oggetti originali.  | 
| Non ci sono oggetti da ripristinare. | COMPLETED | «Non ci sono oggetti che corrispondono alla richiesta di ripristino»**RecoveryPointARN**. |  Il punto di ripristino (backup) del bucket di origine da ripristinare non ha oggetti. Il prefisso utilizzato per il processo di ripristino non corrisponde a nessun oggetto.  | 

# Ripristino di un volume Storage Gateway
<a name="restoring-storage-gateway"></a>

Se stai ripristinando uno snapshot di Gateway di archiviazione AWS volume, puoi scegliere di ripristinare lo snapshot come volume Storage Gateway o come volume Amazon EBS. Questo perché si AWS Backup integra con entrambi i servizi e qualsiasi snapshot di Storage Gateway può essere ripristinato su un volume Storage Gateway o su un volume Amazon EBS.

## Ripristina Storage Gateway tramite la AWS Backup console
<a name="restoring-sgw-console"></a>

**Per ripristinare un volume Storage Gateway**

1. Aprire la AWS Backup console in [https://console.aws.amazon.com/backup.](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette** e l'ID della risorsa Storage Gateway che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Per ripristinare una risorsa, nel riquadro **Backup** scegliere il pulsante di opzione accanto all'ID del punto di ripristino della risorsa. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. Specificare i parametri di ripristino per la risorsa. I parametri di ripristino immessi sono specifici del tipo di risorsa selezionato.

   Per **Tipo di risorsa**, scegli la AWS risorsa da creare durante il ripristino di questo backup.

1. Se scegli **Volume Storage Gateway**, seleziona un **Gateway** in uno stato raggiungibile. Scegli anche **Nome di destinazione iSCSI**.

   1. Per gateway "Volume archiviato", scegli un **ID disco**.

   1. Per gateway "Volume memorizzato nella cache", scegli una capacità pari almeno alla risorsa protetta.

   Se si sceglie **Volume EBS**, specificare i valori per **Tipo di volume**, **Dimensioni (GiB)**, e scegliere una **Zona di disponibilità**.

1. Per il **ruolo di ripristino**, scegli il ruolo IAM che AWS Backup assumerai per questo ripristino.
**Nota**  
Se il ruolo AWS Backup predefinito non è presente nel tuo account, viene creato un **ruolo predefinito** con le autorizzazioni corrette. Puoi eliminare questo ruolo predefinito o renderlo inutilizzabile.

1. Scegli **Restore backup (Ripristina backup)**.

   Viene visualizzato il riquadro **Lavori di ripristino**. Un messaggio nella parte superiore della pagina fornisce informazioni sul lavoro di ripristino.

## Ripristina Storage Gateway con AWS CLI
<a name="restoring-sgw-cli"></a>

Nell'interfaccia a riga di comando, [https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/start-restore-job.html](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/backup/start-restore-job.html) consente di ripristinare un volume Storage Gateway.

L'elenco seguente riporta i metadati accettati.

```
gatewayArn // The Amazon Resource Name (ARN) of the gateway. Use the ListGateways operation to return a list of gateways for your account and Regione AWS.
gatewayType // The type of created gateway. Valid value is BACKUP_VM
targetName
kmsKey
volumeSize
volumeSizeInBytes
diskId
```

# Ripristino di una tabella Amazon Timestream
<a name="timestream-restore"></a>

Quando si ripristina una tabella Amazon Timestream, esistono diverse opzioni da configurare, incluso il nuovo nome della tabella, il database di destinazione, le preferenze di allocazione dello storage (memoria e archivio magnetico) e il ruolo che verrà utilizzato per completare il processo di ripristino. È anche possibile scegliere un bucket Amazon S3 in cui archiviare i log di errore. Le scritture archivio magnetico sono asincrone, pertanto potrebbe essere necessario registrare gli errori.

L'archiviazione di dati Timestream ha due livelli: un archivio di memoria e un archivio magnetico. L'archivio di memoria è obbligatorio, ma è possibile trasferire la tabella ripristinata su un archivio magnetico al termine del tempo di memoria specificato. L'archivio di memoria è ottimizzato per scritture di dati ad alta velocità e query veloci. point-in-time L'archivio magnetico è ottimizzato per scritture dati late-arrival a bassa velocità di trasmissione effettiva, archiviazione di dati a lungo termine e query analitiche rapide.

Quando si ripristina una tabella Timestream, si determina per quanto tempo si desidera che la tabella rimanga in ciascun piano di storage. Utilizzando la console o l'API, puoi impostare il tempo di storage per entrambi. Tieni presente che lo storage è lineare e sequenziale. Timestream archivierà prima la tabella ripristinata nello storage in memoria, quindi la trasferirà automaticamente all'archivio magnetico quando viene raggiunto il tempo di storage in memoria.

**Nota**  
Il periodo di conservazione dell'archivio magnetico deve essere uguale o superiore al periodo di conservazione originale (mostrato nella parte superiore destra della console); in caso contrario, i dati andranno persi.

*Esempio:* si imposta l'allocazione dell'archivio di memoria per conservare i dati per una settimana e l'allocazione dell'archivio magnetico per conservare gli stessi dati per un anno. Quando i dati nell'archivio di memoria sono vecchi di una settimana, vengono spostati automaticamente nell'archivio magnetico. Vengono quindi mantenuti nell'archivio magnetico per un anno. Al termine di tale periodo, vengono eliminati da Timestream e da AWS Backup.

## Per ripristinare una tabella Amazon Timestream utilizzando la console AWS Backup
<a name="timestream-restore-console"></a>

Puoi ripristinare le tabelle Timestream nella AWS Backup console creata da. AWS Backup

1. [Apri la AWS Backup console in /backup. https://console.aws.amazon.com](https://console.aws.amazon.com/backup)

1. Nel riquadro di navigazione, scegli **Risorse protette** e l'ID della risorsa Amazon Timestream che desideri ripristinare.

1. Nella pagina **Dettagli della risorsa** viene visualizzato un elenco di punti di ripristino per l'ID risorsa selezionata. Per ripristinare una risorsa, nel riquadro **Backup** scegliere il pulsante di opzione accanto all'ID del punto di ripristino della risorsa. Nell'angolo superiore destro del riquadro, scegliere **Ripristina**.

1. Specifica le nuove impostazioni di configurazione della tabella, incluse:

   1. **Nome nuova tabella**, composto da 2 a 256 caratteri (lettere, numeri, trattini, punti e caratteri di sottolineatura).

   1. **Database di destinazione**, scelto dal menu a discesa.

1. **Allocazione dello storage**: imposta il tempo in cui la tabella ripristinata rimarrà per la prima volta nello [storage di memoria](https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html) e imposta il tempo in cui la tabella ripristinata rimarrà nello [storage magnetico](https://docs.aws.amazon.com/timestream/latest/developerguide/storage.html). Lo storage di memoria può essere impostato su ore, giorni, settimane o mesi. Lo storage magnetico può essere impostato su giorni, settimane, mesi o anni.

1. *(Opzionale)* **Abilita scritture archivio magnetico**: hai la possibilità di consentire le scritture archivio magnetico. Con questa opzione selezionata, i dati in ritardo, ovvero i dati con un timestamp che non rientra nel periodo di conservazione dello storage di memoria, verranno scritti direttamente nell'archivio magnetico.

1. *(Facoltativo)* **Posizione dei registri degli errori di Amazon S3**: puoi specificare una posizione S3 in cui verranno archiviati i log degli errori. Sfoglia i file S3 o copia e incolla il percorso file S3.
**Nota**  
Se si sceglie di specificare una posizione nel registro degli errori S3, il ruolo utilizzato per questo ripristino deve disporre dell'autorizzazione per scrivere su un bucket S3 oppure deve contenere una policy con tale autorizzazione.

1. Scegli il ruolo IAM da passare per eseguire i ripristini. Puoi utilizzare il ruolo IAM predefinito o specificarne uno diverso.

1. Fai clic su **Ripristina backup**.

I processi di ripristino saranno visibili in Risorse protette. Per visualizzare lo stato attuale del processo di ripristino, fai clic sul pulsante di aggiornamento o premi CTRL-R.

## Per ripristinare una tabella Amazon Timestream tramite API, CLI o SDK
<a name="timestream-restore-api"></a>

Utilizza [`StartRestoreJob` per ripristinare una tabella Timestream tramite API](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html).

Per ripristinare un Timestream utilizzando il AWS CLI, utilizzate l'operazione `start-restore-job.` e specificate i seguenti metadati:

```
TableName: string;
DestinationDatabase: string;
MemoryStoreRetentionPeriodInHours: value: number unit: 'hours' | 'days' | 'weeks' | 'months' 
MagneticStoreRetentionPeriodInDays: value: number unit: 'days' | 'weeks' | 'months' | 'years' 
EnableMagneticStoreWrites?: boolean;
aws:backup:request-id
```

Di seguito è riportato un modello di esempio:

```
aws backup start-restore-job \
--recovery-point-arn "arn:aws:backup:us-west-2:accountnumber:recovery-point:1a2b3cde-f405-6789-012g-3456hi789012_beta" \
--iam-role-arn "arn:aws:iam::accountnumber:role/rolename" \
--metadata 'TableName=tablename,DatabaseName=databasename,MagneticStoreRetentionPeriodInDays=1,MemoryStoreRetentionPeriodInHours=1,MagneticStoreWriteProperties="{\"EnableMagneticStoreWrites\":true,\"MagneticStoreRejectedDataLocation\":{\"S3Configuration\":{\"BucketName\":\"bucketname\",\"EncryptionOption\":\"SSE_S3\"}}}"' \
--region us-west-2 \
--endpoint-url url
```

Inoltre, puoi utilizzare [https://docs.aws.amazon.com/aws-backup/latest/devguide/API_DescribeRestoreJob.html](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_DescribeRestoreJob.html) per fornire assistenza con le informazioni di ripristino.

In AWS CLI, utilizzate l'operazione `describe-restore-job` e utilizzate i seguenti metadati:

```
TableName: string;
DestinationDatabase: string;
MemoryStoreRetentionPeriodInHours: value: number unit: 'hours' | 'days' | 'weeks' | 'months' 
MagneticStoreRetentionPeriodInDays: value: number unit: 'days' | 'weeks' | 'months' | 'years' 
EnableMagneticStoreWrites?: boolean;
```

Di seguito è riportato un modello di esempio:

```
aws backup describe-restore-job \
--restore-job-id restore job ID \
--region awsregion \
--endpoint-url url
```

# Ripristina una macchina virtuale utilizzando AWS Backup
<a name="restoring-vm"></a>

Puoi ripristinare una macchina virtuale su Cloud on VMware, VMware VMware Cloud on AWS AWS Outposts, un volume Amazon EBS o su [un'istanza Amazon EC2](https://docs.aws.amazon.com/aws-backup/latest/devguide/restoring-ec2.html). Il ripristino (o la migrazione) di una macchina virtuale su EC2 richiede una licenza. Per impostazione predefinita, AWS includerà una licenza (a pagamento). Per ulteriori informazioni, consulta le [opzioni di licenza nella Guida per](https://docs.aws.amazon.com/vm-import/latest/userguide/licensing.html) l'* Import/Export utente della macchina virtuale*.

È possibile ripristinare una macchina VMware virtuale utilizzando la AWS Backup console o tramite. AWS CLI Quando viene ripristinata una macchina virtuale, la cartella VMware Tools non è inclusa. Consulta VMware la documentazione per reinstallare VMware Tools.

AWS Backup i ripristini delle macchine virtuali non sono distruttivi, il che AWS Backup significa che non sovrascrivono le macchine virtuali esistenti durante un ripristino. Al contrario, il processo di ripristino implementa una nuova macchina virtuale.

**Topics**
+ [Considerazioni sul ripristino di una macchina virtuale su un'istanza Amazon EC2](#vm-restore-ec2)
+ [Usa la AWS Backup console per ripristinare i punti di ripristino delle macchine virtuali](#vm-restore-console)
+ [Utilizzalo AWS CLI per ripristinare i punti di ripristino delle macchine virtuali](#vm-restore-cli)

## Considerazioni sul ripristino di una macchina virtuale su un'istanza Amazon EC2
<a name="vm-restore-ec2"></a>
+ Il ripristino (o la migrazione) di una macchina virtuale su EC2 richiede una licenza. Per impostazione predefinita, un AWS includerà una licenza (a pagamento). Per ulteriori informazioni, consulta le [opzioni di licenza nella Guida per](https://docs.aws.amazon.com/vm-import/latest/userguide/licensing.html) l'* Import/Export utente della macchina virtuale*.
+ Esiste un limite massimo di 5 TB (terabyte) per ogni disco della macchina virtuale.
+ Non è possibile specificare una key pair quando si ripristina la macchina virtuale su un'istanza. Puoi aggiungere una key pair `authorized_keys` durante il lancio (tramite i dati utente dell'istanza) o dopo il lancio (come descritto in [questa sezione sulla risoluzione dei problemi](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/TroubleshootingInstancesConnecting.html#replacing-lost-key-pair) nella Guida per l'utente di Amazon EC2).
+ Verifica che il tuo [sistema operativo sia supportato](https://docs.aws.amazon.com/vm-import/latest/userguide/prerequisites.html#vmimport-operating-systems) per l'importazione e l'esportazione da Amazon EC2 nella *VM Import/Export * User Guide.
+ *Consulta le limitazioni relative all'[importazione di macchine virtuali in Amazon EC2 nella VM](https://docs.aws.amazon.com/vm-import/latest/userguide/prerequisites.html#limitations-image) User Guide. Import/Export *
+ Quando esegui il ripristino su un'istanza Amazon EC2 utilizzando AWS CLI, devi specificare. `"RestoreTo":"EC2Instance"` Tutti gli altri attributi hanno valori predefiniti.
+ Amazon EC2 offre [EC2](https://docs.aws.amazon.com//AWSEC2/latest/UserGuide/ec2-allowed-amis.html) Allowed. AMIs Se questa impostazione è abilitata nel tuo account, aggiungi l'alias `aws-backup-vault` alla tua lista di autorizzazioni. In caso contrario, le operazioni di ripristino dei punti di ripristino delle macchine virtuali sulle istanze EC2 falliranno e verrà visualizzato un messaggio di errore, ad esempio «Source AMI not found in Region».
+ I ripristini VMware su EC2 che coinvolgono più di 21 dischi non sono supportati. Come soluzione alternativa, utilizza VMware Restores [to EBS per ripristinare ogni disco singolarmente come volume EBS](https://docs.aws.amazon.com//aws-backup/latest/devguide/restoring-vm.html#restore-vm-ebs), quindi collega i volumi EBS a un'istanza EC2.

## Usa la AWS Backup console per ripristinare i punti di ripristino delle macchine virtuali
<a name="vm-restore-console"></a>

Puoi ripristinare una macchina virtuale da più posizioni nel riquadro di navigazione a sinistra della AWS Backup console:
+ Scegli **Hypervisor** per visualizzare i punti di ripristino per macchine virtuali gestite da un hypervisor connesso a AWS Backup.
+ Scegli **Macchine virtuali** per visualizzare i punti di ripristino per macchine virtuali in tutti gli hypervisor connessi a AWS Backup.
+ Scegli **Backup vault** per visualizzare i punti di ripristino archiviati in un AWS Backup vault specifico.
+ Scegli **Risorse protette** per visualizzare i punti di ripristino su tutte le tue risorse AWS Backup protette.

Se è necessario ripristinare una macchina virtuale che non dispone più di una connessione con Backup gateway, scegli **Vault di backup** o **Risorse protette** per individuare il punto di ripristino.

**Opzioni**
+ [Ripristina in VMware](#restore-vm-vmware)
+ [Ripristino su un volume Amazon EBS](#restore-vm-ebs)
+ [Ripristina su un'istanza Amazon EC2](#restore-vm-ec2)<a name="restore-vm-vmware"></a>

**Per ripristinare una macchina virtuale su VMware Cloud on AWS e VMware Cloud on VMware AWS Outposts**

1. Nelle visualizzazioni **Hypervisor** o **Macchine virtuali**, scegli il **nome della VM** da ripristinare. Nella vista **Risorse protette**, scegli l'**ID risorsa** della macchina virtuale da ripristinare.

1. Scegli il pulsante radiale accanto all'**ID punto di ripristino** da ripristinare.

1. Scegli **Restore** (Ripristina).

1. Scegli il **Tipo di ripristino**.

   1. **Ripristino completo** ripristina tutti i dischi della macchina virtuale.

   1. **Ripristino a livello di disco** ripristina una selezione definita dall'utente di uno o più dischi. Utilizza il menu a discesa per selezionare i dischi da ripristinare.

1. Scegli la **Posizione di ripristino**. Le opzioni sono **VMwareVMware ****Cloud on AWS** e **VMware Cloud on AWS Outposts**.

1. Se stai eseguendo un ripristino completo, passa alla fase successiva. Se stai eseguendo un ripristino a livello di disco, verrà visualizzato un menu a discesa in **Dischi VM**. Scegli uno o più volumi avviabili da ripristinare.

1. Seleziona un **Hypervisor** dal menu a discesa per gestire la macchina virtuale ripristinata

1. Per la macchina virtuale ripristinata, utilizza le best practice della macchina virtuale dell'organizzazione per specificare:

   1. **Nome**

   1. **Percorso** (ad esempio `/datacenter/vm`)

   1. **Nome della risorsa di calcolo** (ad esempio VMHost o Cluster)

      Se un host fa parte di un cluster, non è possibile eseguire il ripristino sull'host ma solo sul cluster specificato.

   1. **Datastore**

1. Per **Ripristina ruolo**, seleziona **Ruolo predefinito** (scelta consigliata) o **Scegli un ruolo IAM** utilizzando il menu a discesa.

1. Scegli **Restore backup (Ripristina backup)**.

1. *Facoltativo*: verifica quando lo stato del processo di ripristino è `Completed`. Nel riquadro di navigazione a sinistra, scegli **Processi**.<a name="restore-vm-ebs"></a>

**Per ripristinare una macchina virtuale su un volume Amazon EBS**

1. Nelle visualizzazioni **Hypervisor** o **Macchine virtuali**, scegli il **nome della VM** da ripristinare. Nella vista **Risorse protette**, scegli l'**ID risorsa** della macchina virtuale da ripristinare.

1. Scegli il pulsante radiale accanto all'**ID punto di ripristino** da ripristinare.

1. Scegli **Restore** (Ripristina).

1. Scegli il **Tipo di ripristino**.

   1. **Ripristino del disco** ripristina una selezione definita dall'utente di un disco. Utilizza il menu a discesa per selezionare il disco da ripristinare.

1. Scegli la **Posizione di ripristino** come **Amazon EBS**.

1. Nel menu a discesa **Disco VM**, scegli il volume avviabile da ripristinare.

1. Per **Tipo di volume EBS**, scegli il tipo di volume.

1. Scegli la zona di disponibilità.

1. Crittografia (facoltativo). Seleziona la casella se scegli di crittografare il volume EBS.

1. Seleziona la tua chiave KMS dal menu.

1. Per il **ruolo di ripristino,** seleziona il **ruolo predefinito** (consigliato) o **Scegli un ruolo IAM**.

1. Scegli **Restore backup (Ripristina backup)**.

1. *Facoltativo*: verifica quando lo stato del processo di ripristino è `Completed`. Nel riquadro di navigazione a sinistra, scegli **Processi**.

1. *Facoltativo*: visita [Come si usa LVM per creare un volume logico sulla partizione di un volume Amazon EBS](https://repost.aws/knowledge-center/create-lv-on-ebs-partition)? per saperne di più su come montare volumi gestiti e accedere ai dati sul volume Amazon EBS ripristinato.<a name="restore-vm-ec2"></a>

**Per ripristinare una macchina virtuale su un'istanza Amazon EC2**

1. Nelle visualizzazioni **Hypervisor** o **Macchine virtuali**, scegli il **nome della VM** da ripristinare. Nella vista **Risorse protette**, scegli l'**ID risorsa** della macchina virtuale da ripristinare.

1. Scegli il pulsante radiale accanto all'**ID punto di ripristino** da ripristinare.

1. Scegli **Restore** (Ripristina).

1. Scegli il **Tipo di ripristino**.

   1. **Ripristino completo** ripristina completamente il file system, inclusi la cartella e i file a livello di root.

1. Scegli la **Posizione di ripristino** come **Amazon EC2**.

1. Per **tipo di istanza**, scegli la combinazione di elaborazione e memoria necessaria per eseguire l'applicazione sulla nuova istanza.
**Suggerimento**  
Scegli un tipo di istanza che corrisponda o superi le specifiche della macchina virtuale originale. Per maggiori informazioni, consulta la [ Guida ai tipi di istanza Amazon EC2](https://docs.aws.amazon.com/ec2/latest/instancetypes/).

1. Per **Virtual Private Cloud (VPC)**, scegli un cloud privato virtuale (VPC), che definisce l'ambiente di rete per l'istanza.

1. Per **Subnet**, scegli una delle sottoreti nel VPC. L'istanza riceve un indirizzo IP privato dall'intervallo di indirizzi della sottorete.

1. Per **i gruppi di sicurezza**, scegli un gruppo di sicurezza che funga da firewall per il traffico verso la tua istanza.

1. Per **il ruolo di ripristino,** seleziona il **ruolo predefinito** (consigliato) o **Scegli un ruolo IAM**.

1. *Facoltativo*: per eseguire uno script sull'istanza all'avvio, espandi **Impostazioni avanzate** e inserisci lo script in **Dati utente**.

1. Scegli **Restore backup (Ripristina backup)**.

1. *Facoltativo*: verifica quando lo stato del processo di ripristino è `Completed`. Nel riquadro di navigazione a sinistra, scegli **Processi**.

## Utilizzalo AWS CLI per ripristinare i punti di ripristino delle macchine virtuali
<a name="vm-restore-cli"></a>

Utilizza `[StartRestoreJob](https://docs.aws.amazon.com/aws-backup/latest/devguide/API_StartRestoreJob.html)`.

Puoi specificare i seguenti metadati per il ripristino di una macchina virtuale su Amazon EC2 e Amazon EBS:

```
RestoreTo
InstanceType
VpcId
SubnetId
SecurityGroupIds
IamInstanceProfileName
InstanceInitiatedShutdownBehavior
HibernationOptions
DisableApiTermination
Placement
CreditSpecification
RamdiskId
KernelId
UserData
EbsOptimized
LicenseSpecifications
KmsKeyId
AvailabilityZone
EbsVolumeType
IsEncrypted
ItemsToRestore
RequireIMDSv2
NetworkInterfaces
```

AWS Backup supporta sia ripristini parziali su Amazon EBS che ripristini completi su Amazon EC2. Per i ripristini parziali, utilizza `ItemsToRestore` per specificare quale disco ripristinare nel volume EBS specificato. Durante il ripristino su Amazon EC2, il `ItemsToRestore` parametro può essere lasciato vuoto perché viene ignorato e viene ripristinato l'elenco completo dei dischi.

Puoi specificare i seguenti metadati per il ripristino di una macchina virtuale su Cloud on e VMware cloud su Outpost AWS: VMware VMware AWS 

```
RestoreTo
HypervisorArn
VMName
VMPath
ComputeResourceName
VMDatastore
DisksToRestore
ItemsToRestore
```

AWS Backup supporta ripristini parziali e completi su una macchina virtuale locale. È possibile scegliere di ripristinare tutti i dischi o solo un sottoinsieme di dischi. Quando si esegue un ripristino parziale, specificare la selezione del disco in. `ItemsToRestore` Quando si esegue un ripristino completo, è necessario omettere entrambi `DisksToRestore` e `ItemsToRestore` o specificare tutti i dischi presenti. `DisksToRestore` Il `DisksToRestore` parametro non supporta sottoinsiemi di dischi.

Questo esempio mostra come eseguire un ripristino completo su: VMware

```
'{"RestoreTo":"VMware","HypervisorArn":"arn:aws:backup-gateway:us-east-1:209870788375:hypervisor/hype-9B1AB1F1","VMName":"name","VMPath":"/Labster/vm","ComputeResourceName":"Cluster","VMDatastore":"vsanDatastore","DisksToRestore":"[{\"DiskId\":\"2000\",\"Label\":\"Hard disk 1\"}]","vmId":"vm-101"}'
```