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

# Команди резервного копіювання

> Група команд /backup — створення, список, перегляд, відновлення, розклад, експорт, імпорт і повне очищення резервних копій вашого сервера просто з Discord.

`/backup` керує [Резервною копією сервера](/uk/server-management/server-backup) прямо з Discord. Одна команда, **тринадцять підкоманд**.

| Вимога             | Значення                                                         |
| ------------------ | ---------------------------------------------------------------- |
| **Вам потрібно**   | Manage Server                                                    |
| **Vetox потрібно** | View Channel, Read Message History — плюс більше для відновлення |
| **Кулдаун**        | 5 с                                                              |
| **Де**             | Лише на серверах. Недоступна в особистих повідомленнях           |

<Warning>
  **Кожна відповідь `/backup` ефемерна — її бачите лише ви.** ID копії — це ключ до вмісту вашого сервера, тож Vetox ніколи не публікує його там, де його прочитають інші учасники.
</Warning>

<Note>
  Кожну підкоманду можна вимкнути або обмежити окремими ролями й каналами індивідуально — через [Керування командами](/uk/server-management/command-management). `/backup create` може бути відкритою для ваших адміністраторів, тоді як `/backup load` — вимкненою повністю.
</Note>

## Створення та перегляд

<AccordionGroup>
  <Accordion title="/backup create — зробити копію" icon="camera">
    | Опція      | Обов'язково | Примітки                                  |
    | ---------- | ----------- | ----------------------------------------- |
    | `name`     | Ні          | До 64 символів. Назва допомагає її знайти |
    | `messages` | Ні          | 0–250, обмежено максимумом вашого тарифу  |

    Преміум-розділи включаються автоматично в межах того, що дозволяє ваш тариф. У відповіді приходить ID нової копії, а далі вона оновлюється прогресом. Коли копію завершено, у відповіді показано **ID**, дві команди для роботи з нею (`/backup info` і `/backup load`) та посилання на копію в панелі, — а на Starter ще й нагадування, що повідомлення, дані учасників, бани й вкладення не збережено.

    <Note>
      Одна ручна копія на сервер раз на **10 хвилин** і одне завдання копіювання чи відновлення за раз. Для створення потрібне право Administrator, а за [рівня прав](/uk/server-management/server-backup#права) **Лише власник** — тільки власник.
    </Note>
  </Accordion>

  <Accordion title="/backup list — переглянути свої копії" icon="list">
    | Опція   | Обов'язково | Примітки                                                                                             |
    | ------- | ----------- | ---------------------------------------------------------------------------------------------------- |
    | `page`  | Ні          | Від 1. Двадцять рядків на сторінку                                                                   |
    | `scope` | Ні          | **Цей сервер** (за замовчуванням), **Копії каналів цього сервера** або **Мої копії з усіх серверів** |

    Найновіші зверху. Автоматичні та захисні копії позначено, щоб ви розрізняли їх з першого погляду. `scope:mine` перелічує кожну створену вами копію на будь-якому сервері разом із сервером, з якого вона походить, — так знаходять ID копії, зробленої деінде, перш ніж завантажити її сюди.
  </Accordion>

  <Accordion title="/backup info — що містить копія" icon="circle-info">
    | Опція       | Обов'язково | Примітки                          |
    | ----------- | ----------- | --------------------------------- |
    | `backup_id` | **Так**     | Автодоповнюється під час введення |

    Кількості, опції, з якими зроблено копію, її розмір, найактивніші канали, будь-які попередження, те, чи заблокована вона вашим тарифом, і посилання на копію в Переглядачі знімка в панелі — там можна прочитати кожен канал, роль, налаштування, бан і учасника, які вона містить.
  </Accordion>
</AccordionGroup>

<Tip>
  `backup_id` автодоповнюється в кожній підкоманді, яка його приймає, тож вам ніколи не доведеться копіювати ID вручну. Пропонуються лише ті копії, якими вам дозволено користуватися.
</Tip>

## Відновлення

<AccordionGroup>
  <Accordion title="/backup load — відновити копію" icon="rotate-left">
    | Опція       | Обов'язково | Примітки                                                    |
    | ----------- | ----------- | ----------------------------------------------------------- |
    | `backup_id` | **Так**     | Автодоповнюється, включно з вашими копіями з інших серверів |
    | `messages`  | Ні          | 0–250, обмежено максимумом вашого тарифу                    |
    | `options`   | Ні          | До 200 символів. Див. граматику нижче                       |

    Після першого натискання ще нічого не відновлюється. Vetox відповідає **планом** — скільки каналів і ролей буде видалено й створено та чи є ролі, що стоять вище за власну роль Vetox і тому недоторканні, — з кнопками **Підтвердити** і **Скасувати**, які згасають через **60 секунд**. Лише після підтвердження Vetox робить захисну копію й починає відновлення.

    <Warning>
      Завантаження копії замінює канали й ролі цього сервера. Учасників ніколи не виганяють, але все створене після того, як копію було зроблено, зникне.
    </Warning>

    <Note>
      `/backup load` підпорядковується [рівню прав](/uk/server-management/server-backup#права) сервера. За стандартного **Адміністратори не можуть виконувати руйнівні дії** всім, крім власника, буде відмовлено навіть за наявності Administrator.
    </Note>

    <Note>
      Відновлення й відкати обмежені на добу — **10 на сервер**, **20 на людину**. `/backup load`, `/backup channel load` і відкат відстеженої зміни рахуються в обидва ліміти; продовження перерваного відновлення — ні.
    </Note>
  </Accordion>

  <Accordion title="/backup cancel — зупинити поточне завдання" icon="ban">
    Без опцій. Скасовує активне копіювання чи відновлення на цьому сервері. Контрольну точку збережено, тож скасоване відновлення все одно можна продовжити з панелі.
  </Accordion>

  <Accordion title="/backup status — що виконується і які ліміти діють" icon="heart-pulse">
    Без опцій. Показує завдання, яке виконується на цьому сервері (вид, фаза, прогрес, попередження, коли почалося), або що не виконується нічого; коли буде можлива наступна ручна копія, якщо діє 10-хвилинний кулдаун; коли спаде **ліміт створення Discord**, якщо відновлення в нього вперлося; а коли нічого не виконується — чому зупинилося останнє завдання й чи можна продовжити його з панелі.
  </Accordion>
</AccordionGroup>

### Граматика `options`

`options` — це список токенів через пробіл, що застосовуються **зліва направо**.

| Токен                                                                                                      | Дія                |
| ---------------------------------------------------------------------------------------------------------- | ------------------ |
| `settings` `roles` `delete-roles` `channels` `delete-channels` `members` `bans` `pins` `emojis` `stickers` | Вмикає цю частину  |
| `!` перед будь-яким із них — `!members`                                                                    | Вимикає цю частину |
| `*`                                                                                                        | Вмикає **все**     |
| `!*`                                                                                                       | Вимикає **все**    |

Не вказуйте `options` узагалі — і Vetox візьме стандартне значення: **`delete-channels channels delete-roles roles settings`** — повна структурна заміна, без учасників, банів, закріплень, емодзі та стікерів.

| Приклад                                  | Результат                                                |
| ---------------------------------------- | -------------------------------------------------------- |
| `options:!* roles delete-roles`          | Лише ролі — видаляє поточні ролі, відтворює ролі з копії |
| `options:!* channels roles settings`     | Структура, додана до наявного — нічого не видаляється    |
| `options:* !members !bans`               | Усе, крім даних учасників і банів                        |
| `options:!delete-channels !delete-roles` | Стандартне значення, переведене в режим додавання        |

<Warning>
  **Порядок має значення.** `* !members` вмикає все, а потім вимикає учасників. `!members *` вимикає учасників, а потім вмикає все назад, разом з учасниками. Читайте свій список токенів зліва направо.
</Warning>

<Note>
  Токени ніколи не можуть розширити те, що дозволяє ваш тариф — обмеження тарифу застосовується останнім. Невідомий токен не ігнорується: у відмові прямо названо, який саме токен не підійшов, — тож помилка в написанні ніколи не зникає мовчки.
</Note>

## Розклад

<AccordionGroup>
  <Accordion title="/backup interval — автоматичні копії" icon="clock">
    | Опція      | Обов'язково | Примітки                                                        |
    | ---------- | ----------- | --------------------------------------------------------------- |
    | `mode`     | **Так**     | `on`, `off` або `status`                                        |
    | `interval` | Ні          | 4 години, 8 годин, 12 годин, 24 години, 2 дні, 3 дні, 1 тиждень |
    | `messages` | Ні          | 0–250, обмежено максимумом вашого тарифу                        |

    `status` повідомляє поточний розклад, не змінюючи його: інтервал, скільки копій зберігається, останній і наступний запуски та ID найновішої автоматичної копії. Коли ви вмикаєте розклад, вам повідомляють, коли відбудеться перше копіювання.

    <Note>
      Інтервал, коротший за дозволений вашим тарифом, відхиляється, і у відмові названо мінімум для вашого тарифу в годинах. Автоматичні копії ротуються: найстаріші понад те число, яке зберігає ваш тариф, видаляються, щойно з'являються нові.
    </Note>
  </Accordion>
</AccordionGroup>

## Резервні копії каналів

<AccordionGroup>
  <Accordion title="/backup channel create — скопіювати один канал" icon="hashtag">
    | Опція      | Обов'язково | Примітки                                                         |
    | ---------- | ----------- | ---------------------------------------------------------------- |
    | `channel`  | Ні          | Текстовий, оголошень або тред. За замовчуванням — поточний канал |
    | `messages` | Ні          | 0–1000, обмежено максимумом вашого тарифу                        |
    | `before`   | Ні          | ID повідомлення. Зберігає повідомлення **до** нього              |

    <Tip>
      `before` — це спосіб зайти глибше в минуле, ніж дозволяє один запуск: зробіть копію каналу, а потім зробіть ще одну з `before`, що дорівнює ID найстарішого повідомлення, до якого дійшла перша.
    </Tip>
  </Accordion>

  <Accordion title="/backup channel load — опублікувати їх у канал" icon="paste">
    | Опція       | Обов'язково | Примітки                                            |
    | ----------- | ----------- | --------------------------------------------------- |
    | `backup_id` | **Так**     | Автодоповнює лише копії каналів                     |
    | `channel`   | Ні          | Куди публікувати. За замовчуванням — поточний канал |
    | `messages`  | Ні          | 0–1000, обмежено максимумом вашого тарифу           |

    Повідомлення публікуються від найстаріших, разом із їхніми закріпленнями.

    <Note>
      **Нічого не видаляється.** Збережені повідомлення додаються до того, що вже є в каналі. Велика копія каналу публікується довго — відповідь повідомляє прогрес по ходу.
    </Note>
  </Accordion>
</AccordionGroup>

<Info>
  Резервні копії каналів потребують **Basic** або вище.
</Info>

## Перенесення копій

<AccordionGroup>
  <Accordion title="/backup export — завантажити як JSON" icon="file-export">
    | Опція       | Обов'язково | Примітки         |
    | ----------- | ----------- | ---------------- |
    | `backup_id` | **Так**     | Автодоповнюється |

    Надсилає копію як файл `.json` у форматі Discord, прикріплений до ефемерної відповіді. Понад **8 МБ** ви натомість отримаєте посилання на панель.

    <Note>
      Експорт несе сервер, ролі, канали, емодзі та стікери. **Повідомлень, учасників і банів у ньому немає** — щоб перенести їх, відновіть копію. Експорт працює на будь-якому тарифі.
    </Note>
  </Accordion>

  <Accordion title="/backup import — зібрати копію з файлу" icon="file-import">
    | Опція  | Обов'язково | Примітки                                        |
    | ------ | ----------- | ----------------------------------------------- |
    | `file` | **Так**     | Файл сервера `.json` у форматі Discord, до 5 МБ |

    Vetox перевіряє файл, перетворює його на копію й відповідає її ID. Відновлюйте чи переглядайте її, як будь-яку іншу.

    <Warning>
      Файл, який не відповідає формату сервера Discord, відхиляється повністю, і у відмові названо перше поле, яке не пройшло перевірку. Vetox ніколи не застосовує такий файл наполовину.
    </Warning>

    <Info>
      Імпорт потребує **Basic** або вище.
    </Info>
  </Accordion>
</AccordionGroup>

## Видалення

<AccordionGroup>
  <Accordion title="/backup delete — видалити одну копію" icon="trash">
    | Опція       | Обов'язково | Примітки         |
    | ----------- | ----------- | ---------------- |
    | `backup_id` | **Так**     | Автодоповнюється |

    Спершу просить **Підтвердити**. Видалення прибирає знімок і всі збережені з ним файли — негайно й назавжди.
  </Accordion>

  <Accordion title="/backup purge — видалити всі копії" icon="dumpster-fire">
    Без опцій. Просить **Підтвердити**, а потім видаляє **кожну** копію цього сервера разом із їхніми збереженими файлами.

    <Warning>
      Скасувати це неможливо, і кошика немає. Спершу експортуйте все, що хочете зберегти.
    </Warning>
  </Accordion>
</AccordionGroup>

<Note>
  `/backup delete` і `/backup purge` — руйнівні дії за [рівнем прав](/uk/server-management/server-backup#права) сервера, тож за стандартного рівня вони доступні тільки власникові.
</Note>

## Приклади

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

## Коли команду відхилено

Vetox завжди називає причину. Найпоширеніші:

| У відповіді написано                                                          | Що робити                                                                                                                                                |
| ----------------------------------------------------------------------------- | -------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Копію тут створювали нещодавно                                                | Перечекайте 10-хвилинний кулдаун на створення, що діє на сервер                                                                                          |
| На сервері вже виконується інше завдання копіювання                           | Дочекайтеся його або виконайте `/backup cancel`                                                                                                          |
| Сьогоднішній ліміт відновлень і відкатів вичерпано                            | Цей сервер або ваш акаунт витратив добову норму: 10 на сервер / 20 на людину. Спробуйте завтра                                                           |
| Ви досягли ліміту копій свого тарифу                                          | Видаліть одну або підвищте тариф                                                                                                                         |
| Ця копія виходить за ліміт вашого тарифу                                      | Її заблоковано пониженням тарифу. Видаліть новішу копію або підвищте тариф                                                                               |
| Це можуть робити лише ті, кому дозволяють права резервного копіювання сервера | Рівень прав сервера лишає це власникові. Діє власник або він змінює рівень у Налаштуваннях → Права                                                       |
| Цей інтервал коротший, ніж дозволяє ваш тариф                                 | Візьміть мінімум, названий у повідомленні, або підвищте тариф                                                                                            |
| Одна з обраних опцій недійсна                                                 | Невідомий токен `options` — звірте його з граматикою вище                                                                                                |
| Vetox бракує прав, які йому потрібні                                          | Надайте Vetox Administrator і підніміть його роль вище за ролі, які відновлюються                                                                        |
| Discord дозволяє боту створити лише 250 ролей або 500 каналів за 48 годин     | Власний ліміт створення Discord. `/backup status` показує, коли він спаде; зачекайте й продовжте або завантажте ще раз із `options:!delete-roles !roles` |
| Цей файл не є дійсним експортом сервера Discord                               | Файл імпорту не відповідає формату Discord                                                                                                               |
| Резервна копія сервера тимчасово недоступна                                   | Призупинено на технічне обслуговування. Ваші копії недоторкані                                                                                           |

## Пов'язане

<CardGroup cols={2}>
  <Card title="Резервна копія сервера" icon="server" href="/uk/server-management/server-backup">
    Уся функція — відновлення, розклади, відстеження змін і Time Machine.
  </Card>

  <Card title="Мої резервні копії" icon="box-archive" href="/uk/members/my-backups">
    Ваші копії з усіх серверів.
  </Card>

  <Card title="Керування командами" icon="sliders" href="/uk/server-management/command-management">
    Вимкніть або обмежте кожну підкоманду окремо.
  </Card>

  <Card title="Довідник команд" icon="terminal" href="/uk/commands/overview">
    Як працюють права й кулдауни в усіх командах.
  </Card>
</CardGroup>
