> For the complete documentation index, see [llms.txt](https://docs.flosum.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flosum.com/sandbox-management/sandbox-management-us-english-pt-br/sandboxes/atualizando-um-sandbox.md).
# Atualizando um Sandbox
##  Visão geral
Este artigo explica como atualizar uma sandbox no Sandbox Management e reconectá-la ao seu tenant. Atualizar uma sandbox a substitui por uma nova cópia da organização de origem, para que você possa começar novamente a partir do estado atual da produção.
Você pode atualizar uma sandbox com ou sem um template, e o processo é o mesmo de qualquer forma. Um template apenas adiciona suas etapas, que são executadas depois que você reconecta a sandbox. Este artigo usa um template com os **Migração de Dados** e **Conectar à Topologia Flosum** etapas ativadas.
Sandbox Management usa o processo padrão de atualização do Salesforce. O Salesforce cria a sandbox atualizada como uma nova org do Salesforce com um novo Org ID, então você a reconecta ao seu tenant novamente após a atualização. A sandbox mantém sua organização em Global Settings, e então as etapas do template são executadas, se você selecionou um template.
{% hint style="info" %}
#### Antes de começar
A sandbox deve estar no Sandbox Management, e a organização que você copiar deve ter o aplicativo Sandbox Management atribuído. Para adicionar uma sandbox existente ou uma organização de produção, veja o artigo a seguir.
* [Adicionando organizações ao Gerenciamento de Sandbox](/sandbox-management/sandbox-management-us-english-pt-br/introducao/adicionando-organizacoes-ao-gerenciamento-de-sandbox.md)
Para usar um template, crie-o antes de atualizar a sandbox. Para saber como, veja o artigo a seguir.
* [Criando um Template](/sandbox-management/sandbox-management-us-english-pt-br/modelos/criando-um-template.md)
{% endhint %}
## Atualizando uma sandbox no Sandbox Management
{% stepper %}
{% step %}
### Abra a caixa de diálogo Atualizar Sandbox
1. Clique **Sandboxes** no menu da barra lateral esquerda.
2. Clique na sandbox que você deseja atualizar.
3. Clique **Executar atualização**.
{% hint style="info" %}
#### Intervalo de atualização
O Salesforce limita a frequência com que você pode atualizar uma sandbox: uma vez por dia para sandboxes Developer e Developer Pro, a cada 5 dias para sandboxes Partial e a cada 29 dias para sandboxes Full. O **Próximo disponível** mostra quando você pode atualizá-la novamente, e **Executar atualização** fica indisponível até lá.
{% endhint %}
{% endstep %}
{% step %}
### Insira os detalhes da atualização
1. (Opcional) Insira um novo **Nome** para renomear a sandbox. O campo mostra o nome atual da sandbox.
{% hint style="info" %}
#### Nomes da sandbox
Um nome de sandbox pode conter apenas letras e números, não pode começar com um número e pode ter até 10 caracteres.
{% endhint %}
2. Clique no **organização de origem** menu suspenso.
3. Selecione a organização a ser copiada.
{% hint style="info" %}
#### Usando uma sandbox como origem
Se você selecionar uma sandbox como a **organização de origem**, o Salesforce clona essa sandbox. Uma sandbox clonada mantém o tipo da sandbox de origem, então você não pode alterar o **tipo da sandbox**, e o **acesso à sandbox** campo não está disponível.
{% endhint %}
4. Clique no **tipo da sandbox** menu suspenso.
5. Selecione o tipo de sandbox. O tipo atual da sandbox está selecionado.
{% hint style="info" %}
#### Alterando o tipo da sandbox
Você pode atualizar uma sandbox como um tipo diferente, por exemplo, de **Developer** para **Developer Pro**. Cada tipo de sandbox usa uma das licenças de sandbox da sua org do Salesforce, então selecione um tipo para o qual sua org do Salesforce tenha uma licença disponível.
{% endhint %}
6. Clique no **acesso à sandbox** menu suspenso.
7. Selecione o grupo público cujos membros podem acessar a sandbox. A lista mostra os grupos públicos na organização de origem. Para criar um grupo público para acesso à sandbox, consulte [Determine quem tem acesso à sandbox](https://help.salesforce.com/s/articleView?id=sf.data_sandbox_selective_access.htm\&type=5) na Ajuda do Salesforce.
8. (Opcional) Clique no **Apex Class** menu suspenso e selecione uma classe Apex para executar depois que a sandbox for atualizada. A classe deve implementar a `SandboxPostCopy` interface do Salesforce. A lista mostra todas as classes Apex na organização de origem, e uma classe que não implementa a interface não é executada.
9. (Opcional) Clique no **Template** menu suspenso e selecione o template a aplicar.
10. Se você selecionou um template, revise suas etapas no **Prévia** painel.
{% hint style="warning" %}
#### Uma atualização não pode ser desfeita
Atualizar substitui a sandbox por uma nova cópia da organização de origem. Todos os registros, as alterações de metadados e os jobs agendados na sandbox que não foram implantados em produção são perdidos.
Conectar a sandbox atualizada também exclui permanentemente os dados de Backup & Archive, Data Migrator e Audit & Compliance armazenados para a organização da sandbox no seu tenant.
{% endhint %}
11. Clique **Atualizar**.
{% endstep %}
{% step %}
### Monitore a atualização
O **Sandboxes** lista não é atualizada automaticamente, então você precisa atualizá-la para ver o progresso da sandbox.
{% hint style="info" %}
#### Tempo de atualização
Uma atualização pode levar de vários minutos a vários dias, dependendo do tamanho da sua org do Salesforce e do tipo de sandbox.
{% endhint %}
1. O status da sandbox muda para **Atualizando**. Clique **Sandboxes** no menu da barra lateral esquerda.
2. Clique no ícone de atualização à direita da barra de pesquisa para atualizar a lista.
3. Enquanto o Salesforce atualiza a sandbox, seu **Status** mostra **Atualizando** e seu progresso.
4. Quando o **Status** mudar para **Pronta para conectar**, clique na sandbox.
{% endstep %}
{% step %}
### Entre na sandbox
{% hint style="info" %}
#### Entre antes de conectar
Antes de clicar em **Conectar**, faça login na sandbox atualizada como o usuário administrador dedicado com o qual você irá se conectar. A sandbox atualizada é uma nova org do Salesforce, então o Salesforce pode pedir que esse usuário configure novamente uma chave de acesso ou um app autenticador, mesmo que isso já tenha sido feito antes da atualização. Concluir isso primeiro torna o processo de conexão mais tranquilo. Para saber mais sobre o usuário administrador dedicado, veja o artigo a seguir.
* [Criando um usuário dedicado do Salesforce](/global-settings/global-settings-docs-pt-br/ambiente/organizacoes/criando-um-usuario-dedicado-do-salesforce.md)
{% endhint %}
1. Clique no URL de login da sandbox abaixo do nome dela para copiar o link.
2. Abra uma nova aba do navegador e cole o URL de login na barra de endereços.
3. Insira o **nome de usuário** e **senha** do usuário administrador.
4. Clique **Fazer login na sandbox**.
5. Se o Salesforce solicitar que você crie uma chave de acesso, clique em **Criar chave de acesso** e siga as instruções.
6. Volte ao Sandbox Management.
{% endstep %}
{% step %}
### Conecte a sandbox
1. Clique **Conectar**.
2. Insira o **nome de usuário** do mesmo usuário administrador.
3. Clique **Fazer login na sandbox** e conclua o login.
4. Clique **Permitir**.
{% endstep %}
{% step %}
### Revise a sandbox reconectada
Quando a conexão for concluída, a organização existente da sandbox em Global Settings é conectada à sandbox atualizada. Ela não é adicionada novamente, então mantém sua original **Criado em** data.
1. Global Settings é aberto na **página Organizações** , onde você pode visualizar a organização da sandbox.
{% endstep %}
{% step %}
### Monitore as etapas do template
Quando a sandbox estiver conectada, as etapas do template começam. Elas são executadas uma após a outra, na ordem mostrada no **Prévia** painel. Se você não selecionou um template, a sandbox **Status** mudar para **Pronto** quando a conexão for concluída.
1. No Sandbox Management, o **Status** mostra **Atualizando** e a etapa atual enquanto as etapas do template são executadas. Clique na sandbox para ver seus detalhes.
2. O **guia Execução** mostra o status de cada etapa, e o **Org ID** no **Visão geral** painel mostra o novo Org ID da sandbox atualizada.
3. Quando todas as etapas estiverem **Concluídas**, a sandbox **Status** mudar para **Pronto**.
{% endstep %}
{% endstepper %}
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.
Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:
```
GET https://docs.flosum.com/sandbox-management/sandbox-management-us-english-pt-br/sandboxes/atualizando-um-sandbox.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
