Hacer copias de seguridad de las colecciones mediante instantáneas

Las instantáneas son point-in-time copias de seguridad de sus colecciones de Amazon OpenSearch Serverless que proporcionan funciones de recuperación ante desastres. OpenSearch Serverless crea y administra automáticamente las instantáneas de sus colecciones, lo que garantiza la continuidad empresarial y la protección de los datos. Cada instantánea contiene:

• Metadatos del índice: ajustes y mapeos de sus índices

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

• Datos de í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

• Sin gastos de mantenimiento

• Sin costes 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

• La creación de una instantánea no es instantánea y requiere tiempo para completarla.

• Es posible que los documentos nuevos o las actualizaciones durante la creación de la instantánea no se incluyan en la instantánea.

• Puede restaurar las instantáneas solo a su colección original y no a una nueva.

• Cuando se restauran, los índices reciben versiones nuevas UUIDs 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. Si se intenta restaurar los índices durante una operación de restauración activa, se produce un error en la operación.

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

Permisos necesarios

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

Política de acceso a datos	APIs
aoss: DescribeSnapshot	OBTENGA /_cat/snapshots GET /_ -automated/ cat/snapshots/aoss OBTENGA snapshot _snapshot/aoss-automated//
aoss: RestoreSnapshot	POST /_snapshot/aoss-automated/ /_restore snapshot
aoss: DescribeCollectionItems	OBTENGA /_cat/recovery

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

1. create-access-policy

2. delete-access-policy

3. get-access-policy

4. update-access-policy

Este es un ejemplo de comando 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 forma predeterminada, al crear una nueva colección, OpenSearch Serverless crea instantáneas automáticamente cada hora. No tiene que hacer nada. Cada instantánea incluye todos los índices de la colección. Una vez que OpenSearch Serverless haya creado las instantáneas, puede enumerarlas y ver los detalles de la instantánea mediante los siguientes comandos.

Listar las instantáneas

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

GET /_cat/snapshots/aoss-automated/

OpenSearch Serverless devuelve una respuesta como 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

Obtenga 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
            }
        }
    ]
}

Descripción de los campos de respuesta a las instantáneas

id

Un identificador único para la operación de captura de imágenes.

status

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

• SUCCESS

• IN_PROGRESS

duración

El tiempo que se tarda en completar la operación de captura de pantalla.

índices

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

Consideraciones importantes

1. Los índices restaurados tendrán versiones UUIDs diferentes a las 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 más pequeña de instantáneas, ejecute el siguiente comando.

   GET /_cat/snapshots/aoss-automated/

2. Ejecute el siguiente comando para comprobar los detalles de la instantánea antes de restaurarla.

   GET _snapshot/aoss-automated/snapshot-AWSExampleSnapshotID1/

3. Ejecute el siguiente comando para restaurar desde 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:

índices

Especifica los índices que 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

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