Команды резервного копирования

/backup управляет Резервной копией сервера прямо из Discord. Одна команда, тринадцать подкоманд.

Требование	Значение
Вам нужно	Manage Server
Vetox нужно	View Channel, Read Message History — и больше для восстановления
Кулдаун	5 с
Где	Только на серверах. Недоступно в личных сообщениях

Каждый ответ /backup виден только вам. ID резервной копии — это ключ к содержимому вашего сервера, поэтому Vetox никогда не публикует его там, где его смогут прочитать другие участники.

Каждую подкоманду можно по отдельности отключить или ограничить конкретными ролями и каналами — через Управление командами. /backup create может быть открыта вашим администраторам, пока /backup load выключена полностью.

Создание и просмотр

/backup create — создать копию

Опция	Обязательно	Примечания
`name`	Нет	До 64 символов. По названию копию проще найти
`messages`	Нет	0–250, с ограничением максимумом вашего тарифа

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

Одна ручная копия на сервер раз в 10 минут и только одна задача копирования или восстановления одновременно. Для создания нужно право Administrator, а на уровне прав доступа Только владелец — оно доступно лишь владельцу.

/backup list — посмотреть свои копии

Опция	Обязательно	Примечания
`page`	Нет	От 1. Двадцать строк на страницу
`scope`	Нет	Этот сервер (по умолчанию), Копии каналов этого сервера или Мои копии со всех серверов

Новые сверху. Автоматические и страховочные копии помечены, чтобы их можно было отличить с первого взгляда. scope:mine перечисляет все созданные вами копии на любом сервере вместе с сервером, откуда они, — так находят ID копии, сделанной в другом месте, прежде чем загрузить её сюда.

/backup info — что содержит копия

Опция	Обязательно	Примечания
`backup_id`	Да	Автодополняется по мере ввода

Количества, параметры копирования, размер, самые активные каналы, предупреждения, то, заблокирована ли копия вашим тарифом, и ссылка на копию в Просмотре снимка в панели управления — там можно прочитать каждый канал, роль, настройку, бан и участника, которые в ней есть.

backup_id автодополняется в каждой подкоманде, которая его принимает, поэтому копировать ID вручную не нужно. Предлагаются только те копии, которыми вам разрешено пользоваться.

Восстановление

/backup load — восстановить копию

Опция	Обязательно	Примечания
`backup_id`	Да	Автодополняется, включая ваши собственные копии с других серверов
`messages`	Нет	0–250, с ограничением максимумом вашего тарифа
`options`	Нет	До 200 символов. См. грамматику ниже

При первом нажатии ничего не восстанавливается. Vetox отвечает планом — сколько каналов и ролей будет удалено и создано и есть ли роли выше собственной роли Vetox, которые поэтому нельзя тронуть, — с кнопками Подтвердить и Отмена, которые истекают через 60 секунд. Только после подтверждения Vetox делает страховочную копию и запускает восстановление.

Загрузка резервной копии заменяет каналы и роли этого сервера. Участников никогда не исключают, но всё созданное после создания копии будет потеряно.

/backup load подчиняется уровню прав доступа сервера. На уровне по умолчанию Администраторы не могут выполнять разрушительные действия всем, кроме владельца, будет отказано — даже с правом Administrator.

Восстановления и откаты нормируются посуточно — 10 на сервер, 20 на человека. /backup load, /backup channel load и откат отслеженного изменения расходуют оба лимита; продолжение прерванного восстановления — нет.

/backup cancel — остановить текущую задачу

Без опций. Отменяет активное копирование или восстановление на этом сервере. Контрольная точка сохраняется, поэтому отменённое восстановление всё ещё можно продолжить из панели управления.

/backup status — что выполняется и какой лимит действует

Без опций. Показывает задачу, которая выполняется на этом сервере (вид, этап, прогресс, предупреждения, время запуска), — или что ничего не выполняется; когда будет возможна следующая ручная копия, если действует 10-минутный кулдаун; когда снимется лимит Discord на создание, если восстановление в него упёрлось; а когда ничего не выполняется — почему остановилась последняя задача и можно ли продолжить её из панели управления.

Грамматика `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`	Значение по умолчанию, сделанное добавляющим

Порядок важен. * !members включает всё, а затем выключает участников. !members * выключает участников, а затем снова включает всё, включая участников. Читайте свой список токенов слева направо.

Токены никогда не расширяют то, что позволяет ваш тариф, — ограничение тарифа применяется последним. Неизвестный токен не игнорируется, а отклоняется с указанием его имени, поэтому опечатка никогда не пропадает молча.

Расписание

/backup interval — автоматические копии

Опция	Обязательно	Примечания
`mode`	Да	`on`, `off` или `status`
`interval`	Нет	4 часа, 8 часов, 12 часов, 24 часа, 2 дня, 3 дня, 1 неделя
`messages`	Нет	0–250, с ограничением максимумом вашего тарифа

status сообщает текущее расписание, ничего не меняя: интервал, сколько копий хранится, последний и следующий запуск и ID самой свежей автоматической копии. При включении расписания вам сообщат, когда выполнится первая копия.

Интервал короче, чем позволяет ваш тариф, будет отклонён, а в отказе назван минимум вашего тарифа в часах. Автоматические копии ротируются: самые старые сверх количества, которое хранит ваш тариф, удаляются по мере появления новых.

Копии каналов

/backup channel create — создать копию одного канала

Опция	Обязательно	Примечания
`channel`	Нет	Текстовый, объявлений или ветка. По умолчанию — текущий канал
`messages`	Нет	0–1000, с ограничением максимумом вашего тарифа
`before`	Нет	ID сообщения. Сохраняет сообщения до него

before — способ уйти в прошлое дальше, чем позволяет один запуск: создайте копию канала, а затем вторую, указав в before ID самого старого сообщения, до которого дошла первая.

/backup channel load — опубликовать их в канал

Опция	Обязательно	Примечания
`backup_id`	Да	Автодополняет только копии каналов
`channel`	Нет	Куда публиковать. По умолчанию — текущий канал
`messages`	Нет	0–1000, с ограничением максимумом вашего тарифа

Сообщения публикуются от старых к новым, вместе с закреплениями.

Ничего не удаляется. Сохранённые сообщения добавляются к тому, что уже есть в канале. Большая копия канала публикуется долго — ответ сообщает о прогрессе по ходу дела.

Копии каналов требуют Basic или выше.

Перенос копий

/backup export — скачать в JSON

Опция	Обязательно	Примечания
`backup_id`	Да	Автодополняется

Отправляет копию файлом .json в формате Discord, прикреплённым к ответу, который видите только вы. Свыше 8 МБ вместо файла приходит ссылка на панель управления.

В экспорт входят сервер, роли, каналы, эмодзи и стикеры. Сообщения, участники и баны не включаются — чтобы перенести их, восстановите копию. Экспорт работает на любом тарифе.

/backup import — собрать копию из файла

Опция	Обязательно	Примечания
`file`	Да	Файл сервера `.json` в формате Discord, до 5 МБ

Vetox проверяет файл, превращает его в резервную копию и отвечает её ID. Восстанавливайте и изучайте её, как любую другую.

Файл, который не соответствует формату сервера Discord, отклоняется целиком с указанием первого поля, не прошедшего проверку. Vetox никогда не применяет файл наполовину.

Импорт требует Basic или выше.

Удаление

/backup delete — удалить одну копию

Опция	Обязательно	Примечания
`backup_id`	Да	Автодополняется

Сначала просит Подтвердить. Удаление стирает снимок и все сохранённые с ним файлы — немедленно и безвозвратно.

/backup purge — удалить все копии

Без опций. Просит Подтвердить, а затем удаляет все копии этого сервера вместе с сохранёнными в них файлами.

Отмены нет, корзины тоже. Сначала экспортируйте всё, что хотите сохранить.

/backup delete и /backup purge — это разрушительные действия в рамках уровня прав доступа сервера, поэтому на уровне по умолчанию они доступны лишь владельцу.

Примеры

/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
Резервное копирование сервера временно недоступно	Приостановлено на время обслуживания. Ваши копии не затронуты

Связанное

Резервная копия сервера

Функция целиком — восстановление, расписания, отслеживание изменений и Машина времени.

Мои резервные копии

Ваши копии со всех серверов.

Управление командами

Отключайте или ограничивайте каждую подкоманду по отдельности.

Справочник команд

Как работают права и кулдауны во всех командах.

​Создание и просмотр

​Восстановление

​Грамматика options

​Расписание

​Копии каналов

​Перенос копий

​Удаление

​Примеры

​Когда команда отклонена

​Связанное

Резервная копия сервера

Мои резервные копии

Управление командами

Справочник команд

Создание и просмотр

Восстановление

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

Расписание

Копии каналов

Перенос копий

Удаление

Примеры

Когда команда отклонена

Связанное