Перейти к содержимому

Как это работает

Коды ошибок API

Все коды ошибок, которыми может ответить API панели, HTTP-статус каждого и его значение: биллинг ветвится по коду, а не разбирает текст.

Отклонённый запрос получает в ответ документ проблемы (RFC 7807), и читать в нём нужно поле code. Оно стабильно и никогда не переводится: вызывающая сторона ветвится по нему. Поля title и detail содержат ту же ошибку в виде фразы на языке вызывающего (английский, русский или армянский, по Accept-Language), а correlationId указывает запрос в журнале сервера.

json
{
  "type": "https://httpstatuses.io/400",
  "title": "У сайта не может быть больше дополнительных имён, чем покрывает один сертификат.",
  "status": 400,
  "detail": "У сайта не может быть больше дополнительных имён, чем покрывает один сертификат.",
  "code": "SiteAliasLimitExceeded",
  "correlationId": "0HN7…"
}

Статус определяется видом ошибки

У каждого кода один вид, заданный там, где код объявлен, и HTTP-статус берётся только из вида и никогда не угадывается по написанию кода.

HTTPВидЧто это значит для вызывающего
400ПроверкаЗапрос можно было отправить иначе. Исправьте его, прежде чем повторять.
401Не авторизованВход не выполнен или учётные данные больше не действуют.
403ЗапрещеноОтказ по причине, которая ничего не раскрывает о других.
404Не найденоОбъекта нет, или его нет для этого вызывающего.
409КонфликтЗапрос корректен, но противоречит уже существующему.
429Ограничение частотыСлишком много попыток; подождите и повторите.
500СбойСервер не справился с тем, на что вызывающий не мог повлиять.
502Отказ внешней стороныВнешняя сторона ответила отказом: центр сертификации, почтовый сервер, зеркало пакетов.
503НедоступноЧто-то недоступно или не может взять работу сейчас; стоит повторить позже.

Ресурс другого аккаунта отвечает 404, а не 403, как описано на странице API.

Коды, которые стоит знать в первую очередь

  • RequestParameterInvalid (400). Значение, которое панель вообще не может прочитать: ?page=abc, ?pageSize=x, ?status=7 для несуществующего статуса. Фраза называет параметр. Параметр со своим кодом сохраняет его: слишком длинный текст поиска даёт ListSearchTooLong, неизвестная сортировка даёт ListSortUnknown.
  • AgentPackageSourceRefused (502) и AgentPackageSourceUnreachable (503). Установка версии PHP не удалась, потому что зеркало пакетов отказало в загрузке или было недоступно. С самим сервером всё в порядке; повторите позже. Сбой на самом сервере остаётся AgentSystemFailure (500).
  • AgentBelowFreeSpaceFloor (503). Свободного места на сервере меньше порога, поэтому создание аккаунта, создание или восстановление резервной копии или приём загрузки отклонены до того, как что-либо записано. Порог и его настройка описаны на странице восстановления.
  • Сертификат панели: PanelHostNameNotConfigured (409), PanelCertificateNotIssued (404), PanelChallengeWriteFailed (500). Для заказа доверенного сертификата на адрес самой панели нужен Panel__HostName; если выпуск не удался, панель сохраняет сертификат, который уже обслуживала. Ответы самого центра сертификации приходят кодами Acme… в разделе сертификатов ниже, а заказ описан в разделе Сертификат панели.
  • SiteAliasLimitExceeded (400). Больше 99 псевдонимов у одного сайта; см. сайты.
  • CurrentPasswordIncorrect (400). Неверный текущий пароль при смене собственного; см. восстановление.

Неудачная фоновая задача несёт те же коды

Работа, выполняемая как фоновая задача (резервная копия, восстановление, установка PHP, заказ сертификата), завершается неудачей не HTTP-ответом, а самой задачей. GET /api/v1/tasks, GET /api/v1/tasks/running, GET /api/v1/tasks/{id} и каждый кадр GET /api/v1/tasks/{id}/stream передают причину в поле failure, которое равно null у задачи без ошибки:

json
"failure": {
  "code": "AgentBelowFreeSpaceFloor",
  "message": "На сервере почти закончилось место на диске, поэтому операция не начата и ничего не изменено. Освободите место на сервере и повторите попытку."
}

Код всегда один из перечисленных ниже. Сообщение получается при каждом чтении задачи, на языке читающего, поэтому это та же фраза, что и в ответе с ошибкой. Код, который не описывает ни один установленный модуль, читается фразой TaskFailureUnexplained, а исходный код остаётся в code.

Все коды

294 кода, взятых из определений ошибок в исходном коде панели: таблица ErrorMessages каждого модуля, агента сервера и коды значений запроса. В столбце «Значение» стоит фраза, которую отправляет API. AccountNotFound и SiteNotFound используются несколькими модулями и указаны у каждого. В RequestParameterInvalid «…» обозначает имя параметра. 20 кодов для реселлеров, предложений членства, повторной отправки приглашения, пропуска итоговой резервной копии и проверки резервной копии нет в 1.0.0-beta.4: они появятся в следующем выпуске.

  1. задача: никогда не бывает HTTP-ответом. Код появляется только в failure.code фоновой задачи.
  2. нет: описан в сообщениях панели, но сейчас ни один путь кода его не выдаёт.
  3. поток лога: последний кадр живого потока лога, а не HTTP-ответ.

Значения запроса

КодHTTPЗначение
ListPageOutOfRange400Номер страницы должен быть не меньше 1.
ListPageSizeNotOffered400Размер страницы может быть только 10, 25, 50 или 100.
ListSearchInvalid400Текст поиска содержит недопустимые символы.
ListSearchTooLong400Текст поиска может содержать не более 100 символов.
ListSortUnknown400Этот список нельзя отсортировать таким образом.
RequestParameterInvalid400Значение параметра «…» не удаётся прочитать.

Сама панель

КодHTTPЗначение
HostForbidden403У вас нет доступа к этой странице.
HostRateLimited429За короткое время отправлено слишком много запросов. Подождите время, указанное в заголовке Retry-After, и повторите попытку.
HostTwoFactorSetupRequired403Сначала завершите настройку двухфакторной аутентификации.
HostUnexpectedError500Что-то пошло не так, и запрос не удалось выполнить. Повторите попытку. Если ошибка повторяется, обратитесь в поддержку и сообщите идентификатор запроса, показанный рядом с этим сообщением: именно по нему поддержка найдёт ваш запрос.
HostViewAsNotAllowed403Это действие недоступно, пока вы просматриваете панель от имени этой учётной записи.
HostValidationFailed400Некоторые из введённых данных некорректны.

Агент сервера

КодHTTPЗначение
AgentAccountSuspended409Аккаунт приостановлен, поэтому операция отклонена и ничего не запущено. Возобновите аккаунт и повторите попытку.
AgentAlreadyExists409Это уже существует на вашем сервере, поэтому повторно ничего не создано.
AgentBelowFreeSpaceFloor503На сервере почти закончилось место на диске, поэтому операция не начата и ничего не изменено. Освободите место на сервере и повторите попытку.
AgentCertificateUnreadable400Не удалось прочитать сертификат. Проверьте, что вставлен весь сертификат, включая строки BEGIN и END.
AgentFirewallPortsMisconfigured500Брандмауэр не изменён: панель не знает, какие порты должны оставаться открытыми на вашем сервере. Ничего не изменено. Обратитесь в поддержку.
AgentIncompatible503Версии панели и службы, управляющей вашим сервером, не совпадают, поэтому запрос не выполнен. Возможно, обновление ещё не завершено; повторите попытку позже, а если ошибка повторяется, обратитесь в поддержку.
AgentInvalidInput400Некоторые из указанных данных не приняты. Проверьте их и повторите попытку.
AgentInvalidResponse500Ваш сервер не вернул понятного ответа. Повторите попытку через несколько минут, а если ошибка повторяется, обратитесь в поддержку.
AgentLimitReached409Лимит вашего тарифа на элементы этого типа уже исчерпан, поэтому ничего не создано. Удалите ненужный элемент или перейдите на более крупный тариф, затем повторите попытку.
AgentNotFound404Этого больше нет на вашем сервере. Обновите страницу, чтобы увидеть текущее состояние.
AgentNotImplemented503Ваш сервер пока не поддерживает эту возможность, поэтому ничего не выполнено. Выберите другой вариант или обратитесь в поддержку, чтобы узнать, когда она появится.
AgentPackageSourceRefused502Репозиторий пакетов, из которого устанавливает ваш сервер, отказал в загрузке, поэтому ничего не установлено. Проблема на стороне репозитория, а не вашего сервера; повторите попытку позже, а если ошибка повторяется, обратитесь в поддержку.
AgentPackageSourceUnreachable503Не удалось связаться ни с одним репозиторием пакетов, из которых устанавливает ваш сервер, поэтому ничего не установлено. Обычно это временная проблема сети; повторите попытку через несколько минут, а если ошибка повторяется, обратитесь в поддержку.
AgentPrivateKeyMismatch400Закрытый ключ не соответствует этому сертификату. Вставьте ключ, созданный вместе с запросом на сертификат.
AgentPrivateKeyUnreadable400Не удалось прочитать закрытый ключ. Проверьте, что вставлен весь ключ, включая строки BEGIN и END, и что он не защищён паролем.
AgentRunNotStopped500Серверу не удалось подтвердить, что операция остановлена, поэтому она может всё ещё выполняться. Проверьте её состояние, прежде чем повторять попытку.
AgentSaturated503Сервер уже выполняет максимально допустимое число таких операций, поэтому ничего не запущено. Подождите, пока одна из них завершится, и повторите попытку.
AgentSystemFailure500Эту операцию не удалось выполнить на вашем сервере, изменения не внесены. Повторите попытку через несколько минут, а если ошибка повторяется, обратитесь в поддержку.
AgentUnavailable503Ваш сервер сейчас не отвечает, поэтому выполнение запроса не подтверждено. Повторите попытку через минуту, а если ошибка повторяется, обратитесь в поддержку.
AgentUnspecified500Не удалось выполнить эту операцию на вашем сервере. Повторите попытку через несколько минут, а если ошибка повторяется, обратитесь в поддержку.
AgentValidationFailed400Ваш сервер счёл указанные данные некорректными. Исправьте их и повторите попытку.

Хостинг-аккаунты

КодHTTPЗначение
AccountCleanupFailed500Аккаунт не удалён: не удалось сначала удалить принадлежащие ему объекты. Ничего не изменено, попробуйте ещё раз.
AccountDomainTaken409Этот домен уже используется другим аккаунтом.
AccountDomainWwwPrefix400Укажите основной домен без «www.», например example.com.
AccountFeatureNotGranted403Вам не предоставлен доступ к этой возможности. Обратитесь к владельцу аккаунта.
AccountFinalBackupSkipForbidden403Реселлер не может пропустить итоговую резервную копию при удалении аккаунта. Обратитесь к администратору или дождитесь копии.
AccountHomeGroupRepairCountInvalid400Число исправляемых каталогов не может быть отрицательным. Прочитайте отчёт снова и подтвердите указанное в нём число.
AccountHomeGroupRepairPlanChanged409Домашние каталоги на сервере больше не совпадают с прочитанным вами отчётом, поэтому ничего не исправлено и ничего не изменено. Получите новый отчёт и подтвердите его числа, прежде чем исправлять.
AccountLoginIssuanceFailed500Аккаунт создан, но не удалось выдать логин его владельцу. Не создавайте аккаунт заново, отправьте приглашение повторно.
AccountNameInvalid400Недопустимое имя аккаунта. Используйте от 3 до 30 строчных латинских букв, цифр или знаков подчёркивания, начиная с буквы.
AccountNameReserved400Это имя аккаунта зарезервировано системой и не может быть использовано. Выберите другое имя.
AccountNameTaken409Это имя аккаунта уже занято.
AccountNotFound404Аккаунт не найден.
AccountOwnerLanguageUnsupported400Выберите язык владельца из списка: английский, русский или армянский.
AccountPlanQuotaBelowUsage409Тариф не изменён: этот аккаунт уже использует больше диска, чем позволяет квота нового тарифа, и после перевода он не сможет записывать файлы. Выберите тариф с большей квотой или сначала освободите место в аккаунте.
AccountResumptionFailed500Аккаунт не возобновлён: не удалось снова запустить то, что он выполняет. Ничего не изменено, попробуйте ещё раз.
AccountResumptionNotObserved500Аккаунт не возобновлён: не удалось убедиться, что сервер действительно его снова запустил. Ничего не изменено, попробуйте ещё раз.
AccountStatusUnknown400Неизвестный статус аккаунта. Используйте active или suspended.
AccountSuspensionFailed500Аккаунт не приостановлен: не удалось сначала остановить то, что он выполняет. Ничего не изменено, попробуйте ещё раз.
AccountSuspensionNotObserved500Аккаунт не приостановлен: не удалось убедиться, что сервер действительно его остановил. Ничего не изменено, попробуйте ещё раз.
PlanFeatureNotIncluded403Эта возможность не входит в ваш тарифный план.
PlanFeatureUnknown400Возможность тарифного плана должна быть одной из перечисленных в панели.
PlanInUse409Тариф не удалён: на нём ещё есть аккаунты. Сначала переведите эти аккаунты на другой тариф или удалите их.
PlanNameTaken409Тариф с таким названием уже существует.
PlanNotFound404Тарифный план не найден.
PlanOwnerMismatch409Тариф и аккаунт принадлежат разным владельцам. Аккаунт может использовать только тариф своего реселлера, а аккаунт администратора, только тариф администратора.
PlanQuotaBelowUsage409Тариф не изменён: один из аккаунтов на нём уже использует больше диска, чем позволяет новая квота, и после её снижения этот аккаунт не сможет записывать файлы. Увеличьте квоту либо сначала освободите место или переведите этот аккаунт на другой тариф.
ResellerAccountLimitReached409Реселлер достиг количества аккаунтов, которое ему выделено. Попросите администратора увеличить лимит.
ResellerDiskPoolExceeded409Это превысит дисковое пространство, выделенное реселлеру. Выберите тариф меньшего объёма или попросите администратора увеличить пул диска.
ResellerEnvelopeInvalid400Лимиты реселлера недопустимы. Каждое значение должно быть неотрицательным и не превышать допустимого предела, а лимиты ресурсов, положительными.
ResellerHasAccounts409Реселлер не удалён: у него ещё есть аккаунты или тарифы. Сначала удалите их.
ResellerLoginIssuanceFailed500Реселлер создан, но не удалось выдать ему логин. Удалите реселлера и создайте заново, когда причина из журнала сервера будет устранена.
ResellerNameInvalid400Недопустимое имя реселлера. Используйте от 3 до 30 строчных латинских букв, цифр или подчёркиваний, начиная с буквы. Это же имя реселлер использует для входа.
ResellerNameTaken409Это имя уже занято другим реселлером или аккаунтом.
ResellerNotFound404Реселлер не найден.
ResellerPlanExceedsEnvelope400Тариф выходит за рамки того, что выделено реселлеру: одно из значений выше предела или функция не входит в набор. Уменьшите значения или уберите функцию.
ResellerPlanLimitReached409Реселлер достиг количества тарифов, которое ему выделено. Удалите тариф или попросите администратора увеличить лимит.
ResellerSuspended409Реселлер приостановлен и не может вносить изменения. Сначала администратор должен его возобновить.

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

КодHTTPЗначение
AccountBackupOperationRunning409На вашем сервере ещё выполняется другая операция резервного копирования или восстановления для этого аккаунта. Ничего не изменено. Повторите попытку, когда она завершится.
AccountNotFound404Аккаунт не найден.
BackupArtifactUnvouchedзадача¹Панель перестала следить за этой резервной копией до того, как сервер сообщил результат. Копия ЕСТЬ на сервере, но панель не записала её контрольную сумму, поэтому не может её проверить и не предлагает для восстановления. Копия помечена как неудачная и не удалена. Обратитесь в поддержку, чтобы освободить место, или создайте новую резервную копию.
BackupCancelledзадача¹Создание резервной копии было отменено до завершения.
BackupDateRangeInverted400Начало периода не может быть позже его конца.
BackupDestinationKindUnknown400Это не тип места хранения резервных копий.
BackupDestinationLocalAlreadyDefined409На сервере уже есть локальное место хранения резервных копий, и оно может быть только одно.
BackupDestinationNameInvalid400Имя места хранения резервных копий обязательно и не длиннее 64 символов.
BackupDestinationNotConfigured409На сервере нет места хранения резервных копий по умолчанию, поэтому резервное копирование невозможно до следующего запуска.
BackupDestinationNotFound404Такого места хранения резервных копий не существует.
BackupDestinationRemoteUnsupported400Эта сборка хранит резервные копии только на этом сервере. Хранилище, совместимое с S3, недоступно.
BackupInvalidOutcomeзадача¹Агент сервера сообщил о готовой копии, но не указал, чем её опознать.
BackupKindUnknown400Это не тип резервной копии.
BackupNotFound404Резервная копия не найдена.
BackupNotRestorable409Эту резервную копию нельзя восстановить: она не была создана успешно.
BackupNotVerifiable409Эту резервную копию нельзя проверить: она не была создана успешно.
BackupOutcomeUnobservedзадача¹Панель перестала следить за созданием этой копии до того, как сервер сообщил результат, поэтому неизвестно, была ли копия завершена. Копия помечена как неудачная и не предлагается для восстановления. Создайте новую копию, а если это повторяется, обратитесь в поддержку.
BackupScheduleDayNotAllowed400Для ежедневного расписания день недели не указывается.
BackupScheduleDayRequired400Для еженедельного расписания нужно указать день недели.
BackupScheduleHourOutOfRange400Час должен быть от 0 до 23.
BackupScheduleRetainOutOfRange400Количество хранимых копий должно быть от 1 до 365.
BackupScheduledRunAbortedзадача¹Запланированное копирование прервалось до того, как агент сообщил результат.
BackupStatusUnknown400Это не статус резервной копии.
BackupStillRunning409Резервная копия ещё создаётся и пока не может быть удалена.
BackupStreamDroppedзадача¹Связь с агентом сервера была потеряна во время создания резервной копии.
BackupStreamIdleзадача¹Агент сервера перестал сообщать о ходе создания резервной копии.
BackupTruncatedзадача¹Агент сервера завершил работу, не сообщив, чем закончилось создание копии.
BackupVerificationArtifactMissing404Сохранённый архив не найден.
BackupVerificationFailed400Сохранённый архив больше не совпадает с записью о нём.
FinalBackupFailed500Аккаунт не был удалён: не удалось создать его финальную резервную копию.
RestoreArtifactRejected400Ваш сервер отклонил эту копию: её содержимое не соответствует тому, что панель записала при её создании. Ничего не восстановлено, аккаунт не изменён. Восстановите из другой копии или обратитесь в поддержку: повторная отправка того же запроса ничего не изменит.
RestoreCancelled500Восстановление было отменено до завершения.
RestoreConfirmationMismatch409Введённое имя не совпадает с именем пользователя этого аккаунта.
RestoreConfirmationRequired400Введите имя пользователя аккаунта в точности, чтобы подтвердить восстановление.
RestoreInvalidOutcome500Агент сервера сообщил о завершении восстановления, не указав, что было восстановлено.
RestoreOutcomeUnobservedзадача¹Панель перестала следить за этим восстановлением до того, как сервер сообщил результат, поэтому неизвестно, насколько оно продвинулось. Данные аккаунта могли быть уже заменены: проверьте файлы и базы данных, прежде чем запускать восстановление снова, а если сомневаетесь, обратитесь в поддержку.
RestorePartial500Восстановление выполнено не полностью; аккаунт восстановлен лишь частично.
RestoreStreamDropped503Связь с агентом сервера была потеряна во время восстановления аккаунта.
RestoreStreamIdle503Агент сервера перестал сообщать о ходе восстановления аккаунта.
RestoreTruncated500Агент сервера остановился, не сообщив, что именно было восстановлено.

Задания по расписанию

КодHTTPЗначение
AccountNotFound404Аккаунт не найден.
CronCommandInvalid400Некорректная команда. Она должна быть одной строкой длиной не более 4096 байт.
CronEntryAlreadyExists409Такая задача с этим расписанием и командой уже существует.
CronEntryIdInvalid400Некорректный идентификатор запланированной задачи.
CronEntryLimitReached409Ваш тариф не позволяет создать больше запланированных задач.
CronEntryLimitReachedConcurrently409Лимит запланированных задач вашего тарифа был исчерпан другим запросом, сделанным в тот же момент, поэтому эта задача не создана. Введённые вами данные верны. Удалите ненужную запланированную задачу или перейдите на более крупный тариф, затем повторите попытку.
CronEntryNotFound404Запланированная задача не найдена.
CronEntrySuspended409Аккаунт приостановлен, поэтому запланированная задача не запущена. Возобновите аккаунт и повторите попытку.
CronEnvironmentDuplicateName400Одно и то же имя переменной передано дважды.
CronEnvironmentInvalid400Не удалось прочитать переданные переменные окружения.
CronEnvironmentNameInvalid400Имя переменной может содержать только заглавные латинские буквы, цифры и подчёркивания и не может начинаться с цифры.
CronEnvironmentNameReserved400MAILTO и SHELL управляются сервером и не могут быть заданы здесь.
CronEnvironmentTooManyVariables400Передано слишком много переменных окружения.
CronEnvironmentValueInvalid400Значение переменной не может содержать знак процента, управляющие символы, пробелы по краям или обрамляющие кавычки.
CronOperationFailed500Не удалось изменить запланированную задачу. Ничего не изменено, попробуйте ещё раз.
CronRunAccountLimitReached409Сейчас выполняется слишком много запланированных задач вашего аккаунта. Дождитесь завершения одной из них и повторите попытку.
CronRunAgentSaturated503Планировщик сервера уже выполняет максимально допустимое число задач, поэтому эта задача не запущена. Ничего не изменено; дождитесь завершения одной из них и повторите попытку.
CronRunNotFound404Этот запуск не найден.
CronRunNotStopped500Эта запланированная задача была запущена вручную, но серверу не удалось подтвердить, что она остановлена, поэтому она может всё ещё выполняться. Проверьте её состояние, прежде чем запускать снова: повторный запуск начнётся рядом с первым.
CronRunOutcomeUnknown400Этот результат запуска панели неизвестен.
CronRunServerBusy503Сервер сейчас выполняет много запланированных задач, поэтому эта задача не запущена. Ничего не изменено; повторите попытку чуть позже.
CronScheduleInvalid400Некорректное расписание. Используйте пять полей cron, например 0 3 * * 1.

Ручной запуск задачи ограничен, чтобы один аккаунт не занял все рабочие потоки сервера. Оператор может изменить два лимита в /etc/maran/panel.env: Cron__Runs__MaxConcurrentPerAccount (по умолчанию 2, на аккаунт) и Cron__Runs__MaxConcurrentGlobal (по умолчанию 16, на все аккаунты вместе); это целые числа не меньше 1, при любом другом значении панель не запускается. Код CronRunAccountLimitReached возвращается, когда исчерпан лимит самого аккаунта, а CronRunServerBusy - когда занят весь сервер; во втором случае имеет смысл повторить попытку. Если запуск дошёл до предела вывода, его задание останавливается, и запуск сообщается как остановленный только после подтверждения сервера. Если подтверждения нет, ответом будет CronRunNotStopped (500), а задание может продолжать работать до предельного времени работы на сервере, поэтому проверьте вывод записи, прежде чем запускать её снова. Каждый запуск попадает в журнал аудита, в том числе если браузер отключился, пока задача ещё выполнялась.

Базы данных

КодHTTPЗначение
AccountNotFound404Аккаунт не найден.
DatabaseGrantRepairCountInvalid400Число исправляемых прав не может быть отрицательным. Прочитайте отчёт снова и подтвердите указанное в нём число.
DatabaseGrantRepairPlanChanged409Права на сервере больше не совпадают с прочитанным вами отчётом, поэтому ничего не исправлено и ничего не изменено. Получите новый отчёт и подтвердите его числа, прежде чем исправлять.
DatabaseLimitReached409Ваш тариф не позволяет создать больше баз данных.
DatabaseLimitReachedConcurrently409Лимит баз данных вашего тарифа был исчерпан другим запросом, сделанным в тот же момент, поэтому эта база данных не создана и пароль не выдан. Введённые вами данные верны. Удалите ненужную базу данных или перейдите на более крупный тариф, затем повторите попытку.
DatabaseNameInvalidFormat400Имя базы данных может содержать только строчные латинские буквы и цифры.
DatabaseNameTaken409У вас уже есть база данных с таким именем.
DatabaseNameTooLong400Это имя слишком длинное вместе с префиксом вашего аккаунта.
DatabaseNotFound404База данных не найдена.
DatabaseProvisioningFailed500Не удалось создать базу данных. Ничего не осталось на сервере, попробуйте ещё раз.
DatabaseUserNameInvalidFormat400Имя пользователя базы данных может содержать только строчные латинские буквы и цифры.
DatabaseUserNameTaken409У вас уже есть пользователь базы данных с таким именем.
DatabaseUserNameTooLong400Это имя пользователя слишком длинное вместе с префиксом вашего аккаунта.

Брандмауэр

КодHTTPЗначение
BanAddressInvalid400Это не адрес, который брандмауэр может заблокировать.
BanAddressLoopback400Адрес обратной петли заблокировать нельзя: этот узел пропускает трафик обратной петли до того, как проверяются блокировки, поэтому такая блокировка ничего не остановит. Заблокируйте адрес, с которого трафик приходит на сервер (тот, что показан для соединения, а не 127.0.0.1 или ::1).
BanDurationInvalid400Блокировка длится от одной минуты до одного года; оставьте срок пустым для постоянной блокировки.
BanNotFound404Для этого адреса нет действующей блокировки.
RulePortInvalid400Правило брандмауэра должно указывать порт от 1 до 65535.
RulePortRangeInvalid400Правило межсетевого экрана, открывающее диапазон портов, должно заканчиваться выше своего начала и укладываться в 1-65535.
RuleProtocolInvalid400Правило брандмауэра применяется к TCP или к UDP.
RuleSourceCidrInvalid400Диапазон источника указывается в нотации CIDR, без битов хоста за пределами префикса.
WhitelistCidrInvalid400Диапазон указывается в нотации CIDR, без битов хоста за пределами префикса.
WhitelistCidrTaken409Этот диапазон уже есть в белом списке.
WhitelistEntryNotFound404Запись белого списка не найдена.
WhitelistEntryProtectsCaller409Удаление этого диапазона снимет исключение с адреса, с которого вы подключены, и тогда опечатка в пароле может закрыть вам доступ к этому серверу. Добавьте исключение, которое тоже покрывает этот адрес, и удалите это после, либо удалите его, подключившись с другого адреса.

FTPS

КодHTTPЗначение
AccountNotFound404Аккаунт не найден.
FtpUserLimitReached409Ваш тариф не позволяет создать больше пользователей FTPS. Удалите ненужного или перейдите на более крупный тариф.
FtpUserLimitReachedConcurrently409Лимит пользователей FTPS вашего тарифа был исчерпан другим запросом, сделанным в тот же момент, поэтому этот пользователь не создан и пароль не выдан. Введённые вами данные верны. Удалите ненужного пользователя FTPS или перейдите на более крупный тариф, затем повторите попытку.
FtpUserNameInvalidFormat400Имя пользователя FTPS может содержать только строчные латинские буквы и цифры и не может быть пустым.
FtpUserNameTaken409Это имя пользователя FTPS уже занято. Выберите другое.
FtpUserNameTooLong400Это имя пользователя FTPS слишком длинное. К нему добавляется префикс вашего аккаунта, поэтому выберите более короткое.
FtpUserNotFound404Пользователь FTPS не найден. Обновите страницу, чтобы увидеть имеющихся пользователей FTPS.
FtpUserProvisioningFailed500Не удалось создать пользователя FTPS, пароль не выдан. Повторите попытку. Если имя окажется занято, обратитесь в поддержку: возможно, потребуется удалить оставшегося пользователя.
FtpsCertificateMissing409FTPS не запустится, пока для этого имени хоста нет TLS-сертификата. Введённые вами данные верны: выпустите или установите сертификат в разделе SSL, затем снова включите FTPS.
FtpsHostnameInvalidFormat400Это недопустимое имя хоста. Введите имя вида ftp.example.com.
FtpsHostnameNotServed400На этой панели нет сайта с таким именем хоста. Сначала добавьте сайт, затем включите для него FTPS.
FtpsHostnameReserved400Это имя нельзя использовать для FTPS-сервера.
FtpsHostnameTooLong400Это имя хоста слишком длинное. Имя хоста может содержать не более 253 символов.
FtpsPassiveAddressInvalid400Пассивный адрес должен быть адресом IPv4 в обычной записи, например 203.0.113.7: не именем хоста, не адресом IPv6, для которого в ответе PASV нет формы, и без ведущих нулей. Оставьте поле пустым, если ваш сервер не находится за NAT.

Пользователи, вход и приглашения

КодHTTPЗначение
AccountMembershipNotFound404Аккаунт не найден.
AccountMembershipSuspended409Этот аккаунт приостановлен, поэтому работать в нём нельзя, пока он не будет возобновлён.
AdminRecoveryLoginNotActive409Вход этого администратора не активен (приостановлен или ещё ждёт первого пароля), поэтому восстановить его с консоли нельзя.
AdminRecoveryNotAdministrator409Этот пользователь не администратор. С консоли можно восстановить доступ только администратору.
AdminRecoveryUserNotFound404Пользователь с таким адресом электронной почты или именем не найден.
AuditActionFilterInvalid400Такое действие журнал аудита записать не может.
AuditDateRangeInverted400Начало периода не может быть позже его конца.
AuditOutcomeUnknown400У записи аудита не может быть такого результата.
CurrentPasswordIncorrect400Текущий пароль указан неверно.
EmailInvalidFormat400Введите корректный адрес электронной почты.
EmailTaken409Этот адрес электронной почты уже зарегистрирован.
InvalidCredentialsUnauthorized401; 400, если пусто или слишком длинноНеверное имя пользователя или пароль.
InvalidTwoFactorCodeClockUnsynchronizedUnauthorized401Код неверен. Часы сервера не синхронизированы, из-за чего правильные коды могут не приниматься. Попросите администратора сервера проверить синхронизацию времени.
InvalidTwoFactorCodeUnauthorized401Код неверен. Проверьте приложение-аутентификатор и попробуйте снова.
InvitationAccountNotFound404; 400, если идентификатор пустТакой хостинг-аккаунт не найден.
InvitationAccountSuspended409Пока аккаунт приостановлен, приглашение выдать нельзя. Сначала возобновите аккаунт.
InvitationLoginNotPending409Приглашать некого: у этой учётной записи уже есть пароль.
InvitationTokenInvalid400Эта ссылка-приглашение больше недействительна. Попросите администратора отправить её снова.
MembershipOfferAccountSuspended409Аккаунт приостановлен, поэтому принять предложение сейчас нельзя.
MembershipOfferNotFound404Такого предложения нет, или оно уже недействительно.
PasswordResetEmailInvalid400Введите корректный адрес электронной почты.
PasswordResetTokenInvalid400Ссылка для сброса пароля больше недействительна. Запросите новую.
PasswordTooWeak400Выберите пароль не короче минимальной длины, заданной администратором (по умолчанию 12 символов).
PasswordTooLong400Этот пароль слишком длинный. Выберите более короткий.
PasswordSameAsUsername400Выберите пароль, отличающийся от имени пользователя.
PinnedPageAlreadyPinned409Эта страница уже закреплена.
PinnedPageKeyInvalid400Эту страницу нельзя закрепить.
PinnedPageLimitReached409Вы закрепили максимально возможное число страниц. Сначала открепите одну из них.
PinnedPageNotFound404Эта страница не закреплена.
RefreshTokenInvalidUnauthorized401Сеанс завершён. Войдите заново.
RefreshTokenReusedUnauthorized401Сеанс завершён из соображений безопасности. Войдите заново.
SecurityPolicyInvalid400Эти настройки безопасности выходят за допустимые пределы.
SessionNotFound404Сеанс не найден.
SetupAlreadyCompletedForbidden403Панель уже настроена.
SetupTokenExpiredUnauthorized401Срок действия этого токена установки истёк, поэтому администратор не создан: из соображений безопасности одноразовый токен установщика перестаёт работать через определённое время после установки панели. Введённые вами данные верны. Чтобы получить доступ к серверу, задайте новый токен установки в конфигурации окружения панели, перезапустите панель и введите здесь новый токен.
SetupTokenInvalidUnauthorized401Ссылка настройки недействительна.
SubUserFeatureInvalid400Выберите возможности из списка, который предлагает панель.
SubUserLimitReached409В вашем аккаунте уже максимально допустимое число дополнительных пользователей. Удалите одного, прежде чем приглашать следующего.
SubUserNotFound404Такого пользователя нет.
SubUserNotPending409Этот человек уже принял приглашение, поэтому отправлять его повторно не нужно.
SubUsersOwnerOnly403Управлять пользователями аккаунта может только его владелец.
TwoFactorAlreadyEnabled409Двухфакторная аутентификация уже включена.
TwoFactorNotEnabled409Двухфакторная аутентификация не включена.
TwoFactorRequiredUnauthorizedнет²Введите код из приложения-аутентификатора, чтобы завершить вход.
UserNotFound404Пользователь не найден.
UsernameInvalidFormat400Имя пользователя может содержать только буквы, цифры, точки, дефисы и подчёркивания.
UsernameTakenнет²Это имя пользователя уже занято.
ViewAsAccountNotFound404Аккаунт не найден, или у него нет входа, от имени которого можно просматривать панель.
ViewAsLoginUnavailable409Вход этого аккаунта приостановлен или заблокирован, поэтому просмотреть панель от его имени нельзя.
ViewAsNotViewing409Вы не просматриваете панель от имени аккаунта.
ViewAsResellerNotFound404Реселлер не найден, или у него нет входа, от имени которого можно просматривать панель.

Лицензия

КодHTTPЗначение
LicenceInstallExpired400Срок действия отправленной лицензии уже истёк. Ничего не было установлено, предыдущая лицензия (если она была) не изменена. Продлите лицензию и отправьте обновлённый файл.
LicenceInstallFingerprintMismatch400Отправленная лицензия была выпущена для другого сервера. Ничего не было установлено, предыдущая лицензия (если она была) не изменена. Используйте самостоятельный перенос лицензии на этот сервер либо обратитесь в поддержку, если считаете это ошибкой.
LicenceInstallMalformed400Отправленный файл лицензии имеет формат, который панель не может прочитать: возможно, он был скопирован не полностью, изменён, либо это вообще не файл лицензии. Ничего не было установлено, предыдущая лицензия (если она была) не изменена. Загрузите свежую копию лицензии и попробуйте снова, не редактируя файл.
LicenceInstallProductMismatch400Отправленный файл лицензии выпущен для другого продукта и не может быть использован здесь. Ничего не было установлено, предыдущая лицензия (если она была) не изменена. Отправьте файл лицензии, выпущенный именно для этой панели.
LicenceInstallSignatureInvalid400Подпись отправленного файла лицензии не соответствует его содержимому: файл был изменён после выпуска либо он не подлинный. Ничего не было установлено, предыдущая лицензия (если она была) не изменена. Получите свежую копию лицензии вместо ручного редактирования этой и отправьте её.
LicenceInstallTextRequired400Текст лицензии не был отправлен. Вставьте или загрузите содержимое файла лицензии.

Почта

КодHTTPЗначение
MailDeliveryFailed502Почтовый сервер отклонил сообщение.
MailRecipientInvalid400Получатель должен быть одним обычным адресом электронной почты, без отображаемого имени.
MailServerUnreachable503Почтовый сервер по указанному адресу не ответил. Проверьте хост и порт или повторите попытку позже.
SmtpAlertRecipientInvalid400Получатель оповещений должен быть одним обычным адресом электронной почты, без отображаемого имени.
SmtpFromAddressInvalid400Отправитель должен быть одним обычным адресом электронной почты, без отображаемого имени.
SmtpFromNameInvalid400Отображаемое имя отправителя должно быть одной строкой обычного текста.
SmtpHostInvalid400Имя почтового сервера обязательно и должно быть одной строкой обычного текста.
SmtpNotConfigured400Настройки исходящей почты ещё не заданы, письмо не отправлено.
SmtpPasswordInvalid400Пароль длиннее, чем принимает панель.
SmtpPortInvalid400Порт почтового сервера должен быть от 1 до 65535.
SmtpSecurityInvalid400Выберите один из предложенных способов защиты соединения.
SmtpUsernameInvalid400Имя пользователя должно быть одной строкой обычного текста.

SFTP

КодHTTPЗначение
AccountNotFound404Аккаунт не найден.
SftpUserLimitReached409Ваш тариф не позволяет создать больше пользователей SFTP.
SftpUserLimitReachedConcurrently409Лимит пользователей SFTP вашего тарифа был исчерпан другим запросом, сделанным в тот же момент, поэтому этот пользователь не создан и пароль не выдан. Введённые вами данные верны. Удалите ненужного пользователя SFTP или перейдите на более крупный тариф, затем повторите попытку.
SftpUserNameInvalidFormat400Имя пользователя SFTP может содержать только строчные латинские буквы и цифры.
SftpUserNameTaken409У вас уже есть пользователь SFTP с таким именем.
SftpUserNameTooLong400Это имя слишком длинное вместе с префиксом вашего аккаунта.
SftpUserNotFound404Пользователь SFTP не найден.
SftpUserProvisioningFailed500Не удалось создать пользователя SFTP. Ничего не осталось на сервере, попробуйте ещё раз.

Сайты

КодHTTPЗначение
AccountNotFound404Аккаунт не найден.
PhpInstallOutcomeUnobserved500Сервер не сообщил, была ли установлена эта версия PHP. Утверждать, что была, здесь не на чем, поэтому попытка считается неудачной: прежде чем повторять, проверьте менеджер пакетов на сервере. Незавершённую установку отличить от медленной отсюда невозможно.
PhpVersionInvalidFormat400Это не корректная версия PHP.
PhpVersionNotInstallable400Эту версию PHP нельзя установить на этом сервере.
PhpVersionNotInstalled400Эта версия PHP не установлена на сервере.
SiteAliasDuplicated400Одно и то же имя указано несколько раз.
SiteAliasInvalidFormat400Одно из дополнительных имён не является корректным доменным именем.
SiteAliasLimitExceeded400У сайта не может быть больше дополнительных имён, чем покрывает один сертификат.
SiteAliasReserved400Одно из дополнительных имён нельзя использовать для сайта.
SiteBackendNotPhp400Этот сайт не использует PHP, поэтому у него нет версии PHP для изменения.
SiteBackendTypeUnknown400Это не тип серверной части сайта.
SiteDomainInvalidFormat400Это не корректное доменное имя.
SiteDomainReserved400Это имя нельзя использовать для сайта.
SiteDomainTaken409Этот домен уже используется другим сайтом.
SiteLimitReached409Ваш тариф не позволяет создать больше сайтов.
SiteLimitReachedConcurrently409Лимит сайтов вашего тарифа был исчерпан другим запросом, сделанным в тот же момент, поэтому этот сайт не создан. Введённые вами данные верны. Удалите ненужный сайт или перейдите на более крупный тариф, затем повторите попытку.
SiteLogHistoryLinesInvalid400Запрошено больше строк истории, чем допустимо.
SiteLogSourceInvalid400Такого журнала у этого сайта нет.
SiteLogTailFailedпоток лога³Не удалось прочитать журнал.
SiteNotFound404Сайт не найден.
SiteProxyUpstreamInvalidFormat400Это не корректный адрес upstream.
SiteStatusUnknown400Это не статус сайта.

Сертификаты

КодHTTPЗначение
AccountNotFound404Аккаунт не найден.
AcmeAccountRejected502Центр сертификации отклонил регистрацию этого сервера.
AcmeAuthorityUnreachable503Не удалось связаться с центром сертификации. Попробуйте позже.
AcmeCertificateUnreadable502Не удалось прочитать сертификат, выпущенный центром сертификации.
AcmeChallengeTokenInvalid502Центр сертификации прислал проверочный токен, который сервер не принимает.
AcmeChallengeUnavailable503Центр сертификации не предложил проверки, которую этот сервер может пройти.
AcmeChallengeWriteFailed500Не удалось поместить проверочный файл в корневую папку сайта.
AcmeOrderRejected502Центр сертификации отклонил заказ сертификата для этого домена.
AcmeValidationFailed502Центру сертификации не удалось проверить домен. Убедитесь, что он указывает на этот сервер.
AcmeValidationTimedOut503Центр сертификации не завершил проверку домена вовремя.
CertificateAlreadyExists409Для этого домена уже выпущен сертификат.
CertificateDomainInvalidFormat400Это некорректное доменное имя.
CertificateDomainReserved400Для этого имени нельзя выпустить или установить сертификат.
CertificateNotFound404Сертификат не найден.
CertificatePemInvalid400Цепочка сертификатов не является корректным PEM: она должна содержать блок, начинающийся с -----BEGIN CERTIFICATE-----.
CertificatePemRequired400Вставьте цепочку сертификатов в формате PEM.
CertificatePemTooLarge400Цепочка сертификатов слишком велика: допускается не более 65 536 символов.
CertificateStatusUnknown400Это не статус сертификата.
PanelCertificateNotIssued404Для панели не выпущен доверенный сертификат; она работает с самоподписанным сертификатом.
PanelChallengeWriteFailed500Не удалось разместить на сервере проверочный файл для имени хоста панели.
PanelHostNameNotConfigured409Для панели не задано имя хоста, поэтому сертификат для неё заказать нельзя. Укажите Panel__HostName в /etc/maran/panel.env и перезапустите панель.
PrivateKeyPemInvalid400Закрытый ключ не является корректным PEM: он должен содержать блок, начинающийся с -----BEGIN и заканчивающийся на PRIVATE KEY-----.
PrivateKeyPemRequired400Вставьте закрытый ключ в формате PEM.
PrivateKeyPemTooLarge400Закрытый ключ слишком велик: допускается не более 65 536 символов.
SiteNotFound404Сайт не найден.

Уровень журнала

КодHTTPЗначение
LogLevelUnknown400Панель не предлагает такого уровня журнала.

Фоновые задачи

КодHTTPЗначение
TaskAbandonedByRestartзадача¹Панель перезапустилась, пока эта задача выполнялась, поэтому она не завершилась.
TaskDateRangeInverted400Начало периода не может быть позже его конца.
TaskFailureUnexplainedзадача¹Операция не завершилась, и у панели нет описания причины. Код ниже называет сбой; укажите его, обращаясь за помощью.
TaskKindFilterInvalid400Такой вид фоновой задачи панель записать не может.
TaskNotFound404Эта фоновая задача не найдена.
TaskStatusUnknown400Фоновая задача не может быть в таком состоянии.