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

# Comandi backup

> Il gruppo di comandi /backup — crea, elenca, ispeziona, ripristina, pianifica, esporta, importa ed elimina i backup del tuo server da Discord.

`/backup` gestisce [Server Backup](/it/server-management/server-backup) da dentro Discord. Un solo comando, **dodici sottocomandi**.

| Requisito         | Valore                                                                   |
| ----------------- | ------------------------------------------------------------------------ |
| **Ti serve**      | Manage Server — `create` e `channel create` richiedono **Administrator** |
| **A Vetox serve** | View Channel, Read Message History — più altri per ripristinare          |
| **Cooldown**      | 5s                                                                       |
| **Dove**          | Solo nei server. Non disponibile nei DM                                  |

<Warning>
  **Ogni risposta di `/backup` è effimera — la vedi solo tu.** L'ID di un backup è una chiave per il contenuto del tuo server, quindi Vetox non ne pubblica mai uno dove altri membri possano leggerlo.
</Warning>

<Note>
  Ogni sottocomando può essere disabilitato o limitato a ruoli e canali specifici singolarmente, tramite [Gestione comandi](/it/server-management/command-management). `/backup create` può essere aperto ai tuoi admin mentre `/backup load` è del tutto disattivato.
</Note>

## Creare e ispezionare

<AccordionGroup>
  <Accordion title="/backup create — crea un backup" icon="camera">
    | Opzione    | Richiesta | Note                                              |
    | ---------- | --------- | ------------------------------------------------- |
    | `name`     | No        | Fino a 64 caratteri. Un nome lo rende ritrovabile |
    | `messages` | No        | 0–250, limitato al massimo del tuo piano          |

    <Note>
      Creare un backup da Discord richiede il permesso **Administrator** — una cattura conserva ogni canale che Vetox può leggere, compresi quelli nascosti a te. L'altra via d'accesso è la concessione della sezione **Backup** della dashboard.
    </Note>

    Le sezioni premium vengono incluse automaticamente fino a quanto consente il tuo piano. La risposta riporta l'ID del nuovo backup e poi si aggiorna con l'avanzamento.

    <Note>
      Un backup manuale per server ogni **10 minuti**, e una sola operazione di backup o di ripristino alla volta.
    </Note>
  </Accordion>

  <Accordion title="/backup list — guarda i tuoi backup" icon="list">
    | Opzione | Richiesta | Note                         |
    | ------- | --------- | ---------------------------- |
    | `page`  | No        | Da 1. Venti righe per pagina |

    Dal più recente. I backup automatici e quelli di sicurezza sono contrassegnati così puoi distinguerli a colpo d'occhio.
  </Accordion>

  <Accordion title="/backup info — cosa contiene un backup" icon="circle-info">
    | Opzione     | Richiesta | Note                                      |
    | ----------- | --------- | ----------------------------------------- |
    | `backup_id` | **Sì**    | Si completa automaticamente mentre scrivi |

    Conteggi, le opzioni con cui è stato catturato, la sua dimensione, i canali più attivi, eventuali avvisi e se è bloccato dal tuo piano. Gli stessi numeri della scheda Panoramica del visualizzatore.
  </Accordion>
</AccordionGroup>

<Tip>
  `backup_id` si completa automaticamente in ogni sottocomando che lo accetta, così non devi mai copiare un ID a mano. Propone soltanto i backup che ti è consentito usare.
</Tip>

## Ripristinare

<AccordionGroup>
  <Accordion title="/backup load — ripristina un backup" icon="rotate-left">
    | Opzione     | Richiesta | Note                                                               |
    | ----------- | --------- | ------------------------------------------------------------------ |
    | `backup_id` | **Sì**    | Si completa automaticamente, inclusi i tuoi backup di altri server |
    | `messages`  | No        | 0–250, limitato al massimo del tuo piano                           |
    | `options`   | No        | Fino a 200 caratteri. Vedi la grammatica qui sotto                 |

    Alla prima pressione non viene ripristinato nulla. Vetox risponde con l'**anteprima** — quanti canali e ruoli verranno eliminati e creati — dietro i pulsanti **Conferma** e **Annulla**, che scadono dopo **60 secondi**. Solo con Conferma Vetox crea la copia di sicurezza e avvia il ripristino.

    <Warning>
      Caricare un backup sostituisce i canali e i ruoli di questo server. I membri non vengono mai espulsi, ma tutto ciò che è stato creato dopo la cattura del backup andrà perso.
    </Warning>

    <Note>
      `/backup load` rispetta la policy di ripristino del server. Con il valore predefinito **Solo il proprietario**, chiunque altro viene rifiutato anche con Manage Server.
    </Note>

    <Note>
      I ripristini e gli annullamenti di modifiche hanno un limite giornaliero — **10 per server**, **20 per persona**. `/backup load`, `/backup channel load` e l'annullamento di una modifica tracciata contano ciascuno su entrambi i limiti; riprendere un ripristino fallito no.
    </Note>
  </Accordion>

  <Accordion title="/backup cancel — ferma l'operazione in corso" icon="ban">
    Nessuna opzione. Interrompe il backup o il ripristino attivo di questo server. Il checkpoint viene conservato, quindi un ripristino interrotto può comunque essere ripreso dalla dashboard.
  </Accordion>
</AccordionGroup>

### La grammatica di `options`

`options` è un elenco di token separati da spazi, applicati **da sinistra a destra**.

| Token                                                                                                      | Effetto                |
| ---------------------------------------------------------------------------------------------------------- | ---------------------- |
| `settings` `roles` `delete-roles` `channels` `delete-channels` `members` `bans` `pins` `emojis` `stickers` | Attiva quella parte    |
| `!` prima di uno qualsiasi di essi — `!members`                                                            | Disattiva quella parte |
| `*`                                                                                                        | Attiva **tutto**       |
| `!*`                                                                                                       | Disattiva **tutto**    |

Ometti del tutto `options` e Vetox usa il valore predefinito: **`delete-channels channels delete-roles roles settings`** — una sostituzione strutturale completa, senza membri, ban, messaggi fissati, emoji o sticker.

| Esempio                                  | Risultato                                                         |
| ---------------------------------------- | ----------------------------------------------------------------- |
| `options:!* roles delete-roles`          | Solo i ruoli — elimina i ruoli attuali e ricrea quelli del backup |
| `options:!* channels roles settings`     | Struttura, in aggiunta a ciò che c'è — non viene eliminato nulla  |
| `options:* !members !bans`               | Tutto tranne i dati dei membri e i ban                            |
| `options:!delete-channels !delete-roles` | Il valore predefinito, reso aggiuntivo                            |

<Warning>
  **L'ordine conta.** `* !members` attiva tutto e poi disattiva i membri. `!members *` disattiva i membri e poi riattiva tutto, membri compresi. Leggi il tuo elenco di token da sinistra a destra.
</Warning>

<Note>
  I token non possono mai ampliare ciò che il tuo piano consente — il limite del piano viene applicato per ultimo. Un token sconosciuto viene rifiutato per nome anziché ignorato, così un errore di battitura non viene mai scartato in silenzio.
</Note>

## Pianificare

<AccordionGroup>
  <Accordion title="/backup interval — backup automatici" icon="clock">
    | Opzione    | Richiesta | Note                                                          |
    | ---------- | --------- | ------------------------------------------------------------- |
    | `mode`     | **Sì**    | `on`, `off` o `status`                                        |
    | `interval` | No        | 4 ore, 8 ore, 12 ore, 24 ore, 2 giorni, 3 giorni, 1 settimana |
    | `messages` | No        | 0–250, limitato al massimo del tuo piano                      |

    `status` riporta la pianificazione attuale senza modificarla.

    <Note>
      Un intervallo più breve di quanto consenta il tuo piano viene rifiutato, e il rifiuto indica il minimo del tuo piano in ore. I backup automatici ruotano: i più vecchi oltre il numero conservato dal tuo piano vengono eliminati man mano che ne arrivano di nuovi.
    </Note>
  </Accordion>
</AccordionGroup>

## Backup dei canali

<AccordionGroup>
  <Accordion title="/backup channel create — fai il backup di un canale" icon="hashtag">
    | Opzione    | Richiesta | Note                                                            |
    | ---------- | --------- | --------------------------------------------------------------- |
    | `channel`  | No        | Di testo, di annuncio o thread. Predefinito al canale corrente  |
    | `messages` | No        | 0–1000, limitato al massimo del tuo piano                       |
    | `before`   | No        | L'ID di un messaggio. Conserva i messaggi **precedenti** a esso |

    <Note>
      Fare il backup di un canale da Discord richiede il permesso **Administrator**.
    </Note>

    <Tip>
      `before` è il modo per andare più indietro di quanto consenta una singola esecuzione: fai un backup del canale, poi fanne un altro con `before` impostato sull'ID del messaggio più vecchio raggiunto dal primo.
    </Tip>
  </Accordion>

  <Accordion title="/backup channel load — pubblicali in un canale" icon="paste">
    | Opzione     | Richiesta | Note                                                    |
    | ----------- | --------- | ------------------------------------------------------- |
    | `backup_id` | **Sì**    | Si completa automaticamente solo con i backup di canale |
    | `channel`   | No        | Dove pubblicare. Predefinito al canale corrente         |
    | `messages`  | No        | 0–1000, limitato al massimo del tuo piano               |

    I messaggi vengono pubblicati dal più vecchio, con i loro messaggi fissati.

    <Note>
      **Non viene eliminato nulla.** I messaggi archiviati vengono aggiunti a quello che c'è già nel canale. Un backup di canale voluminoso richiede un po' di tempo — la risposta riporta l'avanzamento man mano che procede.
    </Note>
  </Accordion>
</AccordionGroup>

<Info>
  I backup dei canali richiedono **Basic** o superiore.
</Info>

## Spostare i backup

<AccordionGroup>
  <Accordion title="/backup export — scarica come JSON" icon="file-export">
    | Opzione     | Richiesta | Note                        |
    | ----------- | --------- | --------------------------- |
    | `backup_id` | **Sì**    | Si completa automaticamente |

    Invia il backup come file `.json` in formato Discord allegato alla risposta effimera. Oltre **8 MB** ricevi invece un link alla dashboard.

    <Note>
      Le esportazioni contengono il server, i ruoli, i canali, le emoji e gli sticker. **Messaggi, membri e ban non sono inclusi** — ripristina il backup per spostare quelli. L'esportazione funziona su tutti i piani.
    </Note>
  </Accordion>

  <Accordion title="/backup import — crea un backup da un file" icon="file-import">
    | Opzione | Richiesta | Note                                                 |
    | ------- | --------- | ---------------------------------------------------- |
    | `file`  | **Sì**    | Un `.json` di server in formato Discord, fino a 5 MB |

    Vetox convalida il file, lo trasforma in un backup e risponde con il suo ID. Ripristinalo o ispezionalo come qualsiasi altro.

    <Warning>
      Un file che non segue il formato server di Discord viene rifiutato del tutto, indicando il primo campo che ha fallito. Vetox non ne applica mai uno a metà.
    </Warning>

    <Info>
      L'importazione richiede **Basic** o superiore.
    </Info>
  </Accordion>
</AccordionGroup>

## Eliminare

<AccordionGroup>
  <Accordion title="/backup delete — elimina un backup" icon="trash">
    | Opzione     | Richiesta | Note                        |
    | ----------- | --------- | --------------------------- |
    | `backup_id` | **Sì**    | Si completa automaticamente |

    Chiede prima **Conferma**. L'eliminazione rimuove l'istantanea e ogni file conservato insieme a essa, subito e in modo definitivo.
  </Accordion>

  <Accordion title="/backup purge — elimina ogni backup" icon="dumpster-fire">
    Nessuna opzione. Chiede **Conferma**, poi elimina **ogni** backup di questo server insieme ai file archiviati.

    <Warning>
      Non c'è modo di annullare e non c'è cestino. Esporta prima tutto ciò che vuoi conservare.
    </Warning>
  </Accordion>
</AccordionGroup>

<Note>
  `/backup delete` e `/backup purge` seguono entrambi la policy di ripristino del server, quindi con **Solo il proprietario** sono riservati al proprietario.
</Note>

## Esempi

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

## Quando un comando viene rifiutato

Vetox indica sempre il motivo. I più comuni:

| La risposta dice                                                  | Cosa fare                                                                                                         |
| ----------------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------- |
| Qui è stato creato un backup di recente                           | Aspetta la fine del cooldown di creazione di 10 minuti per server                                                 |
| Creare un backup da Discord richiede il permesso Administrator    | Chiedilo a un amministratore, oppure crealo dalla sezione Backup della dashboard                                  |
| È già in corso un'altra operazione di backup                      | Aspetta che finisca, oppure usa `/backup cancel`                                                                  |
| Il limite odierno per ripristini e annullamenti è stato raggiunto | Questo server o il tuo account ha esaurito la quota giornaliera di 10 per server / 20 per persona. Riprova domani |
| Hai raggiunto il limite di backup del tuo piano                   | Eliminane uno, oppure fai l'upgrade                                                                               |
| Questo backup supera il limite del tuo piano                      | È bloccato da un downgrade. Elimina un backup più recente o fai l'upgrade                                         |
| Solo chi è autorizzato dalla policy di ripristino può farlo       | Il server è su **Solo il proprietario**. Agisce il proprietario, o cambia la policy                               |
| Quell'intervallo è più breve di quanto consenta il tuo piano      | Usa il minimo indicato dal messaggio, oppure fai l'upgrade                                                        |
| Una delle opzioni selezionate non è valida                        | Un token `options` sconosciuto — controllalo con la grammatica qui sopra                                          |
| A Vetox mancano i permessi necessari                              | Concedi a Vetox Administrator e sposta il suo ruolo sopra i ruoli da ripristinare                                 |
| Discord sta limitando la creazione di canali su questo server     | Il cooldown di creazione di Discord, o il suo tetto di 500 canali / 250 ruoli. Aspetta, poi riprendi              |
| Quel file non è un'esportazione di server Discord valida          | Il file di importazione non corrisponde al formato di Discord                                                     |
| Server Backup è temporaneamente non disponibile                   | In pausa per manutenzione. I tuoi backup sono intatti                                                             |

## Correlati

<CardGroup cols={2}>
  <Card title="Server Backup" icon="server" href="/it/server-management/server-backup">
    La funzionalità completa — ripristino, pianificazioni, tracciamento delle modifiche e Time Machine.
  </Card>

  <Card title="I miei backup" icon="box-archive" href="/it/members/my-backups">
    I tuoi backup su ogni server.
  </Card>

  <Card title="Gestione comandi" icon="sliders" href="/it/server-management/command-management">
    Disabilita o limita ogni sottocomando singolarmente.
  </Card>

  <Card title="Riferimento comandi" icon="terminal" href="/it/commands/overview">
    Come funzionano permessi e cooldown in tutti i comandi.
  </Card>
</CardGroup>
