Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra. # 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 des métadonnées d'index (paramètres et mappages pour vos index), des métadonnées de cluster (modèles d'index et alias) et des données d'index (tous les documents et données stockés dans vos index). OpenSearch Serverless fournit des sauvegardes automatiques toutes les heures sans configuration manuelle, sans frais de maintenance, sans frais de stockage supplémentaires, avec une restauration rapide en cas de perte de données accidentelle et la possibilité de restaurer des index spécifiques à partir d'un instantané. Avant de travailler avec des instantanés, prenez connaissance de ces considérations importantes. La création d'un instantané prend du temps et n'est pas instantanée. Les nouveaux documents ou les mises à jour lors de la création d'un instantané ne seront pas 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. La restauration d'un index ouvert existant dans OpenSearch Serverless remplacera les données de cet index à condition qu'aucun nouveau nom d'index ou modèle de préfixe ne soit fourni. Cela diffère du comportement de base. OpenSearch Vous ne pouvez exécuter qu'une seule opération de restauration à la fois, et vous ne pouvez pas démarrer plusieurs opérations de restauration simultanément sur la même collection. Toute tentative de restauration d'index pendant une opération de restauration active entraîne l'échec de l'opération. Au cours 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, consultez[Stratégies d'accès aux données ou politiques IAM](serverless-data-access.md#serverless-data-access-vs-iam). **** | Politique d'accès aux données | APIs | | --- | --- | | aoss : DescribeSnapshot | GET /\_ -automatisé cat/snapshots/aoss
OBTENEZ \_snapshot/aoss-automated/snapshot/ | | aoss : RestoreSnapshot | POST /\_ /\_restore snapshot/aoss-automated/snapshot | | aoss : DescribeCollectionItems | OBTENEZ /\_cat/recovery | Vous pouvez configurer les politiques à l'aide des AWS CLI commandes suivantes : 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) Voici un exemple de commande CLI pour créer une politique d'accès. Dans la commande, remplacez le {{example}} contenu par vos informations spécifiques. ``` 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.}}" } ]' ``` ## 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 requise. Chaque instantané inclut tous les index de la collection. Une fois que OpenSearch Serverless a créé des instantanés, vous pouvez les répertorier et consulter les détails de l'instantané à l'aide des procédures suivantes. ### Répertorier les instantanés Utilisez les procédures suivantes pour répertorier tous les instantanés d'une collection et vérifier leurs détails. ------ #### [ Console ] 1. Ouvrez la console Amazon OpenSearch Service à l'adresse [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/). 1. Dans le volet de navigation de gauche, choisissez **Serverless**, puis **Collections**. 1. Choisissez le nom de votre collection pour ouvrir sa page de détails. 1. Choisissez l'onglet **Instantanés** pour afficher tous les instantanés générés. 1. Passez en revue les informations de l'instantané, notamment : + **ID de capture d'écran** : identifiant unique pour l'instantané + **État** - État actuel (disponible, en cours) + **Heure de création** : date à laquelle le cliché a été pris ------ #### [ OpenSearch API ] + 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 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 ``` ------ ### Obtenir des informations sur les instantanés Utilisez les procédures suivantes pour récupérer des informations détaillées sur un instantané spécifique. ------ #### [ Console ] 1. Ouvrez la console Amazon OpenSearch Service à l'adresse [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/). 1. Dans le volet de navigation de gauche, choisissez **Serverless**, puis **Collections**. 1. Choisissez le nom de votre collection pour ouvrir sa page de détails. 1. Choisissez l'onglet **Instantanés**. 1. Choisissez l'ID de la tâche de capture instantanée pour afficher des informations détaillées sur la capture instantanée, notamment les métadonnées, les index inclus et les informations temporelles. ------ #### [ OpenSearch API ] + Utilisez la commande suivante pour récupérer les informations relatives à un instantané. Dans la commande, remplacez le {{example}} contenu par vos informations spécifiques. ``` GET _snapshot/aoss-automated/{{snapshot}}/ ``` Exemple de demande : ``` GET _snapshot/aoss-automated/{{snapshot-ExampleSnapshotID1}}/ ``` Exemple de réponse : ``` { "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 réponse instantanée inclut plusieurs champs clés : `id` fournit un identifiant unique pour l'opération de capture instantanée, `status` renvoie l'état actuel `SUCCESS` ou `IN_PROGRESS` `duration` indique le temps nécessaire pour terminer l'opération de capture instantanée et `indexes` renvoie le nombre d'index inclus dans l'instantané. ## Restaurer à partir d’un instantané La restauration à partir d'un instantané 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. Avant la restauration, sachez que les index restaurés seront différents de leurs versions d'origine, UUIDs que la restauration d'un index ouvert existant dans OpenSearch Serverless remplacera les données de cet index à condition qu'un nouveau nom d'index ou qu'aucun modèle de préfixe ne soit fourni, que les instantanés ne peuvent être restaurés que dans leur collection d'origine (la restauration entre collections n'est pas prise en charge) et que les opérations de restauration auront un impact sur les performances du cluster. Planifiez en conséquence. Utilisez les procédures suivantes pour restaurer des index sauvegardés à partir d'un instantané. ------ #### [ Console ] 1. Ouvrez la console Amazon OpenSearch Service à l'adresse [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/). 1. Dans le volet de navigation de gauche, choisissez **Serverless**, puis **Collections**. 1. Choisissez le nom de votre collection pour ouvrir sa page de détails. 1. Choisissez l'onglet **Instantanés** pour afficher les instantanés disponibles. 1. Choisissez l'instantané à partir duquel vous souhaitez effectuer la restauration, puis choisissez **Restaurer à partir d'un instantané**. 1. Dans la boîte de dialogue **Restaurer à partir d'un instantané** : + Pour le **nom du snapshot**, vérifiez l'ID du snapshot sélectionné. + Pour **Snapshot Scope**, choisissez l'une des options suivantes : + **Tous les index de la collection** - Restaurez tous les index à partir de l'instantané + **Index spécifiques : sélectionnez les** index individuels à restaurer + Pour **Destination**, choisissez la collection vers laquelle vous souhaitez effectuer la restauration. + (Facultatif) Configurez les **paramètres de renommage** pour renommer les index restaurés : + **Ne pas renommer** : conserver les noms d'index d'origine + **Ajouter un préfixe aux noms d'index restaurés** - Ajoutez un préfixe pour éviter les conflits + **Renommer à l'aide d'une expression régulière** - Utiliser des modèles de renommage avancés + (Facultatif) Configurez les paramètres de **notification** pour être averti lorsque la restauration est terminée ou qu'elle rencontre des erreurs. 1. Choisissez **Enregistrer** pour démarrer l'opération de restauration. ------ #### [ OpenSearch API ] 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 ``` 1. Exécutez la commande suivante pour vérifier les détails du snapshot avant de le restaurer. Dans la commande, remplacez le {{example}} contenu par vos informations spécifiques. ``` GET _snapshot/aoss-automated/{{snapshot-ExampleSnapshotID1}}/ ``` 1. 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-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. 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 plusieurs paramètres pour contrôler le comportement de restauration. Le `indices` paramètre indique les indices à restaurer et prend en charge les modèles de caractères génériques. Configurez `ignore_unavailable` pour poursuivre l'opération de restauration même s'il manque un index dans le cliché. `include_global_state`À utiliser pour déterminer s'il faut restaurer l'état du cluster et `include_aliases` pour contrôler s'il faut restaurer les alias associés. Les `rename_replacement` paramètres `rename_pattern` et renomment les index lors de l'opération de restauration.