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

# Commandes de sauvegarde

> Le groupe de commandes /backup — créez, listez, inspectez, restaurez, planifiez, exportez, importez et purgez les sauvegardes de votre serveur depuis Discord.

`/backup` pilote la [Sauvegarde du serveur](/fr/server-management/server-backup) depuis Discord. Une commande, **treize sous-commandes**.

| Prérequis            | Valeur                                                                  |
| -------------------- | ----------------------------------------------------------------------- |
| **Vous avez besoin** | Gérer le serveur                                                        |
| **Vetox a besoin**   | Voir le salon, Voir les anciens messages — plus d'autres pour restaurer |
| **Cooldown**         | 5s                                                                      |
| **Où**               | Sur les serveurs uniquement. Indisponible en MP                         |

<Warning>
  **Chaque réponse de `/backup` est éphémère — vous seul la voyez.** Un identifiant de sauvegarde est une clé donnant accès au contenu de votre serveur : Vetox n'en publie donc jamais un là où d'autres membres pourraient le lire.
</Warning>

<Note>
  Chaque sous-commande peut être désactivée ou restreinte à des rôles et à des salons précis, individuellement, via la [gestion des commandes](/fr/server-management/command-management). `/backup create` peut être ouverte à vos administrateurs pendant que `/backup load` est entièrement désactivée.
</Note>

## Créer et inspecter

<AccordionGroup>
  <Accordion title="/backup create — prendre une sauvegarde" icon="camera">
    | Option     | Requis | Notes                                             |
    | ---------- | ------ | ------------------------------------------------- |
    | `name`     | Non    | Jusqu'à 64 caractères. Un nom la rend retrouvable |
    | `messages` | Non    | 0–250, plafonné au maximum de votre palier        |

    Les sections premium sont incluses automatiquement, dans la limite de ce que votre palier autorise. La réponse contient l'identifiant de la nouvelle sauvegarde, puis se met à jour avec la progression. Une fois la sauvegarde terminée, la réponse affiche l'**identifiant**, les deux commandes qui l'utilisent (`/backup info` et `/backup load`) et un lien vers la sauvegarde dans le tableau de bord — et, sur Starter, un rappel indiquant que les messages, les données des membres, les bannissements et les pièces jointes n'ont pas été enregistrés.

    <Note>
      Une sauvegarde manuelle par serveur toutes les **10 minutes**, et une seule tâche de sauvegarde ou de restauration à la fois. La création exige la permission Administrateur et, sous le [niveau de permissions](/fr/server-management/server-backup#permissions) **Seul le propriétaire**, elle lui est réservée.
    </Note>
  </Accordion>

  <Accordion title="/backup list — voir vos sauvegardes" icon="list">
    | Option  | Requis | Notes                                                                                                             |
    | ------- | ------ | ----------------------------------------------------------------------------------------------------------------- |
    | `page`  | Non    | À partir de 1. Vingt lignes par page                                                                              |
    | `scope` | Non    | **Ce serveur** (par défaut), **Sauvegardes de salon de ce serveur**, ou **Mes sauvegardes sur tous les serveurs** |

    De la plus récente à la plus ancienne. Les sauvegardes automatiques et de sécurité sont signalées pour que vous les distinguiez d'un coup d'œil. `scope:mine` liste toutes les sauvegardes que vous avez créées, sur n'importe quel serveur, avec le serveur d'où elles proviennent — c'est ainsi que l'on retrouve l'identifiant d'une sauvegarde prise ailleurs avant de la charger ici.
  </Accordion>

  <Accordion title="/backup info — ce que contient une sauvegarde" icon="circle-info">
    | Option      | Requis  | Notes                            |
    | ----------- | ------- | -------------------------------- |
    | `backup_id` | **Oui** | Autocomplétion pendant la saisie |

    Les décomptes, les options de capture, la taille, les salons les plus fournis, les éventuels avertissements, si elle est verrouillée par votre palier, et un lien vers la sauvegarde dans la Visionneuse d'instantané du tableau de bord — où vous pouvez lire chaque salon, rôle, paramètre, bannissement et membre qu'elle contient.
  </Accordion>
</AccordionGroup>

<Tip>
  `backup_id` bénéficie de l'autocomplétion sur chaque sous-commande qui en prend un, vous n'avez donc jamais à copier un identifiant à la main. Elle ne propose que les sauvegardes que vous avez le droit d'utiliser.
</Tip>

## Restaurer

<AccordionGroup>
  <Accordion title="/backup load — restaurer une sauvegarde" icon="rotate-left">
    | Option      | Requis  | Notes                                                               |
    | ----------- | ------- | ------------------------------------------------------------------- |
    | `backup_id` | **Oui** | Autocomplétion, y compris vos propres sauvegardes d'autres serveurs |
    | `messages`  | Non     | 0–250, plafonné au maximum de votre palier                          |
    | `options`   | Non     | Jusqu'à 200 caractères. Voir la grammaire ci-dessous                |

    Rien n'est restauré au premier appui. Vetox répond par le **plan d'exécution** — combien de salons et de rôles seront supprimés et créés, et si des rôles se situent au-dessus du rôle de Vetox lui-même et ne peuvent donc pas être touchés — derrière des boutons **Confirmer** et **Annuler** qui expirent au bout de **60 secondes**. Ce n'est qu'à la confirmation que Vetox prend la copie de sécurité et démarre la restauration.

    <Warning>
      Charger une sauvegarde remplace les salons et les rôles de ce serveur. Aucun membre n'est jamais expulsé, mais tout ce qui a été créé depuis la capture de la sauvegarde disparaîtra.
    </Warning>

    <Note>
      `/backup load` respecte le [niveau de permissions](/fr/server-management/server-backup#permissions) du serveur. Sous le réglage par défaut **Les admins ne peuvent pas effectuer d'actions destructrices**, toute personne autre que le propriétaire est refusée, même avec Administrateur.
    </Note>

    <Note>
      Les restaurations et les annulations de changement sont rationnées chaque jour — **10 par serveur**, **20 par personne**. `/backup load`, `/backup channel load` et l'annulation d'un changement suivi comptent chacune dans les deux budgets ; reprendre une restauration échouée ne compte pas.
    </Note>
  </Accordion>

  <Accordion title="/backup cancel — arrêter la tâche en cours" icon="ban">
    Aucune option. Interrompt la sauvegarde ou la restauration active de ce serveur. Le point de reprise est conservé : une restauration interrompue peut donc toujours être reprise depuis le tableau de bord.
  </Accordion>

  <Accordion title="/backup status — ce qui tourne, et toute limite active" icon="heart-pulse">
    Aucune option. Affiche la tâche en cours sur ce serveur (type, phase, progression, avertissements, heure de démarrage) ou le fait qu'aucune ne tourne ; quand la prochaine sauvegarde manuelle sera possible si le cooldown de 10 minutes est actif ; quand **la limite de création de Discord** sera levée si une restauration l'a atteinte ; et, lorsque rien ne tourne, pourquoi la dernière tâche s'est arrêtée et si elle peut être reprise depuis le tableau de bord.
  </Accordion>
</AccordionGroup>

### La grammaire de `options`

`options` est une liste de jetons séparés par des espaces, appliqués **de gauche à droite**.

| Jeton                                                                                                      | Effet                  |
| ---------------------------------------------------------------------------------------------------------- | ---------------------- |
| `settings` `roles` `delete-roles` `channels` `delete-channels` `members` `bans` `pins` `emojis` `stickers` | Active cette partie    |
| `!` devant l'un d'eux — `!members`                                                                         | Désactive cette partie |
| `*`                                                                                                        | Active **tout**        |
| `!*`                                                                                                       | Désactive **tout**     |

Omettez complètement `options` et Vetox utilise la valeur par défaut : **`delete-channels channels delete-roles roles settings`** — un remplacement structurel complet, sans les membres, les bannissements, les épinglages, les émojis ni les autocollants.

| Exemple                                  | Résultat                                                                       |
| ---------------------------------------- | ------------------------------------------------------------------------------ |
| `options:!* roles delete-roles`          | Les rôles seulement — supprime les rôles actuels, recrée ceux de la sauvegarde |
| `options:!* channels roles settings`     | La structure, ajoutée à l'existant — rien n'est supprimé                       |
| `options:* !members !bans`               | Tout sauf les données des membres et les bannissements                         |
| `options:!delete-channels !delete-roles` | La valeur par défaut, rendue additive                                          |

<Warning>
  **L'ordre compte.** `* !members` active tout, puis désactive les membres. `!members *` désactive les membres, puis réactive tout, membres compris. Lisez votre liste de jetons de gauche à droite.
</Warning>

<Note>
  Les jetons ne peuvent jamais élargir ce que votre palier autorise — la limite du palier est appliquée en dernier. Un jeton inconnu est refusé nommément plutôt qu'ignoré : une faute de frappe n'est donc jamais écartée en silence.
</Note>

## Planifier

<AccordionGroup>
  <Accordion title="/backup interval — sauvegardes automatiques" icon="clock">
    | Option     | Requis  | Notes                                                                 |
    | ---------- | ------- | --------------------------------------------------------------------- |
    | `mode`     | **Oui** | `on`, `off` ou `status`                                               |
    | `interval` | Non     | 4 heures, 8 heures, 12 heures, 24 heures, 2 jours, 3 jours, 1 semaine |
    | `messages` | Non     | 0–250, plafonné au maximum de votre palier                            |

    `status` indique la planification actuelle sans la modifier : l'intervalle, le nombre de sauvegardes conservées, la dernière et la prochaine exécution, ainsi que l'identifiant de la dernière sauvegarde automatique. Activer la planification vous indique quand la première sauvegarde s'exécutera.

    <Note>
      Un intervalle plus court que ce que votre palier autorise est refusé, et le refus indique le minimum de votre palier en heures. Les sauvegardes automatiques tournent : les plus anciennes au-delà du nombre conservé par votre palier sont supprimées à mesure que de nouvelles arrivent.
    </Note>
  </Accordion>
</AccordionGroup>

## Sauvegardes de salon

<AccordionGroup>
  <Accordion title="/backup channel create — sauvegarder un salon" icon="hashtag">
    | Option     | Requis | Notes                                                               |
    | ---------- | ------ | ------------------------------------------------------------------- |
    | `channel`  | Non    | Texte, annonces ou fil. Par défaut, le salon actuel                 |
    | `messages` | Non    | 0–1000, plafonné au maximum de votre palier                         |
    | `before`   | Non    | Un identifiant de message. Stocke les messages qui le **précèdent** |

    <Tip>
      `before` est le moyen de remonter plus loin qu'une seule exécution ne le permet : prenez une sauvegarde de salon, puis prenez-en une autre avec `before` réglé sur l'identifiant du plus ancien message atteint par la première.
    </Tip>
  </Accordion>

  <Accordion title="/backup channel load — les publier dans un salon" icon="paste">
    | Option      | Requis  | Notes                                              |
    | ----------- | ------- | -------------------------------------------------- |
    | `backup_id` | **Oui** | Autocomplétion des sauvegardes de salon uniquement |
    | `channel`   | Non     | Où publier. Par défaut, le salon actuel            |
    | `messages`  | Non     | 0–1000, plafonné au maximum de votre palier        |

    Les messages sont publiés du plus ancien au plus récent, avec leurs épinglages.

    <Note>
      **Rien n'est supprimé.** Les messages stockés s'ajoutent à ce qui se trouve déjà dans le salon. Une grosse sauvegarde de salon prend un certain temps — la réponse rend compte de la progression au fur et à mesure.
    </Note>
  </Accordion>
</AccordionGroup>

<Info>
  Les sauvegardes de salon nécessitent **Basic** ou supérieur.
</Info>

## Déplacer des sauvegardes

<AccordionGroup>
  <Accordion title="/backup export — télécharger au format JSON" icon="file-export">
    | Option      | Requis  | Notes          |
    | ----------- | ------- | -------------- |
    | `backup_id` | **Oui** | Autocomplétion |

    Envoie la sauvegarde sous forme de fichier `.json` au format Discord, joint à la réponse éphémère. Au-delà de **8 Mo**, vous recevez un lien vers le tableau de bord à la place.

    <Note>
      Les exports contiennent le serveur, les rôles, les salons, les émojis et les autocollants. **Les messages, les membres et les bannissements n'y figurent pas** — restaurez la sauvegarde pour les déplacer. L'exportation fonctionne sur chaque palier.
    </Note>
  </Accordion>

  <Accordion title="/backup import — construire une sauvegarde depuis un fichier" icon="file-import">
    | Option | Requis  | Notes                                                 |
    | ------ | ------- | ----------------------------------------------------- |
    | `file` | **Oui** | Un `.json` de serveur au format Discord, jusqu'à 5 Mo |

    Vetox valide le fichier, le transforme en sauvegarde et répond avec son identifiant. Restaurez-la ou inspectez-la comme n'importe quelle autre.

    <Warning>
      Un fichier qui ne respecte pas le format de serveur de Discord est rejeté d'emblée, en nommant le premier champ en cause. Vetox n'en applique jamais la moitié.
    </Warning>

    <Info>
      L'importation nécessite **Basic** ou supérieur.
    </Info>
  </Accordion>
</AccordionGroup>

## Supprimer

<AccordionGroup>
  <Accordion title="/backup delete — supprimer une sauvegarde" icon="trash">
    | Option      | Requis  | Notes          |
    | ----------- | ------- | -------------- |
    | `backup_id` | **Oui** | Autocomplétion |

    Demande d'abord de **Confirmer**. La suppression retire l'instantané et chaque fichier stocké avec lui, immédiatement et définitivement.
  </Accordion>

  <Accordion title="/backup purge — supprimer toutes les sauvegardes" icon="dumpster-fire">
    Aucune option. Demande de **Confirmer**, puis supprime **toutes** les sauvegardes de ce serveur ainsi que leurs fichiers stockés.

    <Warning>
      Il n'y a ni annulation ni corbeille. Exportez d'abord tout ce que vous voulez conserver.
    </Warning>
  </Accordion>
</AccordionGroup>

<Note>
  `/backup delete` et `/backup purge` sont des actions destructrices au sens du [niveau de permissions](/fr/server-management/server-backup#permissions) du serveur : sous le niveau par défaut, elles sont donc réservées au propriétaire.
</Note>

## Exemples

```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
```

## Quand une commande est refusée

Vetox nomme toujours la raison. Les plus courantes :

| Ce que dit la réponse                                                                           | Que faire                                                                                                                                                      |
| ----------------------------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Une sauvegarde a été créée ici récemment                                                        | Attendez la fin du cooldown de création de 10 minutes, par serveur                                                                                             |
| Une autre tâche de sauvegarde est déjà en cours                                                 | Attendez sa fin, ou utilisez `/backup cancel`                                                                                                                  |
| La limite du jour pour les restaurations et les annulations est atteinte                        | Ce serveur ou votre compte a épuisé son quota quotidien de 10 par serveur / 20 par personne. Réessayez demain                                                  |
| Vous avez atteint la limite de sauvegardes de votre palier                                      | Supprimez-en une, ou montez de palier                                                                                                                          |
| Cette sauvegarde dépasse la limite de votre palier                                              | Elle est verrouillée par une rétrogradation. Supprimez une sauvegarde plus récente ou montez de palier                                                         |
| Seules les personnes autorisées par les permissions de sauvegarde du serveur peuvent faire cela | Le niveau de permissions du serveur réserve cela au propriétaire. Le propriétaire agit, ou change le niveau dans Paramètres → Permissions                      |
| Cet intervalle est plus court que ce que votre palier autorise                                  | Utilisez le minimum indiqué par le message, ou montez de palier                                                                                                |
| L'une des options sélectionnées n'est pas valide                                                | Un jeton `options` inconnu — vérifiez-le avec la grammaire ci-dessus                                                                                           |
| Il manque à Vetox les permissions dont il a besoin                                              | Donnez Administrateur à Vetox et remontez son rôle au-dessus des rôles à restaurer                                                                             |
| Discord n'autorise un bot à créer que 250 rôles ou 500 salons en 48 heures                      | La limite de création propre à Discord. `/backup status` indique quand elle est levée ; attendez et reprenez, ou rechargez avec `options:!delete-roles !roles` |
| Ce fichier n'est pas un export de serveur Discord valide                                        | Le fichier d'importation ne correspond pas au format de Discord                                                                                                |
| La Sauvegarde du serveur est temporairement indisponible                                        | Suspendue pour maintenance. Vos sauvegardes sont intactes                                                                                                      |

## Voir aussi

<CardGroup cols={2}>
  <Card title="Sauvegarde du serveur" icon="server" href="/fr/server-management/server-backup">
    La fonctionnalité complète — restauration, planification, suivi des changements et Time Machine.
  </Card>

  <Card title="Mes sauvegardes" icon="box-archive" href="/fr/members/my-backups">
    Vos sauvegardes sur tous vos serveurs.
  </Card>

  <Card title="Gestion des commandes" icon="sliders" href="/fr/server-management/command-management">
    Désactivez ou restreignez chaque sous-commande individuellement.
  </Card>

  <Card title="Référence des commandes" icon="terminal" href="/fr/commands/overview">
    Comment fonctionnent les permissions et les cooldowns sur l'ensemble des commandes.
  </Card>
</CardGroup>