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à.
# Ripristino a un determinato punto nel tempo
Puoi ripristinare un cluster in qualsiasi momento compreso nel periodo di conservazione del backup del cluster utilizzando Console di gestione AWS or AWS Command Line Interface (AWS CLI).
**Nota**
Non è possibile eseguire un ripristino point-in-time da un cluster 3.6 a un cluster 4.0, ma è possibile migrare da una versione del cluster a un'altra. Per ulteriori informazioni, consulta [Migrazione e aggiornamento di Amazon DocumentDB](docdb-migration.md).
Tieni presente quanto segue quando ripristini un cluster a un punto temporale specifico.
+ Il nuovo cluster viene creato con la stessa configurazione del cluster di origine, ma utilizza il gruppo di parametri predefinito. Per impostare il gruppo di parametri del nuovo cluster su quello del cluster di origine, occorre modificare il cluster appena risulta *disponibile*. Per ulteriori informazioni sulla modifica di un cluster, consulta [Modifica di un cluster Amazon DocumentDB](db-cluster-modify.md).
------
#### [ Using the Console di gestione AWS ]
È possibile ripristinare un cluster in un point-in-time entro il periodo di retention dei backup completando quanto segue utilizzando la Console di gestione AWS.
1. Accedi a e apri la console Amazon Console di gestione AWS DocumentDB all'indirizzo. [ https://console.aws.amazon.com/docdb ](https://console.aws.amazon.com/docdb)
1. Nel pannello di navigazione scegliere **Cluster**. Dall'elenco di cluster scegliere il pulsante a sinistra del cluster che si desidera ripristinare.
**Suggerimento**
Se il riquadro di navigazione non viene visualizzato sul lato sinistro della schermata, scegliere l'icona del menu () nell'angolo in alto a sinistra della pagina.
1. Nel menu **Actions (Operazioni)** scegliere **Restore to point in time (Esegui ripristino point in time)**.
1. Completare la sezione **Restore time (Ora ripristino)**, in cui si specificano data e ora per il ripristino.
1. **Data di ripristino**: scegli o inserisci una data compresa tra il ** primo tempo di ripristino ** e l'**ultimo orario di ripristino. **
1. **Tempo di ripristino**: scegli o inserisci l'ora, i minuti e i secondi compresi tra il ** primo ripristino ** e l'**ultimo tempo di ripristino. **
1. Completare la sezione **Configurazione**.
1. **Identificatore del cluster**: accetta l'identificatore predefinito o inserisci un identificatore che preferisci.
Vincoli per la denominazione del cluster:
+ La lunghezza è di [1—63] lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ Deve essere univoco per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS
1. **Classe di istanza**: dall'elenco a discesa, scegli la classe di istanza desiderata per le istanze del cluster.
1. **Numero di istanze**: dall'elenco a discesa, scegli il numero di istanze da creare quando il cluster viene ripristinato.
1. Per la configurazione dello storage ** del cluster**, scegli un'opzione di archiviazione.
**Nota**
**La configurazione I/O-Optimized ** dello storage di Amazon DocumentDB è disponibile solo nelle versioni del motore Amazon DocumentDB 5.0 e 8.0.
1. Opzionale. Per configurare le impostazioni di rete, le opzioni del cluster e abilitare le esportazioni dei log, scegliere **Show advanced settings (Mostra impostazioni avanzate)** e completare le sezioni seguenti. In alternativa, passare alla fase successiva.
+ **Impostazioni di rete**
1. **Virtual Private Cloud (VPC)**: dall'elenco a discesa, scegli il VPC che desideri utilizzare per questo cluster.
1. **Gruppo di sottorete**: dall'elenco a discesa, scegli il gruppo di sottorete per questo cluster.
1. **Gruppi di sicurezza VPC**: dall'elenco a discesa, scegli i gruppi di sicurezza VPC per questo cluster.
+ **Cluster options (Opzioni cluster)**
1. **Porta**: accetta la porta predefinita (27017) o utilizza le frecce su e giù per impostare la porta per comunicare con questo cluster.
+ **Log exports (Esportazioni log)**
1. **Log di controllo**: seleziona questa opzione per abilitare l'esportazione dei log di controllo in Amazon Logs. CloudWatch Se selezioni questa opzione, devi abilitare `audit_logs` nel gruppo personalizzato dei parametri del cluster. Per ulteriori informazioni, consulta [Verifica degli eventi di Amazon DocumentDB](event-auditing.md).
1. **Log di profiler**: seleziona questa opzione per abilitare l'esportazione dei log delle operazioni di profilazione in Amazon Logs. CloudWatch Se selezioni questa opzione, devi anche modificare i seguenti parametri nel gruppo personalizzato dei parametri del cluster:
+ `profiler`— Impostato su. `enabled`
+ `profiler_threshold_ms`— Impostato su un valore `[0-INT_MAX]` per impostare la soglia per le operazioni di profilazione.
+ `profiler_sampling_rate`— Impostare un valore `[0.0-1.0]` per impostare la percentuale di operazioni lente da profilare.
Per ulteriori informazioni, consulta [Profilazione delle operazioni di Amazon DocumentDB](profiling.md).
1. **Log del profiler**: esporta i log del profiler in Amazon CloudWatch
1. **Ruolo IAM**: dall'elenco a discesa, scegli * RDS Service Linked Role. *
+ **Tag**
1. **Aggiungi tag**: nella * casella * Chiave, inserisci il nome del tag per il tuo cluster. Nella casella *Value (Valore)* immetti facoltativamente il valore del tag. I tag vengono utilizzati con le policy AWS Identity and Access Management (IAM) per gestire l'accesso alle risorse di Amazon DocumentDB e per controllare quali azioni possono essere applicate alle risorse.
+ **Deletion protection (Protezione da eliminazione)**
1. **Abilita la protezione dalle eliminazioni**: protegge il cluster dall'eliminazione accidentale. Quando questa opzione è abilitata, non puoi eliminare il cluster.
1. Per ripristinare il cluster, scegliere **Create cluster (Crea cluster)**. In alternativa, è possibile scegliere **Cancel (Annulla)** per annullare l'operazione.
------
#### [ Using the AWS CLI ]
Per ripristinare un cluster a un punto temporale specifico con il periodo di retention dei backup della snapshot, utilizza l'operazione `restore-db-cluster-to-point-in-time` con i parametri seguenti.
+ **--db-cluster-identifier**— Obbligatorio. Il nome del nuovo cluster da creare. Questo cluster non può esistere prima di questa operazione. Il valore del parametro deve soddisfare i seguenti vincoli.
Vincoli per la denominazione del cluster:
+ La lunghezza è di [1—63] lettere, numeri o trattini.
+ Il primo carattere deve essere una lettera.
+ Non può terminare con un trattino o contenere due trattini consecutivi.
+ Deve essere univoco per tutti i cluster di Amazon RDS, Neptune e Amazon DocumentDB per regione. Account AWS
+ **--restore-to-time**— La data e l'ora UTC in cui ripristinare il cluster. Ad esempio, `2018-06-07T23:45:00Z`.
Vincoli temporali:
+ Deve essere prima dell'ultimo orario di ripristino per il cluster.
+ Deve essere specificato se il parametro `--use-latest-restorable-time` non viene fornito.
+ Non può essere specificato se il parametro `--use-latest-restorable-time` è `true`.
+ Non può essere specificato se il valore del parametro `--restore-type` è `copy-on-write`.
+ **--source-db-cluster-identifier**— Il nome del cluster di origine da cui eseguire il ripristino. Questo cluster deve esistere ed essere disponibile.
+ **--use-latest-restorable-time**oppure**--no-use-latest-restorable-time**: se eseguire il ripristino all'orario di backup ripristinabile più recente. Non può essere specificato se il parametro `--restore-to-time` viene fornito.
+ **--storage-type standard \| iopt1**— Opzionale. Default: `standard`.
L' AWS CLI operazione ripristina `restore-db-cluster-to-point-in-time` solo il cluster, non le istanze di quel cluster. È necessario utilizzare l'operazione `create-db-instance` per creare le istanze per il cluster ripristinato, specificandone l'identificatore in `--db-cluster-identifier`. Puoi creare le istanze solo dopo che l'operazione `restore-db-cluster-to-point-in-time` è terminata e il cluster ripristinato è *disponibile*.
**Example**
L'esempio seguente crea `sample-cluster-restored` dallo snapshot `sample-cluster-snapshot` all'ultimo orario di ripristino.
Per Linux, macOS o Unix:
```
aws docdb restore-db-cluster-to-point-in-time \
--db-cluster-identifier sample-cluster-restored \
--source-db-cluster-identifier sample-cluster-snapshot \
--use-latest-restorable-time
```
Per Windows:
```
aws docdb restore-db-cluster-to-point-in-time ^
--db-cluster-identifier sample-cluster-restored ^
--source-db-cluster-identifier sample-cluster-snapshot ^
--use-latest-restorable-time
```
**Example**
Nell'esempio seguente viene creato `sample-cluster-restored` dallo snapshot `sample-cluster-snapshot` delle 3:15 dell'11 dicembre 2018 (UTC), ovvero un orario incluso nel periodo di retention dei backup di `sample-cluster`.
Per Linux, macOS o Unix:
```
aws docdb restore-db-cluster-to-point-in-time \
--db-cluster-identifier sample-cluster-restore \
--source-db-cluster-identifier sample-cluster \
--restore-to-time 2020-05-12T03:15:00Z
```
Per Windows:
```
aws docdb restore-db-cluster-to-point-in-time ^
--db-cluster-identifier sample-cluster-restore ^
--source-db-cluster-identifier sample-cluster ^
--restore-to-time 2020-05-12T03:15:00Z
```
L'aspetto dell'output di questa operazione è simile al seguente.
```
{
"DBCluster": {
"AvailabilityZones": [
"us-east-1c",
"us-west-2b",
"us-west-2a"
],
"BackupRetentionPeriod": 1,
"DBClusterIdentifier": "sample-cluster-restored",
"DBClusterParameterGroup": "sample-parameter-group",
"DBSubnetGroup": "default",
"Status": "creating",
"Endpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
"ReaderEndpoint": "sample-cluster-restored.node.us-east-1.docdb.amazonaws.com",
"MultiAZ": false,
"Engine": "docdb",
"EngineVersion": "4.0.0",
"Port": 27017,
"MasterUsername": "master-user",
"PreferredBackupWindow": "02:00-02:30",
"PreferredMaintenanceWindow": "tue:09:50-tue:10:20",
"DBClusterMembers": [],
"VpcSecurityGroups": [
{
"VpcSecurityGroupId": "sg-abc0123",
"Status": "active"
}
],
"HostedZoneId": "ABCDEFGHIJKLM",
"StorageEncrypted": true,
"KmsKeyId": "arn:aws:kms:us-east-1::key/sample-key",
"DbClusterResourceId": "cluster-ABCDEFGHIJKLMNOPQRSTUVWXYZ",
"DBClusterArn": "arn:aws:rds:us-east-1::cluster:sample-cluster-restored",
"AssociatedRoles": [],
"ClusterCreateTime": "2020-04-24T20:14:36.713Z",
"DeletionProtection": false
}
}
```
------