Fazendo backup de coleções usando instantâneos

Snapshots são point-in-time backups de suas coleções Amazon OpenSearch Serverless que fornecem recursos de recuperação de desastres. OpenSearch O Serverless cria e gerencia automaticamente instantâneos de suas coleções, garantindo a continuidade dos negócios e a proteção dos dados. Cada instantâneo contém:

• Metadados do índice: configurações e mapeamentos para seus índices

• Metadados de cluster: modelos de índice e aliases

• Dados do índice: todos os documentos e dados armazenados em seus índices

Benefícios principais

• Backups automáticos de hora em hora, sem necessidade de configuração manual

• Sobrecarga de manutenção zero

• Sem custos adicionais de armazenamento

• Recuperação rápida da perda acidental de dados

• Capacidade de restaurar índices específicos a partir de um instantâneo

Considerações importantes

• A criação de um instantâneo não é instantânea e requer tempo para ser concluída.

• Novos documentos ou atualizações durante a criação do instantâneo podem não estar incluídos no instantâneo.

• Você pode restaurar os instantâneos somente para a coleção original e não para uma nova.

• Quando restaurados, os índices recebem novos UUIDs que diferem de suas versões originais.

• Você pode executar somente uma operação de restauração por vez.

• Você não pode iniciar várias operações de restauração na mesma coleção ao mesmo tempo. A tentativa de restaurar índices durante uma operação de restauração ativa faz com que a operação falhe.

• Durante uma operação de restauração, suas solicitações aos índices falham.

Permissões obrigatórias

Para trabalhar com instantâneos, configure as seguintes permissões em sua política de acesso a dados. Para obter mais informações sobre políticas de acesso a dados, consultePolíticas de acesso a dados versus políticas do IAM.

Política de acesso a dados	APIs
perda: DescribeSnapshot	OBTENHA /_cat/snapshots GET /_ -automatizado/ cat/snapshots/aoss OBTENHA snapshot _snapshot/aoss-automated//
perda: RestoreSnapshot	POST /_snapshot/aoss-automated/ /_restore snapshot
perda: DescribeCollectionItems	GET /_cat/recovery

Você pode configurar políticas usando os seguintes AWS CLI comandos:

1. create-access-policy

2. delete-access-policy

3. get-access-policy

4. update-access-policy

Aqui está um exemplo de comando da CLI para criar uma política de acesso:

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

Trabalhar com snapshots

Por padrão, quando você cria uma nova coleção, o OpenSearch Serverless cria automaticamente instantâneos a cada hora. Não é necessária nenhuma ação de sua parte. Cada instantâneo inclui todos os índices da coleção. Depois que o OpenSearch Serverless criar instantâneos, você poderá listá-los e visualizar os detalhes do instantâneo usando os comandos a seguir.

Listando instantâneos

Use o comando a seguir para listar todos os instantâneos em uma coleção:

GET /_cat/snapshots/aoss-automated/

OpenSearch O Serverless retorna uma resposta como a seguinte:

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

Obtenha instantâneos

Recupera informações sobre um snapshot.

GET _snapshot/aoss-automated/snapshot/

Exemplo de solicitação

GET _snapshot/aoss-automated/snapshot-AWSExampleSnapshotID1/

Exemplo de resposta

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

Entendendo os campos de resposta do snapshot

id

Um identificador exclusivo para a operação de captura instantânea.

status

O estado atual da operação de captura instantânea. Os possíveis valores incluem:

• SUCCESS

• IN_PROGRESS

duration

O tempo necessário para concluir a operação de captura de imagem.

índices

O número de índices incluídos no instantâneo.

Restauração a partir de um snapshot

A restauração a partir de um instantâneo permite recuperar dados de um backup feito anteriormente. Esse processo é crucial para a recuperação de desastres e o gerenciamento de dados no OpenSearch Serverless.

Considerações importantes

1. Os índices restaurados terão versões UUIDs diferentes das originais.

2. Os instantâneos só podem ser restaurados em sua coleção original. A restauração de coleções cruzadas não é suportada.

3. As operações de restauração podem afetar o desempenho do cluster. Planeje adequadamente.

Para restaurar incidências de backup a partir de um snapshot

1. Execute o comando a seguir para identificar o instantâneo apropriado.

   GET /_snapshot/aoss-automated/_all

   Para obter uma lista menor de instantâneos, execute o comando a seguir.

   GET /_cat/snapshots/aoss-automated/

2. Execute o comando a seguir para verificar os detalhes do instantâneo antes da restauração.

   GET _snapshot/aoss-automated/snapshot-AWSExampleSnapshotID1/

3. Execute o comando a seguir para restaurar a partir de um instantâneo específico.

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

   Você pode personalizar a operação de restauração incluindo um corpo de solicitação. Aqui está um exemplo.

   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. Execute o comando a seguir para ver o progresso da restauração.

   GET /_cat/recovery

nota

Ao restaurar um snapshot com um comando que inclui um corpo de solicitação, você pode usar os seguintes parâmetros para controlar o comportamento da restauração:

índices

Especifica quais índices devem ser restaurados. Esse parâmetro oferece suporte a padrões curinga.

ignore_indisponível

Permite que a operação de restauração continue mesmo se faltar um índice no snapshot.

incluir_estado_global

Determina se o estado do cluster deve ser restaurado.

include_aliases

Controla se os aliases associados devem ser restaurados.

rename_pattern e rename_replacement

Permite renomear índices durante a operação de restauração.