> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Comandos de backup

> O grupo de comandos /backup — crie, liste, inspecione, restaure, agende, exporte, importe e apague os backups do seu servidor pelo Discord.

`/backup` controla o [Backup do servidor](/pt/server-management/server-backup) de dentro do Discord. Um comando, **treze subcomandos**.

| Requisito              | Valor                                                      |
| ---------------------- | ---------------------------------------------------------- |
| **Você precisa de**    | Manage Server                                              |
| **O Vetox precisa de** | View Channel, Read Message History — e mais para restaurar |
| **Cooldown**           | 5s                                                         |
| **Onde**               | Somente em servidores. Não disponível em DMs               |

<Warning>
  **Toda resposta de `/backup` é efêmera — só você a vê.** Um ID de backup é uma chave para o conteúdo do seu servidor, então o Vetox nunca publica um onde outros membros possam ler.
</Warning>

<Note>
  Cada subcomando pode ser desabilitado ou restrito a cargos e canais específicos, individualmente, pelo [Gerenciamento de comandos](/pt/server-management/command-management). O `/backup create` pode ficar aberto aos seus admins enquanto o `/backup load` fica totalmente desligado.
</Note>

## Criando e inspecionando

<AccordionGroup>
  <Accordion title="/backup create — fazer um backup" icon="camera">
    | Opção      | Obrigatória | Observações                                     |
    | ---------- | ----------- | ----------------------------------------------- |
    | `name`     | Não         | Até 64 caracteres. Um nome facilita encontrá-lo |
    | `messages` | Não         | 0–250, limitado ao máximo do seu plano          |

    As seções premium são incluídas automaticamente até o que o seu plano permite. A resposta traz o ID do novo backup e depois é atualizada com o progresso. Quando o backup termina, a resposta mostra o **ID**, os dois comandos para usá-lo (`/backup info` e `/backup load`) e um link para o backup no painel — e, no Starter, um lembrete de que as mensagens, os dados dos membros, os bans e os anexos não foram guardados.

    <Note>
      Um backup manual por servidor a cada **10 minutos**, e um trabalho de backup ou de restauração por vez. Criar exige a permissão Administrator e, sob o [nível de permissão](/pt/server-management/server-backup#permissões) **Somente o dono**, apenas o dono.
    </Note>
  </Accordion>

  <Accordion title="/backup list — ver os seus backups" icon="list">
    | Opção   | Obrigatória | Observações                                                                                                |
    | ------- | ----------- | ---------------------------------------------------------------------------------------------------------- |
    | `page`  | Não         | A partir de 1. Vinte linhas por página                                                                     |
    | `scope` | Não         | **Este servidor** (padrão), **Backups de canal deste servidor** ou **Meus backups em todos os servidores** |

    Do mais recente ao mais antigo. Backups automáticos e de segurança são marcados para você distingui-los de relance. O `scope:mine` lista todos os backups que você criou, em qualquer servidor, com o servidor de onde vieram — a forma de encontrar o ID de um backup que você fez em outro lugar antes de carregá-lo aqui.
  </Accordion>

  <Accordion title="/backup info — o que um backup contém" icon="circle-info">
    | Opção       | Obrigatória | Observações                           |
    | ----------- | ----------- | ------------------------------------- |
    | `backup_id` | **Sim**     | Tem autocomplete enquanto você digita |

    Contagens, as opções com que ele foi capturado, o tamanho, os canais mais movimentados, quaisquer avisos, se ele está bloqueado pelo seu plano, e um link para o backup no Visualizador de instantâneos do painel — onde você pode ler cada canal, cargo, configuração, ban e membro que ele guarda.
  </Accordion>
</AccordionGroup>

<Tip>
  `backup_id` tem autocomplete em todo subcomando que o aceita, então você nunca precisa copiar um ID à mão. Ele oferece apenas os backups que você tem permissão de usar.
</Tip>

## Restaurando

<AccordionGroup>
  <Accordion title="/backup load — restaurar um backup" icon="rotate-left">
    | Opção       | Obrigatória | Observações                                                               |
    | ----------- | ----------- | ------------------------------------------------------------------------- |
    | `backup_id` | **Sim**     | Tem autocomplete, incluindo os seus próprios backups de outros servidores |
    | `messages`  | Não         | 0–250, limitado ao máximo do seu plano                                    |
    | `options`   | Não         | Até 200 caracteres. Veja a gramática abaixo                               |

    Nada é restaurado no primeiro clique. O Vetox responde com a **prévia** — quantos canais e cargos serão excluídos e criados, e se algum cargo está acima do próprio cargo do Vetox e por isso não pode ser tocado — atrás dos botões **Confirmar** e **Cancelar**, que expiram depois de **60 segundos**. Só ao confirmar é que o Vetox tira a cópia de segurança e começa a restauração.

    <Warning>
      Carregar um backup substitui os canais e cargos deste servidor. Nenhum membro é expulso, mas tudo o que foi criado depois de o backup ter sido feito vai desaparecer.
    </Warning>

    <Note>
      O `/backup load` obedece ao [nível de permissão](/pt/server-management/server-backup#permissões) do servidor. Sob o padrão **Administradores não podem realizar ações destrutivas**, qualquer pessoa que não seja o dono é recusada, mesmo com Administrator.
    </Note>

    <Note>
      Restaurações e reversões são racionadas por dia — **10 por servidor**, **20 por pessoa**. `/backup load`, `/backup channel load` e reverter uma alteração rastreada contam, cada um, para os dois; retomar uma restauração que falhou não conta.
    </Note>
  </Accordion>

  <Accordion title="/backup cancel — parar o trabalho em andamento" icon="ban">
    Sem opções. Cancela o backup ou a restauração ativa deste servidor. O checkpoint é mantido, então uma restauração cancelada ainda pode ser retomada pelo painel.
  </Accordion>

  <Accordion title="/backup status — o que está rodando e qual limite está ativo" icon="heart-pulse">
    Sem opções. Mostra o trabalho que está rodando neste servidor (tipo, fase, progresso, avisos, quando começou) ou que nada está rodando; quando o próximo backup manual será possível, se o cooldown de 10 minutos estiver ativo; quando o **limite de criação do Discord** acaba, se uma restauração esbarrou nele; e, quando nada está rodando, por que o último trabalho parou e se ele pode ser retomado pelo painel.
  </Accordion>
</AccordionGroup>

### A gramática de `options`

`options` é uma lista de tokens separados por espaço, aplicados **da esquerda para a direita**.

| Token                                                                                                      | Efeito                 |
| ---------------------------------------------------------------------------------------------------------- | ---------------------- |
| `settings` `roles` `delete-roles` `channels` `delete-channels` `members` `bans` `pins` `emojis` `stickers` | **Liga** essa parte    |
| `!` antes de qualquer um deles — `!members`                                                                | **Desliga** essa parte |
| `*`                                                                                                        | Liga **tudo**          |
| `!*`                                                                                                       | Desliga **tudo**       |

Deixe `options` totalmente de fora e o Vetox usa o padrão: **`delete-channels channels delete-roles roles settings`** — uma substituição estrutural completa, sem membros, bans, fixadas, emojis ou stickers.

| Exemplo                                  | Resultado                                                    |
| ---------------------------------------- | ------------------------------------------------------------ |
| `options:!* roles delete-roles`          | Só os cargos — exclui os cargos atuais e recria os do backup |
| `options:!* channels roles settings`     | Estrutura, somando ao que já existe — nada é excluído        |
| `options:* !members !bans`               | Tudo, exceto os dados dos membros e os bans                  |
| `options:!delete-channels !delete-roles` | O padrão, tornado aditivo                                    |

<Warning>
  **A ordem importa.** `* !members` liga tudo e depois desliga os membros. `!members *` desliga os membros e depois liga tudo de novo, incluindo os membros. Leia a sua lista de tokens da esquerda para a direita.
</Warning>

<Note>
  Os tokens nunca podem ampliar o que o seu plano permite — o limite do plano é aplicado por último. Um token desconhecido é recusado pelo nome em vez de ignorado, então um erro de digitação nunca é descartado em silêncio.
</Note>

## Agendamento

<AccordionGroup>
  <Accordion title="/backup interval — backups automáticos" icon="clock">
    | Opção      | Obrigatória | Observações                                                    |
    | ---------- | ----------- | -------------------------------------------------------------- |
    | `mode`     | **Sim**     | `on`, `off` ou `status`                                        |
    | `interval` | Não         | 4 horas, 8 horas, 12 horas, 24 horas, 2 dias, 3 dias, 1 semana |
    | `messages` | Não         | 0–250, limitado ao máximo do seu plano                         |

    `status` informa o agendamento atual sem alterá-lo: o intervalo, quantos são mantidos, a última e a próxima execução, e o ID do backup automático mais recente. Ligar o agendamento informa quando o primeiro backup vai rodar.

    <Note>
      Um intervalo menor do que o seu plano permite é recusado, e a recusa informa o mínimo do seu plano em horas. Os backups automáticos rotacionam: os mais antigos que passarem do número que o seu plano mantém são excluídos conforme novos chegam.
    </Note>
  </Accordion>
</AccordionGroup>

## Backups de canal

<AccordionGroup>
  <Accordion title="/backup channel create — fazer backup de um canal" icon="hashtag">
    | Opção      | Obrigatória | Observações                                                 |
    | ---------- | ----------- | ----------------------------------------------------------- |
    | `channel`  | Não         | De texto, de anúncios ou thread. Padrão: o canal atual      |
    | `messages` | Não         | 0–1000, limitado ao máximo do seu plano                     |
    | `before`   | Não         | Um ID de mensagem. Guarda as mensagens **anteriores** a ela |

    <Tip>
      `before` é como você vai mais para trás do que uma única execução permite: faça um backup de canal e depois faça outro com `before` definido como o ID da mensagem mais antiga que o primeiro alcançou.
    </Tip>
  </Accordion>

  <Accordion title="/backup channel load — publicá-las em um canal" icon="paste">
    | Opção       | Obrigatória | Observações                                 |
    | ----------- | ----------- | ------------------------------------------- |
    | `backup_id` | **Sim**     | O autocomplete traz apenas backups de canal |
    | `channel`   | Não         | Onde publicar. Padrão: o canal atual        |
    | `messages`  | Não         | 0–1000, limitado ao máximo do seu plano     |

    As mensagens são publicadas da mais antiga para a mais recente, com as fixadas.

    <Note>
      **Nada é excluído.** As mensagens armazenadas são acrescentadas ao que já existe no canal. Um backup de canal grande demora um pouco — a resposta informa o progresso conforme avança.
    </Note>
  </Accordion>
</AccordionGroup>

<Info>
  Os backups de canal exigem **Basic** ou superior.
</Info>

## Movendo backups

<AccordionGroup>
  <Accordion title="/backup export — baixar como JSON" icon="file-export">
    | Opção       | Obrigatória | Observações      |
    | ----------- | ----------- | ---------------- |
    | `backup_id` | **Sim**     | Tem autocomplete |

    Envia o backup como um arquivo `.json` no formato do Discord, anexado à resposta efêmera. Acima de **8 MB** você recebe um link do painel no lugar.

    <Note>
      As exportações levam o servidor, os cargos, os canais, os emojis e os stickers. **Mensagens, membros e bans não são incluídos** — restaure o backup para mover isso. A exportação funciona em todos os planos.
    </Note>
  </Accordion>

  <Accordion title="/backup import — criar um backup a partir de um arquivo" icon="file-import">
    | Opção  | Obrigatória | Observações                                               |
    | ------ | ----------- | --------------------------------------------------------- |
    | `file` | **Sim**     | Um `.json` de servidor no formato do Discord, de até 5 MB |

    O Vetox valida o arquivo, transforma-o em um backup e responde com o ID dele. Restaure-o ou inspecione-o como qualquer outro.

    <Warning>
      Um arquivo que não segue o formato de servidor do Discord é recusado por completo, nomeando o primeiro campo que falhou. O Vetox nunca aplica um pela metade.
    </Warning>

    <Info>
      A importação exige **Basic** ou superior.
    </Info>
  </Accordion>
</AccordionGroup>

## Excluindo

<AccordionGroup>
  <Accordion title="/backup delete — excluir um backup" icon="trash">
    | Opção       | Obrigatória | Observações      |
    | ----------- | ----------- | ---------------- |
    | `backup_id` | **Sim**     | Tem autocomplete |

    Pede **Confirmar** antes. A exclusão remove o instantâneo e todos os arquivos guardados com ele, de imediato e permanentemente.
  </Accordion>

  <Accordion title="/backup purge — excluir todos os backups" icon="dumpster-fire">
    Sem opções. Pede **Confirmar** e então exclui **todos** os backups deste servidor junto com os arquivos armazenados deles.

    <Warning>
      Não há como desfazer e não há lixeira. Exporte antes qualquer coisa que você queira manter.
    </Warning>
  </Accordion>
</AccordionGroup>

<Note>
  O `/backup delete` e o `/backup purge` são ações destrutivas sob o [nível de permissão](/pt/server-management/server-backup#permissões) do servidor, então no nível padrão eles são exclusivos do dono.
</Note>

## Exemplos

```text theme={null}
/backup create name:before-rework
/backup list page:1
/backup list scope:mine
/backup info backup_id:GB7K2QX4M1ZP
/backup load backup_id:GB7K2QX4M1ZP options:!* channels roles
/backup status
/backup interval mode:on interval:12h
/backup channel create channel:#general messages:500
```

## Quando um comando é recusado

O Vetox sempre informa o motivo. Os mais comuns:

| A resposta diz                                                                       | O que fazer                                                                                                                                                 |
| ------------------------------------------------------------------------------------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Um backup foi criado aqui recentemente                                               | Espere passar o cooldown de criação de 10 minutos por servidor                                                                                              |
| Já há outro trabalho de backup em andamento                                          | Espere por ele, ou use `/backup cancel`                                                                                                                     |
| O limite de hoje para restaurações e reversões foi atingido                          | Este servidor ou a sua conta gastou a cota diária de 10 por servidor / 20 por pessoa. Tente de novo amanhã                                                  |
| Você atingiu o limite de backups do seu plano                                        | Exclua um, ou faça upgrade                                                                                                                                  |
| Este backup está além do limite do seu plano                                         | Ele está bloqueado por um downgrade. Exclua um backup mais recente ou faça upgrade                                                                          |
| Só quem as permissões de backup do servidor permitem pode fazer isso                 | O nível de permissão do servidor deixa isso para o dono. O dono age, ou muda o nível em Configurações → Permissões                                          |
| Esse intervalo é menor do que o seu plano permite                                    | Use o mínimo que a mensagem informa, ou faça upgrade                                                                                                        |
| Uma das opções selecionadas não é válida                                             | Um token de `options` desconhecido — confira na gramática acima                                                                                             |
| Faltam ao Vetox as permissões de que ele precisa                                     | Dê Administrator ao Vetox e mova o cargo dele para cima dos cargos que estão sendo restaurados                                                              |
| O Discord permite que um bot crie apenas 250 cargos ou 500 canais dentro de 48 horas | O limite de criação do próprio Discord. O `/backup status` mostra quando ele acaba; espere e retome, ou carregue de novo com `options:!delete-roles !roles` |
| Esse arquivo não é uma exportação de servidor do Discord válida                      | O arquivo de importação não corresponde ao formato do Discord                                                                                               |
| O Backup do servidor está temporariamente indisponível                               | Pausado para manutenção. Os seus backups estão intactos                                                                                                     |

## Relacionado

<CardGroup cols={2}>
  <Card title="Backup do servidor" icon="server" href="/pt/server-management/server-backup">
    O recurso completo — restauração, agendamentos, rastreamento de alterações e Time Machine.
  </Card>

  <Card title="Meus backups" icon="box-archive" href="/pt/members/my-backups">
    Os seus backups em todos os servidores.
  </Card>

  <Card title="Gerenciamento de comandos" icon="sliders" href="/pt/server-management/command-management">
    Desabilite ou restrinja cada subcomando individualmente.
  </Card>

  <Card title="Referência de comandos" icon="terminal" href="/pt/commands/overview">
    Como funcionam as permissões e os cooldowns em todos os comandos.
  </Card>
</CardGroup>