Restauration des instantanés - Amazon OpenSearch Service

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.

Restauration des instantanés

Avant de restaurer un instantané, assurez-vous que le domaine de destination n'utilise pas le mode Multi-AZ avec mode veille. L'activation du mode veille entraîne l'échec de l'opération de restauration.

Avertissement

Si vous utilisez des alias d'index, vous devez soit cesser d'écrire des demandes à un alias, soit passer de l'alias à un autre index avant de supprimer son index. L'arrêt des demandes d'écriture contribue à éviter le scénario suivant :

  1. Vous supprimez un index, ce qui supprime également son alias.

  2. Une demande d'écriture errante à l'alias maintenant supprimé crée un nouvel index avec le même nom que celui de l'alias.

  3. Vous ne pouvez plus utiliser l'alias en raison d'un conflit de noms avec le nouvel index. Si vous avez basculé l'alias vers un autre index, spécifiez "include_aliases": false lorsque vous restaurez à partir d'un instantané.

Pour restaurer un instantané

  1. Identifiez l'instantané que vous voulez restaurer. Assurez-vous que tous les paramètres de cet index, tels que les packages d'analyseurs personnalisés ou les paramètres d'exigences d'allocation, sont compatibles avec le domaine. Pour afficher tous les référentiels d'instantanés, exécutez la commande suivante :

    curl -XGET 'domain-endpoint/_snapshot?pretty'

    Une fois le référentiel identifié, exécutez la commande suivante pour afficher tous les instantanés :

    curl -XGET 'domain-endpoint/_snapshot/repository-name/_all?pretty'
    Note

    La plupart des instantanés automatiques sont stockés dans le référentiel cs-automated. Si votre domaine chiffre les données au repos, elles sont stockées dans le référentiel cs-automated-enc. Si vous ne voyez pas le référentiel d'instantanés manuels que vous recherchez, vérifiez que vous l'avez enregistré dans le domaine.

  2. (Facultatif) Supprimez ou renommez un ou plusieurs index du domaine de OpenSearch service en cas de conflit de dénomination entre les index du cluster et ceux du cliché. Vous ne pouvez pas restaurer un instantané de vos index sur un OpenSearch cluster qui contient déjà des index portant le même nom.

    En cas de conflits de noms d'index, les options suivantes s'offrent à vous :

    • Supprimez les index du domaine de OpenSearch service existant, puis restaurez le snapshot.

    • Renommez les index à mesure que vous les restaurez à partir de l'instantané, puis réindexez-les ultérieurement. Pour savoir comment renommer des index, consultez cet exemple de demande dans la OpenSearch documentation.

    • Restaurez le snapshot dans un autre domaine OpenSearch de service (uniquement possible avec les snapshots manuels).

    La commande suivante supprime tous les index existants d'un domaine :

    curl -XDELETE 'domain-endpoint/_all'

    Cependant, si vous ne prévoyez pas de restaurer tous les index, vous pouvez simplement en supprimer un :

    curl -XDELETE 'domain-endpoint/index-name'

  3. Pour restaurer un instantané, exécutez la commande suivante :

    curl -XPOST 'domain-endpoint/_snapshot/repository-name/snapshot-name/_restore'

    En raison d'autorisations spéciales sur les OpenSearch tableaux de bord et d'index de contrôle d'accès précis, les tentatives de restauration de tous les index peuvent échouer, en particulier si vous essayez de restaurer à partir d'un instantané automatique. L'exemple suivant restaure un seul index, my-index, depuis 2020-snapshot vers le référentiel d'instantanés cs-automated :

    curl -XPOST 'domain-endpoint/_snapshot/cs-automated/2020-snapshot/_restore' \
-d '{"indices": "my-index"}' \
-H 'Content-Type: application/json'

    Vous pouvez également restaurer tous les index à l'exception des index Dashboards et des index de contrôle précis des accès :

    curl -XPOST 'domain-endpoint/_snapshot/cs-automated/2020-snapshot/_restore' \
-d '{"indices": "-.kibana*,-.opendistro*"}' \
-H 'Content-Type: application/json'

    Vous pouvez restaurer un instantané sans supprimer ses données à l'aide des rename_replacement paramètres rename_pattern et. Pour plus d'informations sur ces paramètres, consultez les champs de API demande Restore Snapshot et l'exemple de demande dans la OpenSearch documentation.

Note

Si seule une partie des partitions primaires était disponible pour les index impliqués, un instantané peut avoir l'state PARTIAL. Cette valeur indique que les données d'au moins une partition n'ont pas été stockées avec succès. Vous pouvez toujours effectuer une restauration à partir d'un instantané partiel, mais vous aurez probablement besoin d'anciens instantanés pour restaurer les index manquants.