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 e alias di indice

• Dati indicizzati: tutti i documenti e i dati memorizzati negli indici

Principali vantaggi

• Backup orari automatici senza necessità di configurazione manuale

• Zero spese di manutenzione

• Nessun costo di archiviazione aggiuntivo

• Ripristino rapido in caso di perdita accidentale di dati

• Capacità di ripristinare indici specifici da un'istantanea

Considerazioni importanti

• La creazione di un'istantanea non è istantanea e richiede tempo per essere completata.

• Nuovi documenti o aggiornamenti durante la creazione di un'istantanea potrebbero non essere 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.

• È possibile eseguire una sola operazione di ripristino alla volta.

• Non è possibile avviare più operazioni di ripristino sulla stessa raccolta contemporaneamente. Il tentativo di ripristinare gli indici durante un'operazione di ripristino attiva causa il fallimento 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

Politica di accesso ai dati	APIs
aoss: DescribeSnapshot	OTTIENI /_cat/snapshots GET /_ -automated/ cat/snapshots/aoss OTTIENI snapshot _snapshot/aoss-automated//
aos: RestoreSnapshot	POST /_snapshot/aoss-automated/ /_restore snapshot
aos: DescribeCollectionItems	OTTIENI /_cat/recovery

È possibile configurare le politiche utilizzando i seguenti comandi: AWS CLI

1. create-access-policy

2. delete-access-policy

3. get-access-policy

4. update-access-policy

Ecco un esempio di comando CLI per creare una politica di accesso:

aws opensearchserverless create-access-policy \
--type data \
--name AWSExample-data-access-policy \
--region us-west-2 \
--policy '[
  {
    "Rules": [
      {
        "Resource": [
          "collection/AWSExample-collection"
        ],
        "Permission": [
          "aoss:DescribeSnapshot",
          "aoss:RestoreSnapshot",
          "aoss:DescribeCollectionItems"
        ],
        "ResourceType": "collection"
      }
    ],
    "Principal": [
      "arn:aws:iam::AWSExample-account-ID:user/AWSExample-user"
    ],
    "Description": "Data policy to support snapshot operations."
  }
]'

Utilizzo degli snapshot

Per impostazione predefinita, quando si crea una nuova raccolta, OpenSearch Serverless crea automaticamente istantanee ogni ora. Non è richiesta nessuna azione da parte tua. Ogni istantanea include tutti gli indici della raccolta. Dopo che OpenSearch Serverless ha creato le istantanee, è possibile elencarle e visualizzare i dettagli dell'istantanea utilizzando i seguenti comandi.

Elencare le istantanee

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    indices successful_shards failed_shards total_shards
snapshot-AWSExampleSnapshotID1     SUCCESS 1737964331  07:52:11   1737964382 07:53:02    50.4s       1                                             
snapshot-AWSExampleSnapshotID2     SUCCESS 1737967931  08:52:11   1737967979 08:52:59    47.7s       2                                             
snapshot-AWSExampleSnapshotID3     SUCCESS 1737971531  09:52:11   1737971581 09:53:01    49.1s       3                                             
snapshot-AWSExampleSnapshotID4 IN_PROGRESS 1737975131  10:52:11   -          -            4.8d       3

Ottieni istantanee

Recupera le informazioni su uno snapshot.

GET _snapshot/aoss-automated/snapshot/

Richiesta di esempio

GET _snapshot/aoss-automated/snapshot-AWSExampleSnapshotID1/

Risposta di esempio

{
    "snapshots": [
        {
            "snapshot": "snapshot-AWSExampleSnapshotID1-5e01-4423-9833Example",
            "uuid": "AWSExample-5e01-4423-9833-9e9eb757Example",
            "version_id": 136327827,
            "version": "2.11.0",
            "remote_store_index_shallow_copy": true,
            "indices": [
                "AWSExample-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
            }
        }
    ]
}

Comprensione dei campi di risposta delle istantanee

id

Un identificatore univoco per l'operazione di istantanea.

status

Lo stato corrente dell'operazione di istantanea. I valori possibili includono:

• SUCCESS

• IN_PROGRESS

durata

Il tempo impiegato per completare l'operazione di istantanea.

indici

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 OpenSearch Serverless.

Considerazioni importanti

1. Gli indici ripristinati avranno caratteristiche diverse UUIDs rispetto alle versioni originali.

2. Le istantanee possono essere ripristinate solo nella loro raccolta originale. Il ripristino tra raccolte incrociate non è supportato.

3. Le operazioni di ripristino possono influire sulle prestazioni del cluster. Pianifica le attività di conseguenza.

Per ripristinare gli incidenti di cui è stato eseguito il backup da un'istantanea

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/

2. Esegui il comando seguente per verificare i dettagli dell'istantanea prima del ripristino.

   GET _snapshot/aoss-automated/snapshot-AWSExampleSnapshotID1/

3. Esegui il comando seguente per eseguire il ripristino 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-AWSExampleSnapshotID1-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"
   }

4. 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 i seguenti parametri per controllare il comportamento di ripristino:

indici

Speciifica quali indici ripristinare. Questo parametro supporta i modelli con caratteri jolly.

ignore_available

Consente di continuare l'operazione di ripristino anche se manca un indice nell'istantanea.

include_global_state

Determina se ripristinare lo stato del cluster.

include_aliases

Controlla se ripristinare gli alias associati.

rename_pattern e rename_replacement

Consente di rinominare gli indici durante l'operazione di ripristino.