

Aviso de fim do suporte: em 20 de maio de 2026, AWS encerrará o suporte para AWS SimSpace Weaver. Depois de 20 de maio de 2026, você não poderá mais acessar o SimSpace Weaver console ou os SimSpace Weaver recursos. Para obter mais informações, consulte [AWS SimSpace Weaver Fim do suporte](https://docs.aws.amazon.com/simspaceweaver/latest/userguide/simspaceweaver-end-of-support.html). 

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

# Snapshots
<a name="working-with_snapshots"></a>

É possível criar um *snapshot* para fazer backup dos dados da entidade de simulação a qualquer momento. O SimSpace Weaver criará um arquivo .zip em um bucket do Amazon S3. Você pode criar uma nova simulação com o instantâneo. SimSpace Weaver inicializa o State Fabric de sua nova simulação com os dados da entidade armazenados no instantâneo, inicia os aplicativos espaciais e de serviços que estavam em execução quando o instantâneo foi criado e ajusta o relógio para a marca apropriada. SimSpace Weaver obtém a configuração da sua simulação a partir do instantâneo em vez de um arquivo de esquema. Os arquivos .zip do aplicativo devem estar no mesmo local no Amazon S3 em que estavam na simulação original. Você deve iniciar todos os aplicativos personalizados separadamente.

**Tópicos**
+ [Casos de uso para snapshots](#working-with_snapshots_use-cases)
+ [Use o SimSpace Weaver console para trabalhar com instantâneos](working-with_snapshots_console.md)
+ [Use o AWS CLI para trabalhar com instantâneos](working-with_snapshots_cli.md)
+ [Usando instantâneos com AWS CloudFormation](working-with_cloudformation_snapshots.md)
+ [Perguntas frequentes sobre snapshots](working-with_snapshots_faq.md)

## Casos de uso para snapshots
<a name="working-with_snapshots_use-cases"></a>

### Retornar a um estado anterior e explorar cenários de ramificação
<a name="working-with_snapshots_use-case_branching"></a>

É possível criar um snapshot da simulação para salvá-la em um estado específico. Em seguida, você pode criar várias novas simulações a partir desse snapshot e explorar diferentes cenários que podem se ramificar a partir desse estado.

### Práticas recomendadas de recuperação de desastres e segurança
<a name="working-with_snapshots_use-cases_best-practice"></a>

Recomendamos que você faça backup regular da simulação, especialmente para simulações que são executadas por mais de uma hora ou usam vários operadores. Os backups podem ajudar você a se recuperar de desastres e incidentes de segurança. Os snapshots fornecem uma maneira de você fazer backup da simulação. Os snapshots exigem que os arquivos .zip do aplicativo estejam no mesmo local no Amazon S3 de antes. Se você precisar mover os arquivos .zip do aplicativo para outro local, deverá usar uma solução de backup personalizada. 

Para obter mais informações sobre as melhores práticas, consulte [Melhores práticas ao trabalhar com SimSpace Weaver](best-practices.md) e [Melhores práticas de segurança para SimSpace Weaver](security_best-practices.md).

### Estender a duração da simulação
<a name="working-with_snapshots_use-cases_extend-duration"></a>

O *recurso de simulação* é a representação da simulação no SimSpace Weaver. Todos os recursos de simulação têm uma configuração de `MaximumDuration`. Um recurso de simulação é interrompido automaticamente quando atinge o `MaximumDuration`. O valor máximo de `MaximumDuration` é `14D` (14 dias). 

Se você precisar que sua simulação persista por mais tempo do que `MaximumDuration` do recurso de simulação, você pode criar um snapshot antes que o recurso de simulação alcance a `MaximumDuration`. É possível iniciar uma nova simulação (criar um novo recurso de simulação) com seu snapshot. O SimSpace Weaver inicializa os dados da entidade a partir do snapshot, inicia os mesmos aplicativos espaciais e de serviços executados antes e restaura o relógio. É possível iniciar aplicativos personalizados e realizar qualquer inicialização personalizada adicional. É possível definir a `MaximumDuration` do novo recurso de simulação com um valor diferente ao iniciá-lo.

# Use o SimSpace Weaver console para trabalhar com instantâneos
<a name="working-with_snapshots_console"></a>

Você pode usar o SimSpace Weaver console para criar um instantâneo da sua simulação.

**Topics**
+ [Criar um snapshot](#working-with_snapshots_console_create)
+ [Inicie uma simulação a partir de um snapshot](#working-with_snapshots_console_start)

## Usar o console para criar um snapshot
<a name="working-with_snapshots_console_create"></a>

**Para criar um snapshot**

1. Faça login no Console de gerenciamento da AWS e conecte-se ao [SimSpace Weaver console](https://console.aws.amazon.com/simspaceweaver).

1. No painel de navegação, escolha **Simulações**.

1. Selecione o botão de opção ao lado do nome da simulação. O **status** da simulação deve ser **Iniciado**. 

1. Na parte superior da página, escolha **Criar política**.

1. Em **Configurações do snapshot**, em **Destino do snapshot**, insira o URI do Amazon S3 de um bucket ou bucket e pasta onde você SimSpace Weaver deseja criar seu snapshot. É possível escolher **Procurar no S3** se preferir navegar pelos buckets disponíveis e selecionar um local.
**Importante**  
O bucket do Amazon S3 deve estar na mesma Região da AWS que a simulação.
**nota**  
SimSpace Weaver cria uma `snapshot` pasta dentro do destino do snapshot selecionado. SimSpace Weaver cria o arquivo.zip de instantâneo nessa `snapshot` pasta.

1. Escolha **Criar snapshot**.

## Usar o console para iniciar uma simulação a partir de um snapshot
<a name="working-with_snapshots_console_start"></a>

Para iniciar uma simulação a partir de um snapshot, seu arquivo .zip do snapshot deve existir em um bucket do Amazon S3 que sua simulação possa acessar. Sua simulação usa permissões definidas na função do aplicativo que você selecionar ao iniciar a simulação. Todos os arquivos .zip do aplicativo da simulação original devem existir nos mesmos locais de quando o snapshot foi criado.

**Como iniciar uma simulação a partir de um snapshot**

1. Faça login no Console de gerenciamento da AWS e conecte-se ao [SimSpace Weaver console](https://console.aws.amazon.com/simspaceweaver).

1. No painel de navegação, escolha **Simulações**.

1. Na parte superior da página, escolha **Iniciar simulação**.

1. Em **Configurações de simulação**, insira um nome e uma descrição opcional para sua simulação. O nome da simulação deve ser exclusivo na Conta da AWS.

1. Para o **Método de início da simulação**, escolha **Usar um snapshot no Amazon S3**.

1. Para o **URI do Amazon S3 para snapshot**, insira o URI do Amazon S3 do arquivo de snapshot ou escolha **Procurar no S3** para navegar e selecionar o arquivo.
**Importante**  
O bucket do Amazon S3 deve estar na mesma Região da AWS que a simulação.

1. Para o **Perfil do IAM**, selecione a função do aplicativo que sua simulação usará.

1. Em **Duração máxima**, insira o tempo máximo pelo qual seu recurso de simulação deve ser executado. O valor máximo é `14D`. Para mais informações sobre a duração máxima, consulte [.](https://docs.aws.amazon.com/simspaceweaver/latest/APIReference/API_StartSimulation.html)

1. Em **Tags: *opcional***, escolha **Adicionar nova tag** se quiser adicionar uma tag.

1. Escolha **Iniciar simulação**.

# Use o AWS CLI para trabalhar com instantâneos
<a name="working-with_snapshots_cli"></a>

Você pode usar o AWS CLI para chamar o a SimSpace Weaver APIs partir de um prompt de comando. Você deve ter o AWS CLI instalado e configurado corretamente. Para obter mais informações, consulte [Instalando ou atualizando a versão mais recente da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/getting-started-install.html) no *Guia do AWS Command Line Interface usuário da versão 2*.

**Topics**
+ [Criar um snapshot](#working-with_snapshots_cli_create)
+ [Inicie uma simulação a partir de um snapshot](#working-with_snapshots_cli_start)

## Use o AWS CLI para criar um instantâneo
<a name="working-with_snapshots_cli_create"></a>

**Para criar um snapshot**
+ Em um **prompt de comando**, chame a API `CreateSnapshot`.

  ```
  aws simspaceweaver create-snapshot --simulation simulation-name —destination s3-destination
  ```

  **Parâmetros**  
simulation  
O nome de uma simulação iniciada. É possível usar `aws simspaceweaver list-simulations` para ver os nomes e status das simulações.  
destination  
Uma string que especifica o bucket de destino do Amazon S3 e o prefixo de chave de objeto opcional para seu arquivo de snapshot. Seu prefixo de chave de objeto geralmente é uma pasta no seu bucket. SimSpace Weaver cria seu instantâneo dentro de uma `snapshot` pasta nesse destino.   
O bucket do Amazon S3 deve estar na mesma Região da AWS que a simulação.

  **Exemplo**

  ```
  aws simspaceweaver create-snapshot —simulation MyProjectSimulation_23-04-29_12_00_00 —destination BucketName=weaver-myproject-111122223333-artifacts-us-west-2,ObjectKeyPrefix=myFolder
  ```

Para obter mais informações sobre a `CreateSnapshot` API, consulte [CreateSnapshot](https://docs.aws.amazon.com/simspaceweaver/latest/APIReference/API_CreateSnapshot.html)a *Referência AWS SimSpace Weaver da API*.

## Use o AWS CLI para iniciar uma simulação a partir de um instantâneo
<a name="working-with_snapshots_cli_start"></a>

**Como iniciar uma simulação a partir de um snapshot**
+ Em um **prompt de comando**, chame a API `StartSimulation`.

  ```
  aws simspaceweaver start-simulation --name simulation-name --role-arn role-arn --snapshot-s3-location s3-location
  ```

  **Parâmetros**  
name  
Nome da nova simulação. O nome da simulação deve ser exclusivo em seu Conta da AWS. É possível usar `aws simspaceweaver list-simulations` para ver os nomes das simulações existentes.  
role-arn  
Nome do Recurso da Amazon (ARN) da função de aplicativo que sua simulação usará.  
snapshot-s3-location  
Uma string que especifica o bucket do Amazon S3 e a chave do objeto do arquivo de snapshot.  
O bucket do Amazon S3 deve estar na mesma Região da AWS que a simulação.

  **Exemplo**

  ```
  aws simspaceweaver start-simulation —name MySimulation —role-arn arn:aws:iam::111122223333:role/weaver-MyProject-app-role —snapshot-s3-location BucketName=weaver-myproject-111122223333-artifacts-us-west-2,ObjectKey=myFolder/snapshot/MyProjectSimulation_23-04-29_12_00_00-230429-1530-27.zip
  ```

Para obter mais informações sobre a `StartSimulation` API, consulte [StartSimulation](https://docs.aws.amazon.com/simspaceweaver/latest/APIReference/API_StartSimulation.html)a *Referência AWS SimSpace Weaver da API*.

# Perguntas frequentes sobre snapshots
<a name="working-with_snapshots_faq"></a>

**A simulação continua sendo executada durante um snapshot?**  
Os recursos de simulação continuam sendo executados durante um snapshot e você continua recebendo cobranças de faturamento por esse período. O tempo conta para a duração máxima da simulação. Seus aplicativos não recebem marcações enquanto o snapshot está em andamento. Se o status do relógio era `STARTED` quando a criação do snapshot começou, seu relógio ainda indicará o status `STARTED`. Os aplicativos recebem marcações novamente após o término do snapshot. Se o status do relógio era `STOPPED`, o status do relógio permanecerá `STOPPED`. Observe que uma simulação com um status `STARTED` está sendo executada mesmo que o status do relógio seja `STOPPED`.

**O que acontece se um snapshot estiver em andamento e a simulação atingir sua duração máxima?**  
A simulação finalizará o snapshot e será interrompida assim que o processo de captura do snapshot terminar (com ou sem sucesso). Recomendamos que você teste o processo de snapshot com antecedência para descobrir quanto tempo leva, o tamanho do arquivo de snapshot que você pode esperar e se ele será concluído com êxito.

**O que acontece se eu interromper uma simulação que tem um snapshot em andamento?**  
Um snapshot em andamento é interrompido imediatamente quando você interrompe a simulação. Ele não criará um arquivo de snapshot.

**Como posso interromper um snapshot em andamento?**  
A única maneira de interromper um snapshot em andamento é interromper a simulação. **Não é possível reiniciar a simulação depois que ela for interrompida.**

**Quanto tempo vai levar para concluir o snapshot?**  
O tempo necessário para criar um snapshot depende da simulação. Recomendamos que você teste o processo de captura instantânea com antecedência para descobrir quanto tempo levará para sua simulação.

**Qual será o tamanho do meu arquivo de snapshot?**  
O tamanho de um arquivo de snapshot depende da simulação. Recomendamos que você teste o processo de captura do snapshot com antecedência para descobrir o tamanho do arquivo para a simulação.