Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# 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 de índice (ajustes y mapeos para sus índices), metadatos de clúster (plantillas de índice y alias) y datos de índice (todos los documentos y datos almacenados en sus índices).
OpenSearch Serverless ofrece copias de seguridad automáticas cada hora, sin configuración manual, sin gastos de mantenimiento ni costes de almacenamiento adicionales, con una recuperación rápida en caso de pérdida accidental de datos y la posibilidad de restaurar índices específicos a partir de una instantánea.
Antes de trabajar con instantáneas, comprenda estas importantes consideraciones. La creación de una instantánea tarda en completarse y no es instantánea. Los documentos nuevos o las actualizaciones que se realicen durante la creación de la instantánea no se incluirán en la instantánea. Solo puede restaurar instantáneas en su colección original y no en una nueva. Cuando se restauran, los índices reciben versiones nuevas UUIDs que difieren de sus versiones originales. La restauración a un índice abierto existente en OpenSearch Serverless sobrescribirá los datos de ese índice siempre que no se proporcione un nuevo nombre de índice o un patrón de prefijo. Esto difiere del comportamiento principal. OpenSearch Solo puede ejecutar una operación de restauración a la vez y no puede iniciar varias operaciones de restauración en la misma colección simultáneamente. 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 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](serverless-data-access.md#serverless-data-access-vs-iam).
****
| Política de acceso a los datos | APIs |
| --- | --- |
| Aoss: DescribeSnapshot | AUTOMATIZA /\_ cat/snapshots/aoss
OBTENGA \_/snapshot/aoss-automated/snapshot |
| aoss: RestoreSnapshot | POST /\_ /\_restore snapshot/aoss-automated/snapshot |
| aoss: DescribeCollectionItems | GET /\_cat/recovery |
Puede configurar las políticas mediante los siguientes AWS CLI comandos:
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)
Este es un ejemplo de comando CLI para crear una política de acceso. En el comando, sustituya el {{example}} contenido por su información específica.
```
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.}}"
}
]'
```
## Uso de instantáneas
De forma predeterminada, al crear una nueva colección, OpenSearch Serverless crea instantáneas automáticamente cada hora. No es necesario realizar ninguna acción. Cada instantánea incluye todos los índices de la colección. Una vez que OpenSearch Serverless haya creado las instantáneas, puede enumerarlas y revisar los detalles de la instantánea mediante los siguientes procedimientos.
### Enumere las instantáneas
Utilice los siguientes procedimientos para enumerar todas las instantáneas de una colección y revisar sus detalles.
------
#### [ Console ]
1. Abre la consola OpenSearch de Amazon Service en [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/).
1. En el panel de navegación izquierdo, selecciona **Serverless** y, a continuación, **Colecciones**.
1. Elige el nombre de tu colección para abrir su página de detalles.
1. Seleccione la pestaña **Instantáneas** para ver todas las instantáneas generadas.
1. Revise la información de las instantáneas, que incluye:
+ **ID de la instantánea**: identificador único de la instantánea
+ **Estado**: estado actual (disponible, en curso)
+ **Hora de creación: momento** en que se tomó la instantánea
------
#### [ OpenSearch API ]
+ 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 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
```
------
### Obtenga detalles de la instantánea
Utilice los siguientes procedimientos para recuperar información detallada sobre una instantánea específica.
------
#### [ Console ]
1. Abre la consola OpenSearch de Amazon Service en [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/).
1. En el panel de navegación izquierdo, selecciona **Serverless** y, a continuación, **Colecciones**.
1. Elige el nombre de tu colección para abrir su página de detalles.
1. Elija la pestaña **Snapshots (Instantáneas)**.
1. Elija el identificador del trabajo de la instantánea para mostrar información detallada sobre la instantánea, incluidos los metadatos, los índices incluidos y la información de temporización.
------
#### [ OpenSearch API ]
+ Utilice el siguiente comando para recuperar información sobre una instantánea. En el comando, sustituya el {{example}} contenido por su información específica.
```
GET _snapshot/aoss-automated/{{snapshot}}/
```
Solicitud de ejemplo:
```
GET _snapshot/aoss-automated/{{snapshot-ExampleSnapshotID1}}/
```
Respuesta de ejemplo:
```
{
"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 respuesta a la instantánea incluye varios campos clave: `id` proporciona un identificador único para la operación de instantánea, `status` devuelve el estado actual `SUCCESS` o `IN_PROGRESS` `duration` indica el tiempo necesario para completar la operación de instantánea y `indexes` devuelve 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 recupera 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. Antes de realizar la restauración, tenga en cuenta que los índices restaurados tendrán versiones diferentes UUIDs a las originales; la restauración a un índice abierto existente en OpenSearch Serverless sobrescribirá los datos de ese índice siempre que no se proporcione un nuevo nombre de índice o un patrón de prefijo; las instantáneas solo se pueden restaurar a su colección original (no se admite la restauración cruzada de colecciones); además, las operaciones de restauración afectarán al rendimiento del clúster, así que planifique en consecuencia.
Utilice los siguientes procedimientos para restaurar los índices respaldados a partir de una instantánea.
------
#### [ Console ]
1. Abre la consola OpenSearch de Amazon Service en [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/).
1. En el panel de navegación izquierdo, selecciona **Serverless** y, a continuación, **Colecciones**.
1. Elige el nombre de tu colección para abrir su página de detalles.
1. Selecciona la pestaña **Instantáneas** para ver las instantáneas disponibles.
1. Elija la instantánea desde la que desee realizar la restauración y, a continuación, seleccione **Restaurar a partir de** una instantánea.
1. En el cuadro de diálogo **Restaurar a partir de una instantánea**:
+ En el **nombre de la instantánea**, compruebe el ID de la instantánea seleccionada.
+ Para el **ámbito de la instantánea**, elija una de las siguientes opciones:
+ **Todos los índices de la colección**: restaure todos los índices de la instantánea
+ **Índices específicos: seleccione los índices** individuales que desee restaurar
+ En **Destination**, selecciona la colección en la que deseas realizar la restauración.
+ (Opcional) Configure los **ajustes de cambio de nombre** para cambiar el nombre de los índices restaurados:
+ **No cambie el nombre**: conserve los nombres de los índices originales
+ **Añadir un prefijo a los nombres de índice restaurados**: añada un prefijo para evitar conflictos
+ **Cambie el nombre mediante una expresión regular**: utilice patrones de cambio de nombre avanzados
+ (Opcional) Configure los ajustes de **notificación** para que se le notifique cuando la restauración se complete o detecte errores.
1. Seleccione **Guardar** para iniciar la operación de restauración.
------
#### [ OpenSearch API ]
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
```
1. Ejecute el siguiente comando para verificar los detalles de la instantánea antes de restaurar. En el comando, sustituya el {{example}} contenido por su información específica.
```
GET _snapshot/aoss-automated/{{snapshot-ExampleSnapshotID1}}/
```
1. 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-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. 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 varios parámetros para controlar el comportamiento de la restauración. El `indices` parámetro especifica qué índices se van a restaurar y admite patrones comodín. Configúrelo `ignore_unavailable` para continuar con la operación de restauración incluso si falta un índice en la instantánea. Se utiliza `include_global_state` para determinar si se debe restaurar el estado del clúster y `include_aliases` para controlar si se restauran los alias asociados. Los `rename_replacement` parámetros `rename_pattern` y cambian el nombre de los índices durante la operación de restauración.