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à. # Backup delle raccolte tramite istantanee Le istantanee sono point-in-time backup delle tue raccolte Amazon OpenSearch Serverless che forniscono funzionalità di disaster recovery. OpenSearch Serverless crea e gestisce automaticamente istantanee delle tue raccolte, garantendo la continuità aziendale e la protezione dei dati. Ogni istantanea contiene metadati dell'indice (impostazioni e mappature per gli indici), metadati del cluster (modelli di indice e alias) e dati dell'indice (tutti i documenti e i dati archiviati negli indici). OpenSearch Serverless offre backup orari automatici senza configurazione manuale, zero costi di manutenzione, costi di storage aggiuntivi, ripristino rapido in caso di perdita accidentale di dati e la possibilità di ripristinare indici specifici da un'istantanea. Prima di lavorare con le istantanee, è necessario comprendere queste importanti considerazioni. La creazione di un'istantanea richiede tempo e non è istantanea. I nuovi documenti o gli aggiornamenti durante la creazione dell'istantanea non verranno inclusi nell'istantanea. È possibile ripristinare le istantanee solo nella raccolta originale e non in una nuova. Una volta ripristinati, gli indici ne ricevono di nuovi UUIDs che differiscono dalle versioni originali. Il ripristino di un indice aperto esistente in OpenSearch Serverless sovrascriverà i dati di tale indice, a condizione che non venga fornito un nuovo nome di indice o un modello di prefisso. Ciò differisce dal comportamento principale. OpenSearch È possibile eseguire una sola operazione di ripristino alla volta e non è possibile avviare più operazioni di ripristino contemporaneamente sulla stessa raccolta. Il tentativo di ripristinare gli indici durante un'operazione di ripristino attiva causa l'esito negativo dell'operazione. Durante un'operazione di ripristino, le richieste agli indici hanno esito negativo. ## Autorizzazioni richieste Per utilizzare le istantanee, configura le seguenti autorizzazioni nella tua politica di accesso ai dati. Per ulteriori informazioni sulle politiche di accesso ai dati, consulta. [Policy di accesso ai dati rispetto alle policy IAM](serverless-data-access.md#serverless-data-access-vs-iam) **** | Politica di accesso ai dati | APIs | | --- | --- | | aoss: DescribeSnapshot | GET /\$1 -automatizzato cat/snapshots/aossOTTIENI \$1/snapshot/aoss-automated/snapshot | | aos: RestoreSnapshot | POST /\$1 /\$1restore snapshot/aoss-automated/snapshot | | aos: DescribeCollectionItems | OTTIENI /\$1cat/recovery | È possibile configurare le politiche utilizzando i seguenti comandi: AWS CLI 1. [ create-access-policy](https://docs.aws.amazon.com/cli/latest/reference/opensearchserverless/create-access-policy.html) 1. [ delete-access-policy ](https://docs.aws.amazon.com/cli/latest/reference/opensearchserverless/delete-access-policy.html) 1. [ get-access-policy ](https://docs.aws.amazon.com/cli/latest/reference/opensearchserverless/get-access-policy.html) 1. [ update-access-policy ](https://docs.aws.amazon.com/cli/latest/reference/opensearchserverless/update-access-policy.html) Ecco un esempio di comando CLI per creare una politica di accesso. Nel comando, sostituisci il *example* contenuto con le tue informazioni specifiche. ``` aws opensearchserverless create-access-policy \ --type data \ --name Example-data-access-policy \ --region aws-region \ --policy '[ { "Rules": [ { "Resource": [ "collection/Example-collection" ], "Permission": [ "aoss:DescribeSnapshot", "aoss:RestoreSnapshot", "aoss:DescribeCollectionItems" ], "ResourceType": "collection" } ], "Principal": [ "arn:aws:iam::111122223333:user/UserName" ], "Description": "Data policy to support snapshot operations." } ]' ``` ## Utilizzo degli snapshot Per impostazione predefinita, quando crei una nuova raccolta, OpenSearch Serverless crea automaticamente istantanee ogni ora. Non è necessario eseguire nessuna operazione. Ogni istantanea include tutti gli indici della raccolta. Dopo che OpenSearch Serverless ha creato le istantanee, è possibile elencarle e rivederne i dettagli utilizzando le seguenti procedure. ### Elenca le istantanee Utilizzate le seguenti procedure per elencare tutte le istantanee di una raccolta e rivederne i dettagli. ------ #### [ Console ] 1. Apri la console Amazon OpenSearch Service all'indirizzo [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/). 1. Nel riquadro di navigazione a sinistra, scegli **Serverless**, quindi scegli **Collezioni**. 1. Scegli il nome della tua collezione per aprirne la pagina dei dettagli. 1. Scegli la scheda **Istantanee** per visualizzare tutte le istantanee generate. 1. Esamina le informazioni sulle istantanee, tra cui: + **ID istantanea**: identificatore univoco per l'istantanea + **Stato: stato** attuale (disponibile, in corso) + **Ora di creazione**: quando è stata scattata l'istantanea ------ #### [ AWS CLI ] + Utilizzate il seguente comando per elencare tutte le istantanee di una raccolta: ``` GET /_cat/snapshots/aoss-automated ``` OpenSearch Serverless restituisce una risposta simile alla seguente: ``` id status start_epoch start_time end_epoch end_time duration indexes successful_shards failed_shards total_shards snapshot-ExampleSnapshotID1 SUCCESS 1737964331 07:52:11 1737964382 07:53:02 50.4s 1 snapshot-ExampleSnapshotID2 SUCCESS 1737967931 08:52:11 1737967979 08:52:59 47.7s 2 snapshot-ExampleSnapshotID3 SUCCESS 1737971531 09:52:11 1737971581 09:53:01 49.1s 3 snapshot-ExampleSnapshotID4 IN_PROGRESS 1737975131 10:52:11 - - 4.8d 3 ``` ------ ### Ottieni i dettagli dell'istantanea Utilizza le seguenti procedure per recuperare informazioni dettagliate su un'istantanea specifica. ------ #### [ Console ] 1. Apri la console Amazon OpenSearch Service all'indirizzo [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/). 1. Nel riquadro di navigazione a sinistra, scegli **Serverless**, quindi scegli **Collezioni**. 1. Scegli il nome della tua collezione per aprirne la pagina dei dettagli. 1. Selezionare la scheda **Snapshots (Snapshot)**. 1. Scegli l'ID del lavoro dell'istantanea per visualizzare informazioni dettagliate sull'istantanea, inclusi i metadati, gli indici inclusi e le informazioni sulla tempistica. ------ #### [ AWS CLI ] + Utilizzate il comando seguente per recuperare informazioni su un'istantanea. Nel comando, sostituisci il *example* contenuto con le tue informazioni specifiche. ``` GET _snapshot/aoss-automated/snapshot/ ``` Richiesta di esempio: ``` GET _snapshot/aoss-automated/snapshot-ExampleSnapshotID1/ ``` Risposta di esempio: ``` { "snapshots": [ { "snapshot": "snapshot-ExampleSnapshotID1-5e01-4423-9833Example", "uuid": "Example-5e01-4423-9833-9e9eb757Example", "version_id": 136327827, "version": "2.11.0", "remote_store_index_shallow_copy": true, "indexes": [ "Example-index-0117" ], "data_streams": [], "include_global_state": true, "metadata": {}, "state": "SUCCESS", "start_time": "2025-01-27T09:52:11.953Z", "start_time_in_millis": 1737971531953, "end_time": "2025-01-27T09:53:01.062Z", "end_time_in_millis": 1737971581062, "duration_in_millis": 49109, "failures": [], "shards": { "total": 0, "failed": 0, "successful": 0 } } ] } ``` ------ La risposta istantanea include diversi campi chiave: `id` fornisce un identificatore univoco per l'operazione di istantanea, `status` restituisce lo stato corrente `SUCCESS` oppure `IN_PROGRESS` `duration` indica il tempo impiegato per completare l'operazione di snapshot e `indexes` restituisce il numero di indici inclusi nell'istantanea. ## Ripristino da uno snapshot Il ripristino da un'istantanea consente di recuperare i dati da un backup eseguito in precedenza. Questo processo è fondamentale per il disaster recovery e la gestione dei dati in Serverless. OpenSearch Prima del ripristino, tenete presente che gli indici ripristinati avranno caratteristiche diverse UUIDs rispetto alle versioni originali, il ripristino su un indice aperto esistente in OpenSearch Serverless sovrascriverà i dati di quell'indice a condizione che non venga fornito un nuovo nome di indice o uno schema di prefisso, le istantanee possono essere ripristinate solo nella raccolta originale (il ripristino tra raccolte non è supportato) e le operazioni di ripristino influiranno sulle prestazioni del cluster, quindi pianifica di conseguenza. Utilizzare le seguenti procedure per ripristinare gli indici di backup da un'istantanea. ------ #### [ Console ] 1. Apri la console Amazon OpenSearch Service all'indirizzo [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/). 1. Nel riquadro di navigazione a sinistra, scegli **Serverless**, quindi scegli **Collezioni**. 1. Scegli il nome della tua collezione per aprirne la pagina dei dettagli. 1. Scegli la scheda **Istantanee** per visualizzare le istantanee disponibili. 1. Scegli l'istantanea da cui desideri ripristinare, quindi scegli **Ripristina** da istantanea. 1. Nella finestra di dialogo **Ripristina da istantanea**: + Per il **nome dell'istantanea**, verifica l'ID dell'istantanea selezionato. + Per **Snapshot scope**, scegli una delle seguenti opzioni: + **Tutti gli indici della raccolta**: ripristina tutti gli indici dall'istantanea + **Indici specifici: seleziona i singoli indici** da ripristinare + Per **Destinazione**, scegli la raccolta in cui eseguire il ripristino. + (Facoltativo) Configura le **impostazioni di ridenominazione** per rinominare gli indici ripristinati: + **Non rinominare**: mantieni i nomi degli indici originali + **Aggiungi prefisso ai nomi degli indici ripristinati**: aggiungi un prefisso per evitare conflitti + **Rinomina utilizzando espressioni regolari**: utilizza modelli di ridenominazione avanzati + (Facoltativo) Configura le impostazioni di **notifica** per ricevere una notifica quando il ripristino viene completato o riscontra errori. 1. Scegli **Salva** per avviare l'operazione di ripristino. ------ #### [ OpenSearch API ] 1. Esegui il comando seguente per identificare l'istantanea appropriata. ``` GET /_snapshot/aoss-automated/_all ``` Per un elenco più piccolo di istantanee, esegui il comando seguente. ``` GET /_cat/snapshots/aoss-automated ``` 1. Esegui il comando seguente per verificare i dettagli dell'istantanea prima del ripristino. Nel comando, sostituisci il *example* contenuto con le tue informazioni specifiche. ``` GET _snapshot/aoss-automated/snapshot-ExampleSnapshotID1/ ``` 1. Esegui il comando seguente per ripristinare da un'istantanea specifica. ``` POST /_snapshot/aoss-automated/snapshot-ID/_restore ``` È possibile personalizzare l'operazione di ripristino includendo un corpo della richiesta. Ecco un esempio: ``` POST /_snapshot/aoss-automated/snapshot-ExampleSnapshotID1-5e01-4423-9833Example/_restore { "indices": "opensearch-dashboards*,my-index*", "ignore_unavailable": true, "include_global_state": false, "include_aliases": false, "rename_pattern": "opensearch-dashboards(.+)", "rename_replacement": "restored-opensearch-dashboards$1" } ``` 1. Esegui il comando seguente per visualizzare l'avanzamento del ripristino. ``` GET /_cat/recovery ``` ------ **Nota** Quando si ripristina un'istantanea con un comando che include un corpo della richiesta, è possibile utilizzare diversi parametri per controllare il comportamento di ripristino. Il `indices` parametro specifica quali indici ripristinare e supporta i pattern jolly. Impostato `ignore_unavailable` per continuare l'operazione di ripristino anche se manca un indice nell'istantanea. Utilizzato `include_global_state` per determinare se ripristinare lo stato del cluster e `include_aliases` per controllare se ripristinare gli alias associati. I `rename_replacement` parametri `rename_pattern` and rinominano gli indici durante l'operazione di ripristino.