Sauvegarde de collections à l'aide de snapshots

Les snapshots sont point-in-time des sauvegardes de vos collections Amazon OpenSearch Serverless qui fournissent des fonctionnalités de reprise après sinistre. OpenSearch Serverless crée et gère automatiquement des instantanés de vos collections, garantissant ainsi la continuité des activités et la protection des données. Chaque instantané contient :

• Métadonnées d'index : paramètres et mappages pour vos index

• Métadonnées du cluster : modèles d'index et alias

• Données d'index : tous les documents et données stockés dans vos index

Principaux avantages

• Sauvegardes automatiques toutes les heures, aucune configuration manuelle requise

• Aucuns frais de maintenance

• Pas de frais de stockage supplémentaires

• Restauration rapide en cas de perte de données accidentelle

• Possibilité de restaurer des index spécifiques à partir d'un instantané

Considérations Importantes

• La création d'un instantané n'est pas instantanée et nécessite du temps.

• Les nouveaux documents ou les mises à jour pendant la création d'un instantané peuvent ne pas être inclus dans l'instantané.

• Vous pouvez restaurer les instantanés uniquement dans leur collection d'origine et non dans une nouvelle collection.

• Une fois restaurés, les index reçoivent de nouvelles UUIDs versions différentes de leurs versions d'origine.

• Vous ne pouvez exécuter qu'une seule opération de restauration à la fois.

• Vous ne pouvez pas démarrer plusieurs opérations de restauration sur la même collection en même temps. Toute tentative de restauration d'index pendant une opération de restauration active entraîne l'échec de l'opération.

• Lors d'une opération de restauration, vos demandes adressées aux index échouent.

Autorisations requises

Pour utiliser des instantanés, configurez les autorisations suivantes dans votre politique d'accès aux données. Pour plus d'informations sur les politiques d'accès aux données, consultezStratégies d'accès aux données ou politiques IAM.

Politique d'accès aux données	APIs
aoss : DescribeSnapshot	OBTENEZ /_cat/snapshots GET /_ -automatisé/ cat/snapshots/aoss GET snapshot _snapshot/aoss-automated//
aoss : RestoreSnapshot	POST /_snapshot/aoss-automated/ /_restore snapshot
aoss : DescribeCollectionItems	OBTENEZ /_cat/recovery

Vous pouvez configurer les politiques à l'aide des AWS CLI commandes suivantes :

1. create-access-policy

2. delete-access-policy

3. get-access-policy

4. update-access-policy

Voici un exemple de commande CLI pour créer une politique d'accès :

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."
  }
]'

Utilisation des instantanés

Par défaut, lorsque vous créez une nouvelle collection, OpenSearch Serverless crée automatiquement des instantanés toutes les heures. Aucune action de votre part n'est nécessaire. Chaque instantané inclut tous les indices de la collection. Une fois que OpenSearch Serverless a créé des instantanés, vous pouvez les répertorier et afficher les détails de l'instantané à l'aide des commandes suivantes.

Répertorier des instantanés

Utilisez la commande suivante pour répertorier tous les instantanés d'une collection :

GET /_cat/snapshots/aoss-automated/

OpenSearch Serverless renvoie une réponse semblable à la suivante :

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

Obtenez des instantanés

Extrait des informations sur un instantané.

GET _snapshot/aoss-automated/snapshot/

Exemple de requête

GET _snapshot/aoss-automated/snapshot-AWSExampleSnapshotID1/

Exemple de réponse

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

Comprendre les champs de réponse des instantanés

id

Identifiant unique pour l'opération de capture instantanée.

status

État actuel de l'opération de capture instantanée. Les valeurs possibles incluent :

• SUCCESS

• IN_PROGRESS

duration

Le temps nécessaire pour terminer l'opération de capture instantanée.

indices

Le nombre d'indices inclus dans l'instantané.

Restaurer à partir d'un instantané

La restauration à partir d'un instantané vous permet de récupérer les données d'une sauvegarde effectuée précédemment. Ce processus est crucial pour la reprise après sinistre et la gestion des données en mode OpenSearch Serverless.

Considérations Importantes

1. Les index restaurés seront différents UUIDs de leurs versions d'origine.

2. Les instantanés ne peuvent être restaurés que dans leur collection d'origine. La restauration de collections croisées n'est pas prise en charge.

3. Les opérations de restauration peuvent avoir un impact sur les performances du cluster. Planifiez en conséquence.

Pour restaurer des indices sauvegardés à partir d'un instantané

1. Exécutez la commande suivante pour identifier le snapshot approprié.

   GET /_snapshot/aoss-automated/_all

   Pour réduire la liste des instantanés, exécutez la commande suivante.

   GET /_cat/snapshots/aoss-automated/

2. Exécutez la commande suivante pour vérifier les détails du snapshot avant de le restaurer.

   GET _snapshot/aoss-automated/snapshot-AWSExampleSnapshotID1/

3. Exécutez la commande suivante pour effectuer une restauration à partir d'un instantané spécifique.

   POST /_snapshot/aoss-automated/snapshot-ID/_restore

   Vous pouvez personnaliser l'opération de restauration en incluant un corps de demande. Voici un exemple :

   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. Exécutez la commande suivante pour voir la progression de la restauration.

   GET /_cat/recovery

Note

Lorsque vous restaurez un instantané à l'aide d'une commande incluant un corps de requête, vous pouvez utiliser les paramètres suivants pour contrôler le comportement de restauration :

indices

Spécifie les indices à restaurer. Ce paramètre prend en charge les modèles de caractères génériques.

ignorer_indisponible

Permet à l'opération de restauration de se poursuivre même s'il manque un index dans le cliché.

include_global_state

Détermine s'il faut restaurer l'état du cluster.

include_alias

Contrôle s'il faut restaurer les alias associés.

rename_pattern et rename_replacement

Permet de renommer les index lors de l'opération de restauration.