Hacer copias de seguridad de las colecciones mediante instantáneas - Amazon OpenSearch Service
Permisos necesariosUso de instantáneasRestauración a partir de una instantánea

Hacer copias de seguridad de las colecciones mediante instantáneas

Las instantáneas son una copias de seguridad puntuales de sus colecciones sin Amazon OpenSearch sin servidor que ofrecen funciones de recuperación ante desastres. OpenSearch sin servidor crea y administra automáticamente instantáneas de sus colecciones, a fin de garantizar la continuidad empresarial y la protección de los datos. Cada instantánea contiene:

  • Metadatos del índice: Configuración y asignaciones de sus índices.

  • Metadatos del clúster: Plantillas de índice y alias.

  • Datos del índice: Todos los documentos y datos almacenados en sus índices.

Ventajas principales

  • Copias de seguridad automáticas cada hora sin necesidad de configuración manual

  • Gastos generales de mantenimiento cero

  • Sin costos de almacenamiento adicionales

  • Recuperación rápida en caso de pérdida accidental de datos

  • Posibilidad de restaurar índices específicos a partir de una instantánea

Consideraciones importantes

  • Crear una instantánea no es instantáneo y requiere tiempo para completarse.

  • Los documentos nuevos o las actualizaciones que se produzcan durante la creación de la instantánea podrían no incluirse en la instantánea.

  • Solo puede restaurar instantáneas en su colección original y no en una nueva.

  • Al restaurarse, los índices reciben nuevos UUID que difieren de sus versiones originales.

  • Solo puede ejecutar una operación de restauración a la vez.

  • No puede iniciar varias operaciones de restauración en la misma colección al mismo tiempo. Intentar restaurar índices durante una operación de restauración activa hace que la operación falle.

  • Durante una operación de restauración, sus solicitudes a los índices fallan.

Permisos necesarios

Para trabajar con instantáneas, configure los siguientes permisos en su política de acceso a datos. Para obtener más información acerca de las políticas de acceso a datos, consulte Políticas de acceso a datos frente a políticas de IAM.

Política de acceso a los datos API
aoss:DescribeSnapshot

GET /_cat/snapshots

GET /_cat/snapshots/aoss-automated/

GET _snapshot/aoss-automated/snapshot/
aoss:RestoreSnapshot POST /_snapshot/aoss-automated/snapshot/_restore
aoss:DescribeCollectionItems GET /_cat/recovery

Puede configurar las políticas usando los siguientes comandos de AWS CLI:

  1. create-access-policy

  2. delete-access-policy

  3. get-access-policy

  4. update-access-policy

A continuación, se muestra un ejemplo de un comando de la CLI para crear una política de acceso:

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

Uso de instantáneas

De manera predeterminada, cuando usted crea una nueva colección, OpenSearch sin servidor crea instantáneas automáticamente cada hora. No tiene que hacer nada. Cada instantánea incluye todos los índices de la colección. Después de que OpenSearch sin servidor crea las instantáneas, usted puede enumerarlas y ver los detalles de cada instantánea mediante los siguientes comandos.

Enumerar instantáneas

Utilice el siguiente comando para enumerar todas las instantáneas de una colección.

GET /_cat/snapshots/aoss-automated/

OpenSearch sin servidor devuelve una respuesta similar a la siguiente:


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

Obtener instantáneas

Obtiene información sobre una instantánea.

GET _snapshot/aoss-automated/snapshot/

Solicitud de ejemplo

GET _snapshot/aoss-automated/snapshot-AWSExampleSnapshotID1/

Respuesta de ejemplo

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

Comprensión de los campos de la respuesta de una instantánea

id

Un identificador único de la operación de la instantánea.

status

El estado actual de la operación de instantáneas. Los valores posibles son:

  • SUCCESS

  • IN_PROGRESS

duración

El tiempo que lleva completar la operación de instantáneas.

indices

El número de índices incluidos en la instantánea.

Restauración a partir de una instantánea

La restauración a partir de una instantánea permite recuperar los datos de una copia de seguridad realizada anteriormente. Este proceso es crucial para la recuperación ante desastres y la administración de datos en OpenSearch sin servidor.

Consideraciones importantes

  1. Los índices restaurados tendrán UUID diferentes a los de sus versiones originales.

  2. Las instantáneas solo se pueden restaurar a su colección original. No se admite la restauración entre colecciones.

  3. Las operaciones de restauración pueden afectar al rendimiento del clúster. Planifíquelo en consecuencia.

Para restaurar los incidentes respaldados a partir de una instantánea

  1. Ejecute el siguiente comando para identificar la instantánea adecuada.

    GET /_snapshot/aoss-automated/_all

    Para obtener una lista de instantáneas más pequeña, ejecute el siguiente comando.

    GET /_cat/snapshots/aoss-automated/

  2. Ejecute el siguiente comando para verificar los detalles de la instantánea antes de restaurar.

    GET _snapshot/aoss-automated/snapshot-AWSExampleSnapshotID1/

  3. Ejecute el siguiente comando para restaurar a partir de una instantánea específica.

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

    Puede personalizar la operación de restauración incluyendo el cuerpo de la solicitud. A continuación se muestra un ejemplo.

    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. Ejecute el siguiente comando para ver el progreso de la restauración.

    GET /_cat/recovery
nota

Al restaurar una instantánea con un comando que incluye el cuerpo de la solicitud, puede usar los siguientes parámetros para controlar el comportamiento de la restauración:

indices

Especifica qué índices se van a restaurar. Este parámetro admite patrones comodín.

ignore_unavailable

Permite que la operación de restauración continúe incluso si falta un índice en la instantánea.

include_global_state

Determina si se debe restaurar el estado del clúster.

include_aliases

Controla si se restauran los alias asociados.

rename_pattern y rename_replacement

Le permite cambiar el nombre de los índices durante la operación de restauración.