As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá. # Fazer backup de coleções usando snapshots 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 snapshot contém metadados de índice (configurações e mapeamentos para seus índices), metadados de cluster (modelos de índice e aliases) e dados de índice (todos os documentos e dados armazenados em seus índices). OpenSearch O Serverless fornece backups automáticos de hora em hora, sem configuração manual, sem sobrecarga de manutenção, sem custos adicionais de armazenamento, recuperação rápida da perda acidental de dados e a capacidade de restaurar índices específicos a partir de um instantâneo. Antes de trabalhar com instantâneos, entenda essas considerações importantes. A criação de um instantâneo leva tempo para ser concluída e não é instantânea. Novos documentos ou atualizações durante a criação do instantâneo não serão incluídos no instantâneo. Você só pode restaurar os snapshots para a sua coleção original, não para uma nova coleção. Quando restaurados, os índices recebem novos UUIDs que diferem de suas versões originais. A restauração de um índice aberto existente no OpenSearch Serverless substituirá os dados desse índice, desde que um novo nome de índice ou um padrão de prefixo não seja fornecido. Isso difere do comportamento principal. OpenSearch Você pode executar somente uma operação de restauração por vez e não pode iniciar várias operações de restauração na mesma coleção simultaneamente. 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 snapshots, configure as seguintes permissões em sua política de acesso a dados. Para saber mais sobre políticas de acesso a dados, consulte [Políticas de acesso a dados versus políticas do IAM](serverless-data-access.md#serverless-data-access-vs-iam). **** | Política de acesso a dados | APIs | | --- | --- | | perda: DescribeSnapshot | GET /\$1 cat/snapshots/aoss -automatizadoOBTENHA \$1snapshot/aoss-automated/snapshot/ | | perda: RestoreSnapshot | POST /\$1 /\$1restaurar snapshot/aoss-automated/snapshot | | perda: DescribeCollectionItems | GET /\$1cat/recovery | Você pode configurar políticas usando os seguintes 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) Aqui está um exemplo de comando da CLI para criar uma política de acesso. No comando, substitua o *example* conteúdo por suas informações específicas. ``` 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." } ]' ``` ## Trabalhar com snapshots Por padrão, quando você cria uma nova coleção, o OpenSearch Serverless cria automaticamente instantâneos a cada hora. Medida a ser tomada Cada instantâneo inclui todos os índices da coleção. Depois que o OpenSearch Serverless criar instantâneos, você poderá listá-los e revisar os detalhes do instantâneo usando os procedimentos a seguir. ### Listar instantâneos Use os procedimentos a seguir para listar todos os instantâneos em uma coleção e revisar seus detalhes. ------ #### [ Console ] 1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/). 1. **No painel de navegação esquerdo, escolha **Sem servidor** e, em seguida, selecione Coleções.** 1. Escolha o nome da sua coleção para abrir a página de detalhes. 1. Escolha a guia **Instantâneos** para exibir todos os instantâneos gerados. 1. Analise as informações do snapshot, incluindo: + **ID do instantâneo** - identificador exclusivo do instantâneo + **Status** - Estado atual (disponível, em andamento) + **Hora de criação** - Quando o instantâneo foi tirado ------ #### [ AWS CLI ] + 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 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 ``` ------ ### Obtenha detalhes do instantâneo Use os procedimentos a seguir para recuperar informações detalhadas sobre um instantâneo específico. ------ #### [ Console ] 1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/). 1. **No painel de navegação esquerdo, escolha **Sem servidor** e, em seguida, selecione Coleções.** 1. Escolha o nome da sua coleção para abrir a página de detalhes. 1. Escolha a guia **Snapshots**. 1. Escolha o ID do trabalho de snapshot para exibir informações detalhadas sobre o snapshot, incluindo metadados, índices incluídos e informações de tempo. ------ #### [ AWS CLI ] + Use o comando a seguir para recuperar informações sobre um instantâneo. No comando, substitua o *example* conteúdo por suas informações específicas. ``` GET _snapshot/aoss-automated/snapshot/ ``` Exemplo de solicitação: ``` GET _snapshot/aoss-automated/snapshot-ExampleSnapshotID1/ ``` Exemplo de resposta: ``` { "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 } } ] } ``` ------ A resposta do instantâneo inclui vários campos principais: `id` fornece um identificador exclusivo para a operação do instantâneo, `status` retorna o estado atual `SUCCESS` ou `IN_PROGRESS` `duration` indica o tempo gasto para concluir a operação do instantâneo e `indexes` retorna 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 recupera dados de um backup feito anteriormente. Esse processo é crucial para recuperação de desastres e gerenciamento de dados no OpenSearch Serverless. Antes de restaurar, entenda que os índices restaurados serão diferentes UUIDs de suas versões originais. A restauração em um índice aberto existente no OpenSearch Serverless substituirá os dados desse índice, desde que um novo nome de índice ou um padrão de prefixo não seja fornecido, os instantâneos só poderão ser restaurados em sua coleção original (a restauração entre coleções não é suportada) e as operações de restauração afetarão o desempenho do cluster, portanto, planeje adequadamente. Use os procedimentos a seguir para restaurar índices de backup a partir de um snapshot. ------ #### [ Console ] 1. Abra o console do Amazon OpenSearch Service em [https://console.aws.amazon.com/aos/](https://console.aws.amazon.com/aos/). 1. **No painel de navegação esquerdo, escolha **Sem servidor** e, em seguida, selecione Coleções.** 1. Escolha o nome da sua coleção para abrir a página de detalhes. 1. Escolha a guia **Instantâneos** para exibir os instantâneos disponíveis. 1. Escolha o instantâneo do qual você deseja restaurar e, em seguida, escolha **Restaurar do instantâneo**. 1. Na caixa de diálogo **Restaurar a partir do instantâneo**: + Em **Nome do instantâneo**, verifique o ID do instantâneo selecionado. + Para **Escopo do Snapshot**, escolha uma das seguintes opções: + **Todos os índices na coleção** - Restaure todos os índices do instantâneo + **Índices específicos** - Selecione índices individuais para restaurar + Em **Destino**, escolha a coleção para a qual restaurar. + (Opcional) Defina as **configurações de renomeação** para renomear os índices restaurados: + **Não renomeie** - mantenha os nomes dos índices originais + **Adicionar prefixo aos nomes de índices restaurados** - Adicione um prefixo para evitar conflitos + **Renomear usando expressão regular** - Use padrões avançados de renomeação + (Opcional) Defina as configurações de **notificação** para ser notificado quando a restauração for concluída ou encontrar erros. 1. Escolha **Salvar** para iniciar a operação de restauração. ------ #### [ OpenSearch API ] 1. Execute o comando a seguir para identificar o snapshot apropriado. ``` GET /_snapshot/aoss-automated/_all ``` Para obter uma lista menor de snapshots, execute o comando a seguir. ``` GET /_cat/snapshots/aoss-automated ``` 1. Execute o comando a seguir para verificar os detalhes do snapshot antes de restaurar. No comando, substitua o *example* conteúdo por suas informações específicas. ``` GET _snapshot/aoss-automated/snapshot-ExampleSnapshotID1/ ``` 1. Execute o comando a seguir para restaurar a partir de um snapshot 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-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. Execute o seguinte comando para visualizar o progresso da restauração. ``` GET /_cat/recovery ``` ------ **nota** Ao restaurar um instantâneo com um comando que inclui um corpo de solicitação, você pode usar vários parâmetros para controlar o comportamento da restauração. O `indices` parâmetro especifica quais índices devem ser restaurados e oferece suporte a padrões curinga. `ignore_unavailable`Defina para continuar a operação de restauração mesmo que um índice no snapshot esteja ausente. Use `include_global_state` para determinar se o estado do cluster deve ser restaurado e `include_aliases` para controlar se os aliases associados devem ser restaurados. Os `rename_replacement` parâmetros `rename_pattern` e renomeiam os índices durante a operação de restauração.