Как это работает
Коды ошибок API
Все коды ошибок, которыми может ответить API панели, HTTP-статус каждого и его значение: биллинг ветвится по коду, а не разбирает текст.
Отклонённый запрос получает в ответ документ проблемы (RFC 7807),
и читать в нём нужно поле code. Оно стабильно и никогда не переводится: вызывающая сторона
ветвится по нему. Поля title и detail содержат ту же ошибку в виде фразы на языке вызывающего
(английский, русский или армянский, по Accept-Language), а correlationId указывает запрос в
журнале сервера.
{
"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 у задачи без ошибки:
"failure": {
"code": "AgentBelowFreeSpaceFloor",
"message": "На сервере почти закончилось место на диске, поэтому операция не начата и ничего не изменено. Освободите место на сервере и повторите попытку."
}
Код всегда один из перечисленных ниже. Сообщение получается при каждом чтении задачи, на языке
читающего, поэтому это та же фраза, что и в ответе с ошибкой. Код, который не описывает ни один
установленный модуль, читается фразой TaskFailureUnexplained, а исходный код остаётся в code.
Все коды
294 кода, взятых из определений ошибок в исходном коде панели: таблица ErrorMessages
каждого модуля, агента сервера и коды значений запроса. В столбце «Значение» стоит фраза, которую отправляет
API. AccountNotFound и SiteNotFound используются несколькими модулями и указаны у каждого. В
RequestParameterInvalid «…» обозначает имя параметра. 20 кодов для реселлеров, предложений членства, повторной отправки
приглашения, пропуска итоговой резервной копии и проверки резервной копии нет в 1.0.0-beta.4: они
появятся в следующем выпуске.
- задача: никогда не бывает HTTP-ответом. Код появляется только в
failure.codeфоновой задачи. - нет: описан в сообщениях панели, но сейчас ни один путь кода его не выдаёт.
- поток лога: последний кадр живого потока лога, а не HTTP-ответ.
Значения запроса
| Код | HTTP | Значение |
|---|---|---|
ListPageOutOfRange | 400 | Номер страницы должен быть не меньше 1. |
ListPageSizeNotOffered | 400 | Размер страницы может быть только 10, 25, 50 или 100. |
ListSearchInvalid | 400 | Текст поиска содержит недопустимые символы. |
ListSearchTooLong | 400 | Текст поиска может содержать не более 100 символов. |
ListSortUnknown | 400 | Этот список нельзя отсортировать таким образом. |
RequestParameterInvalid | 400 | Значение параметра «…» не удаётся прочитать. |
Сама панель
| Код | HTTP | Значение |
|---|---|---|
HostForbidden | 403 | У вас нет доступа к этой странице. |
HostRateLimited | 429 | За короткое время отправлено слишком много запросов. Подождите время, указанное в заголовке Retry-After, и повторите попытку. |
HostTwoFactorSetupRequired | 403 | Сначала завершите настройку двухфакторной аутентификации. |
HostUnexpectedError | 500 | Что-то пошло не так, и запрос не удалось выполнить. Повторите попытку. Если ошибка повторяется, обратитесь в поддержку и сообщите идентификатор запроса, показанный рядом с этим сообщением: именно по нему поддержка найдёт ваш запрос. |
HostViewAsNotAllowed | 403 | Это действие недоступно, пока вы просматриваете панель от имени этой учётной записи. |
HostValidationFailed | 400 | Некоторые из введённых данных некорректны. |
Агент сервера
| Код | HTTP | Значение |
|---|---|---|
AgentAccountSuspended | 409 | Аккаунт приостановлен, поэтому операция отклонена и ничего не запущено. Возобновите аккаунт и повторите попытку. |
AgentAlreadyExists | 409 | Это уже существует на вашем сервере, поэтому повторно ничего не создано. |
AgentBelowFreeSpaceFloor | 503 | На сервере почти закончилось место на диске, поэтому операция не начата и ничего не изменено. Освободите место на сервере и повторите попытку. |
AgentCertificateUnreadable | 400 | Не удалось прочитать сертификат. Проверьте, что вставлен весь сертификат, включая строки BEGIN и END. |
AgentFirewallPortsMisconfigured | 500 | Брандмауэр не изменён: панель не знает, какие порты должны оставаться открытыми на вашем сервере. Ничего не изменено. Обратитесь в поддержку. |
AgentIncompatible | 503 | Версии панели и службы, управляющей вашим сервером, не совпадают, поэтому запрос не выполнен. Возможно, обновление ещё не завершено; повторите попытку позже, а если ошибка повторяется, обратитесь в поддержку. |
AgentInvalidInput | 400 | Некоторые из указанных данных не приняты. Проверьте их и повторите попытку. |
AgentInvalidResponse | 500 | Ваш сервер не вернул понятного ответа. Повторите попытку через несколько минут, а если ошибка повторяется, обратитесь в поддержку. |
AgentLimitReached | 409 | Лимит вашего тарифа на элементы этого типа уже исчерпан, поэтому ничего не создано. Удалите ненужный элемент или перейдите на более крупный тариф, затем повторите попытку. |
AgentNotFound | 404 | Этого больше нет на вашем сервере. Обновите страницу, чтобы увидеть текущее состояние. |
AgentNotImplemented | 503 | Ваш сервер пока не поддерживает эту возможность, поэтому ничего не выполнено. Выберите другой вариант или обратитесь в поддержку, чтобы узнать, когда она появится. |
AgentPackageSourceRefused | 502 | Репозиторий пакетов, из которого устанавливает ваш сервер, отказал в загрузке, поэтому ничего не установлено. Проблема на стороне репозитория, а не вашего сервера; повторите попытку позже, а если ошибка повторяется, обратитесь в поддержку. |
AgentPackageSourceUnreachable | 503 | Не удалось связаться ни с одним репозиторием пакетов, из которых устанавливает ваш сервер, поэтому ничего не установлено. Обычно это временная проблема сети; повторите попытку через несколько минут, а если ошибка повторяется, обратитесь в поддержку. |
AgentPrivateKeyMismatch | 400 | Закрытый ключ не соответствует этому сертификату. Вставьте ключ, созданный вместе с запросом на сертификат. |
AgentPrivateKeyUnreadable | 400 | Не удалось прочитать закрытый ключ. Проверьте, что вставлен весь ключ, включая строки BEGIN и END, и что он не защищён паролем. |
AgentRunNotStopped | 500 | Серверу не удалось подтвердить, что операция остановлена, поэтому она может всё ещё выполняться. Проверьте её состояние, прежде чем повторять попытку. |
AgentSaturated | 503 | Сервер уже выполняет максимально допустимое число таких операций, поэтому ничего не запущено. Подождите, пока одна из них завершится, и повторите попытку. |
AgentSystemFailure | 500 | Эту операцию не удалось выполнить на вашем сервере, изменения не внесены. Повторите попытку через несколько минут, а если ошибка повторяется, обратитесь в поддержку. |
AgentUnavailable | 503 | Ваш сервер сейчас не отвечает, поэтому выполнение запроса не подтверждено. Повторите попытку через минуту, а если ошибка повторяется, обратитесь в поддержку. |
AgentUnspecified | 500 | Не удалось выполнить эту операцию на вашем сервере. Повторите попытку через несколько минут, а если ошибка повторяется, обратитесь в поддержку. |
AgentValidationFailed | 400 | Ваш сервер счёл указанные данные некорректными. Исправьте их и повторите попытку. |
Хостинг-аккаунты
| Код | HTTP | Значение |
|---|---|---|
AccountCleanupFailed | 500 | Аккаунт не удалён: не удалось сначала удалить принадлежащие ему объекты. Ничего не изменено, попробуйте ещё раз. |
AccountDomainTaken | 409 | Этот домен уже используется другим аккаунтом. |
AccountDomainWwwPrefix | 400 | Укажите основной домен без «www.», например example.com. |
AccountFeatureNotGranted | 403 | Вам не предоставлен доступ к этой возможности. Обратитесь к владельцу аккаунта. |
AccountFinalBackupSkipForbidden | 403 | Реселлер не может пропустить итоговую резервную копию при удалении аккаунта. Обратитесь к администратору или дождитесь копии. |
AccountHomeGroupRepairCountInvalid | 400 | Число исправляемых каталогов не может быть отрицательным. Прочитайте отчёт снова и подтвердите указанное в нём число. |
AccountHomeGroupRepairPlanChanged | 409 | Домашние каталоги на сервере больше не совпадают с прочитанным вами отчётом, поэтому ничего не исправлено и ничего не изменено. Получите новый отчёт и подтвердите его числа, прежде чем исправлять. |
AccountLoginIssuanceFailed | 500 | Аккаунт создан, но не удалось выдать логин его владельцу. Не создавайте аккаунт заново, отправьте приглашение повторно. |
AccountNameInvalid | 400 | Недопустимое имя аккаунта. Используйте от 3 до 30 строчных латинских букв, цифр или знаков подчёркивания, начиная с буквы. |
AccountNameReserved | 400 | Это имя аккаунта зарезервировано системой и не может быть использовано. Выберите другое имя. |
AccountNameTaken | 409 | Это имя аккаунта уже занято. |
AccountNotFound | 404 | Аккаунт не найден. |
AccountOwnerLanguageUnsupported | 400 | Выберите язык владельца из списка: английский, русский или армянский. |
AccountPlanQuotaBelowUsage | 409 | Тариф не изменён: этот аккаунт уже использует больше диска, чем позволяет квота нового тарифа, и после перевода он не сможет записывать файлы. Выберите тариф с большей квотой или сначала освободите место в аккаунте. |
AccountResumptionFailed | 500 | Аккаунт не возобновлён: не удалось снова запустить то, что он выполняет. Ничего не изменено, попробуйте ещё раз. |
AccountResumptionNotObserved | 500 | Аккаунт не возобновлён: не удалось убедиться, что сервер действительно его снова запустил. Ничего не изменено, попробуйте ещё раз. |
AccountStatusUnknown | 400 | Неизвестный статус аккаунта. Используйте active или suspended. |
AccountSuspensionFailed | 500 | Аккаунт не приостановлен: не удалось сначала остановить то, что он выполняет. Ничего не изменено, попробуйте ещё раз. |
AccountSuspensionNotObserved | 500 | Аккаунт не приостановлен: не удалось убедиться, что сервер действительно его остановил. Ничего не изменено, попробуйте ещё раз. |
PlanFeatureNotIncluded | 403 | Эта возможность не входит в ваш тарифный план. |
PlanFeatureUnknown | 400 | Возможность тарифного плана должна быть одной из перечисленных в панели. |
PlanInUse | 409 | Тариф не удалён: на нём ещё есть аккаунты. Сначала переведите эти аккаунты на другой тариф или удалите их. |
PlanNameTaken | 409 | Тариф с таким названием уже существует. |
PlanNotFound | 404 | Тарифный план не найден. |
PlanOwnerMismatch | 409 | Тариф и аккаунт принадлежат разным владельцам. Аккаунт может использовать только тариф своего реселлера, а аккаунт администратора, только тариф администратора. |
PlanQuotaBelowUsage | 409 | Тариф не изменён: один из аккаунтов на нём уже использует больше диска, чем позволяет новая квота, и после её снижения этот аккаунт не сможет записывать файлы. Увеличьте квоту либо сначала освободите место или переведите этот аккаунт на другой тариф. |
ResellerAccountLimitReached | 409 | Реселлер достиг количества аккаунтов, которое ему выделено. Попросите администратора увеличить лимит. |
ResellerDiskPoolExceeded | 409 | Это превысит дисковое пространство, выделенное реселлеру. Выберите тариф меньшего объёма или попросите администратора увеличить пул диска. |
ResellerEnvelopeInvalid | 400 | Лимиты реселлера недопустимы. Каждое значение должно быть неотрицательным и не превышать допустимого предела, а лимиты ресурсов, положительными. |
ResellerHasAccounts | 409 | Реселлер не удалён: у него ещё есть аккаунты или тарифы. Сначала удалите их. |
ResellerLoginIssuanceFailed | 500 | Реселлер создан, но не удалось выдать ему логин. Удалите реселлера и создайте заново, когда причина из журнала сервера будет устранена. |
ResellerNameInvalid | 400 | Недопустимое имя реселлера. Используйте от 3 до 30 строчных латинских букв, цифр или подчёркиваний, начиная с буквы. Это же имя реселлер использует для входа. |
ResellerNameTaken | 409 | Это имя уже занято другим реселлером или аккаунтом. |
ResellerNotFound | 404 | Реселлер не найден. |
ResellerPlanExceedsEnvelope | 400 | Тариф выходит за рамки того, что выделено реселлеру: одно из значений выше предела или функция не входит в набор. Уменьшите значения или уберите функцию. |
ResellerPlanLimitReached | 409 | Реселлер достиг количества тарифов, которое ему выделено. Удалите тариф или попросите администратора увеличить лимит. |
ResellerSuspended | 409 | Реселлер приостановлен и не может вносить изменения. Сначала администратор должен его возобновить. |
Резервные копии
| Код | HTTP | Значение |
|---|---|---|
AccountBackupOperationRunning | 409 | На вашем сервере ещё выполняется другая операция резервного копирования или восстановления для этого аккаунта. Ничего не изменено. Повторите попытку, когда она завершится. |
AccountNotFound | 404 | Аккаунт не найден. |
BackupArtifactUnvouched | задача¹ | Панель перестала следить за этой резервной копией до того, как сервер сообщил результат. Копия ЕСТЬ на сервере, но панель не записала её контрольную сумму, поэтому не может её проверить и не предлагает для восстановления. Копия помечена как неудачная и не удалена. Обратитесь в поддержку, чтобы освободить место, или создайте новую резервную копию. |
BackupCancelled | задача¹ | Создание резервной копии было отменено до завершения. |
BackupDateRangeInverted | 400 | Начало периода не может быть позже его конца. |
BackupDestinationKindUnknown | 400 | Это не тип места хранения резервных копий. |
BackupDestinationLocalAlreadyDefined | 409 | На сервере уже есть локальное место хранения резервных копий, и оно может быть только одно. |
BackupDestinationNameInvalid | 400 | Имя места хранения резервных копий обязательно и не длиннее 64 символов. |
BackupDestinationNotConfigured | 409 | На сервере нет места хранения резервных копий по умолчанию, поэтому резервное копирование невозможно до следующего запуска. |
BackupDestinationNotFound | 404 | Такого места хранения резервных копий не существует. |
BackupDestinationRemoteUnsupported | 400 | Эта сборка хранит резервные копии только на этом сервере. Хранилище, совместимое с S3, недоступно. |
BackupInvalidOutcome | задача¹ | Агент сервера сообщил о готовой копии, но не указал, чем её опознать. |
BackupKindUnknown | 400 | Это не тип резервной копии. |
BackupNotFound | 404 | Резервная копия не найдена. |
BackupNotRestorable | 409 | Эту резервную копию нельзя восстановить: она не была создана успешно. |
BackupNotVerifiable | 409 | Эту резервную копию нельзя проверить: она не была создана успешно. |
BackupOutcomeUnobserved | задача¹ | Панель перестала следить за созданием этой копии до того, как сервер сообщил результат, поэтому неизвестно, была ли копия завершена. Копия помечена как неудачная и не предлагается для восстановления. Создайте новую копию, а если это повторяется, обратитесь в поддержку. |
BackupScheduleDayNotAllowed | 400 | Для ежедневного расписания день недели не указывается. |
BackupScheduleDayRequired | 400 | Для еженедельного расписания нужно указать день недели. |
BackupScheduleHourOutOfRange | 400 | Час должен быть от 0 до 23. |
BackupScheduleRetainOutOfRange | 400 | Количество хранимых копий должно быть от 1 до 365. |
BackupScheduledRunAborted | задача¹ | Запланированное копирование прервалось до того, как агент сообщил результат. |
BackupStatusUnknown | 400 | Это не статус резервной копии. |
BackupStillRunning | 409 | Резервная копия ещё создаётся и пока не может быть удалена. |
BackupStreamDropped | задача¹ | Связь с агентом сервера была потеряна во время создания резервной копии. |
BackupStreamIdle | задача¹ | Агент сервера перестал сообщать о ходе создания резервной копии. |
BackupTruncated | задача¹ | Агент сервера завершил работу, не сообщив, чем закончилось создание копии. |
BackupVerificationArtifactMissing | 404 | Сохранённый архив не найден. |
BackupVerificationFailed | 400 | Сохранённый архив больше не совпадает с записью о нём. |
FinalBackupFailed | 500 | Аккаунт не был удалён: не удалось создать его финальную резервную копию. |
RestoreArtifactRejected | 400 | Ваш сервер отклонил эту копию: её содержимое не соответствует тому, что панель записала при её создании. Ничего не восстановлено, аккаунт не изменён. Восстановите из другой копии или обратитесь в поддержку: повторная отправка того же запроса ничего не изменит. |
RestoreCancelled | 500 | Восстановление было отменено до завершения. |
RestoreConfirmationMismatch | 409 | Введённое имя не совпадает с именем пользователя этого аккаунта. |
RestoreConfirmationRequired | 400 | Введите имя пользователя аккаунта в точности, чтобы подтвердить восстановление. |
RestoreInvalidOutcome | 500 | Агент сервера сообщил о завершении восстановления, не указав, что было восстановлено. |
RestoreOutcomeUnobserved | задача¹ | Панель перестала следить за этим восстановлением до того, как сервер сообщил результат, поэтому неизвестно, насколько оно продвинулось. Данные аккаунта могли быть уже заменены: проверьте файлы и базы данных, прежде чем запускать восстановление снова, а если сомневаетесь, обратитесь в поддержку. |
RestorePartial | 500 | Восстановление выполнено не полностью; аккаунт восстановлен лишь частично. |
RestoreStreamDropped | 503 | Связь с агентом сервера была потеряна во время восстановления аккаунта. |
RestoreStreamIdle | 503 | Агент сервера перестал сообщать о ходе восстановления аккаунта. |
RestoreTruncated | 500 | Агент сервера остановился, не сообщив, что именно было восстановлено. |
Задания по расписанию
| Код | HTTP | Значение |
|---|---|---|
AccountNotFound | 404 | Аккаунт не найден. |
CronCommandInvalid | 400 | Некорректная команда. Она должна быть одной строкой длиной не более 4096 байт. |
CronEntryAlreadyExists | 409 | Такая задача с этим расписанием и командой уже существует. |
CronEntryIdInvalid | 400 | Некорректный идентификатор запланированной задачи. |
CronEntryLimitReached | 409 | Ваш тариф не позволяет создать больше запланированных задач. |
CronEntryLimitReachedConcurrently | 409 | Лимит запланированных задач вашего тарифа был исчерпан другим запросом, сделанным в тот же момент, поэтому эта задача не создана. Введённые вами данные верны. Удалите ненужную запланированную задачу или перейдите на более крупный тариф, затем повторите попытку. |
CronEntryNotFound | 404 | Запланированная задача не найдена. |
CronEntrySuspended | 409 | Аккаунт приостановлен, поэтому запланированная задача не запущена. Возобновите аккаунт и повторите попытку. |
CronEnvironmentDuplicateName | 400 | Одно и то же имя переменной передано дважды. |
CronEnvironmentInvalid | 400 | Не удалось прочитать переданные переменные окружения. |
CronEnvironmentNameInvalid | 400 | Имя переменной может содержать только заглавные латинские буквы, цифры и подчёркивания и не может начинаться с цифры. |
CronEnvironmentNameReserved | 400 | MAILTO и SHELL управляются сервером и не могут быть заданы здесь. |
CronEnvironmentTooManyVariables | 400 | Передано слишком много переменных окружения. |
CronEnvironmentValueInvalid | 400 | Значение переменной не может содержать знак процента, управляющие символы, пробелы по краям или обрамляющие кавычки. |
CronOperationFailed | 500 | Не удалось изменить запланированную задачу. Ничего не изменено, попробуйте ещё раз. |
CronRunAccountLimitReached | 409 | Сейчас выполняется слишком много запланированных задач вашего аккаунта. Дождитесь завершения одной из них и повторите попытку. |
CronRunAgentSaturated | 503 | Планировщик сервера уже выполняет максимально допустимое число задач, поэтому эта задача не запущена. Ничего не изменено; дождитесь завершения одной из них и повторите попытку. |
CronRunNotFound | 404 | Этот запуск не найден. |
CronRunNotStopped | 500 | Эта запланированная задача была запущена вручную, но серверу не удалось подтвердить, что она остановлена, поэтому она может всё ещё выполняться. Проверьте её состояние, прежде чем запускать снова: повторный запуск начнётся рядом с первым. |
CronRunOutcomeUnknown | 400 | Этот результат запуска панели неизвестен. |
CronRunServerBusy | 503 | Сервер сейчас выполняет много запланированных задач, поэтому эта задача не запущена. Ничего не изменено; повторите попытку чуть позже. |
CronScheduleInvalid | 400 | Некорректное расписание. Используйте пять полей cron, например 0 3 * * 1. |
Ручной запуск задачи ограничен, чтобы один аккаунт не занял все рабочие потоки сервера. Оператор может изменить два лимита в /etc/maran/panel.env: Cron__Runs__MaxConcurrentPerAccount (по умолчанию 2, на аккаунт) и Cron__Runs__MaxConcurrentGlobal (по умолчанию 16, на все аккаунты вместе); это целые числа не меньше 1, при любом другом значении панель не запускается. Код CronRunAccountLimitReached возвращается, когда исчерпан лимит самого аккаунта, а CronRunServerBusy - когда занят весь сервер; во втором случае имеет смысл повторить попытку. Если запуск дошёл до предела вывода, его задание останавливается, и запуск сообщается как остановленный только после подтверждения сервера. Если подтверждения нет, ответом будет CronRunNotStopped (500), а задание может продолжать работать до предельного времени работы на сервере, поэтому проверьте вывод записи, прежде чем запускать её снова. Каждый запуск попадает в журнал аудита, в том числе если браузер отключился, пока задача ещё выполнялась.
Базы данных
| Код | HTTP | Значение |
|---|---|---|
AccountNotFound | 404 | Аккаунт не найден. |
DatabaseGrantRepairCountInvalid | 400 | Число исправляемых прав не может быть отрицательным. Прочитайте отчёт снова и подтвердите указанное в нём число. |
DatabaseGrantRepairPlanChanged | 409 | Права на сервере больше не совпадают с прочитанным вами отчётом, поэтому ничего не исправлено и ничего не изменено. Получите новый отчёт и подтвердите его числа, прежде чем исправлять. |
DatabaseLimitReached | 409 | Ваш тариф не позволяет создать больше баз данных. |
DatabaseLimitReachedConcurrently | 409 | Лимит баз данных вашего тарифа был исчерпан другим запросом, сделанным в тот же момент, поэтому эта база данных не создана и пароль не выдан. Введённые вами данные верны. Удалите ненужную базу данных или перейдите на более крупный тариф, затем повторите попытку. |
DatabaseNameInvalidFormat | 400 | Имя базы данных может содержать только строчные латинские буквы и цифры. |
DatabaseNameTaken | 409 | У вас уже есть база данных с таким именем. |
DatabaseNameTooLong | 400 | Это имя слишком длинное вместе с префиксом вашего аккаунта. |
DatabaseNotFound | 404 | База данных не найдена. |
DatabaseProvisioningFailed | 500 | Не удалось создать базу данных. Ничего не осталось на сервере, попробуйте ещё раз. |
DatabaseUserNameInvalidFormat | 400 | Имя пользователя базы данных может содержать только строчные латинские буквы и цифры. |
DatabaseUserNameTaken | 409 | У вас уже есть пользователь базы данных с таким именем. |
DatabaseUserNameTooLong | 400 | Это имя пользователя слишком длинное вместе с префиксом вашего аккаунта. |
Брандмауэр
| Код | HTTP | Значение |
|---|---|---|
BanAddressInvalid | 400 | Это не адрес, который брандмауэр может заблокировать. |
BanAddressLoopback | 400 | Адрес обратной петли заблокировать нельзя: этот узел пропускает трафик обратной петли до того, как проверяются блокировки, поэтому такая блокировка ничего не остановит. Заблокируйте адрес, с которого трафик приходит на сервер (тот, что показан для соединения, а не 127.0.0.1 или ::1). |
BanDurationInvalid | 400 | Блокировка длится от одной минуты до одного года; оставьте срок пустым для постоянной блокировки. |
BanNotFound | 404 | Для этого адреса нет действующей блокировки. |
RulePortInvalid | 400 | Правило брандмауэра должно указывать порт от 1 до 65535. |
RulePortRangeInvalid | 400 | Правило межсетевого экрана, открывающее диапазон портов, должно заканчиваться выше своего начала и укладываться в 1-65535. |
RuleProtocolInvalid | 400 | Правило брандмауэра применяется к TCP или к UDP. |
RuleSourceCidrInvalid | 400 | Диапазон источника указывается в нотации CIDR, без битов хоста за пределами префикса. |
WhitelistCidrInvalid | 400 | Диапазон указывается в нотации CIDR, без битов хоста за пределами префикса. |
WhitelistCidrTaken | 409 | Этот диапазон уже есть в белом списке. |
WhitelistEntryNotFound | 404 | Запись белого списка не найдена. |
WhitelistEntryProtectsCaller | 409 | Удаление этого диапазона снимет исключение с адреса, с которого вы подключены, и тогда опечатка в пароле может закрыть вам доступ к этому серверу. Добавьте исключение, которое тоже покрывает этот адрес, и удалите это после, либо удалите его, подключившись с другого адреса. |
FTPS
| Код | HTTP | Значение |
|---|---|---|
AccountNotFound | 404 | Аккаунт не найден. |
FtpUserLimitReached | 409 | Ваш тариф не позволяет создать больше пользователей FTPS. Удалите ненужного или перейдите на более крупный тариф. |
FtpUserLimitReachedConcurrently | 409 | Лимит пользователей FTPS вашего тарифа был исчерпан другим запросом, сделанным в тот же момент, поэтому этот пользователь не создан и пароль не выдан. Введённые вами данные верны. Удалите ненужного пользователя FTPS или перейдите на более крупный тариф, затем повторите попытку. |
FtpUserNameInvalidFormat | 400 | Имя пользователя FTPS может содержать только строчные латинские буквы и цифры и не может быть пустым. |
FtpUserNameTaken | 409 | Это имя пользователя FTPS уже занято. Выберите другое. |
FtpUserNameTooLong | 400 | Это имя пользователя FTPS слишком длинное. К нему добавляется префикс вашего аккаунта, поэтому выберите более короткое. |
FtpUserNotFound | 404 | Пользователь FTPS не найден. Обновите страницу, чтобы увидеть имеющихся пользователей FTPS. |
FtpUserProvisioningFailed | 500 | Не удалось создать пользователя FTPS, пароль не выдан. Повторите попытку. Если имя окажется занято, обратитесь в поддержку: возможно, потребуется удалить оставшегося пользователя. |
FtpsCertificateMissing | 409 | FTPS не запустится, пока для этого имени хоста нет TLS-сертификата. Введённые вами данные верны: выпустите или установите сертификат в разделе SSL, затем снова включите FTPS. |
FtpsHostnameInvalidFormat | 400 | Это недопустимое имя хоста. Введите имя вида ftp.example.com. |
FtpsHostnameNotServed | 400 | На этой панели нет сайта с таким именем хоста. Сначала добавьте сайт, затем включите для него FTPS. |
FtpsHostnameReserved | 400 | Это имя нельзя использовать для FTPS-сервера. |
FtpsHostnameTooLong | 400 | Это имя хоста слишком длинное. Имя хоста может содержать не более 253 символов. |
FtpsPassiveAddressInvalid | 400 | Пассивный адрес должен быть адресом IPv4 в обычной записи, например 203.0.113.7: не именем хоста, не адресом IPv6, для которого в ответе PASV нет формы, и без ведущих нулей. Оставьте поле пустым, если ваш сервер не находится за NAT. |
Пользователи, вход и приглашения
| Код | HTTP | Значение |
|---|---|---|
AccountMembershipNotFound | 404 | Аккаунт не найден. |
AccountMembershipSuspended | 409 | Этот аккаунт приостановлен, поэтому работать в нём нельзя, пока он не будет возобновлён. |
AdminRecoveryLoginNotActive | 409 | Вход этого администратора не активен (приостановлен или ещё ждёт первого пароля), поэтому восстановить его с консоли нельзя. |
AdminRecoveryNotAdministrator | 409 | Этот пользователь не администратор. С консоли можно восстановить доступ только администратору. |
AdminRecoveryUserNotFound | 404 | Пользователь с таким адресом электронной почты или именем не найден. |
AuditActionFilterInvalid | 400 | Такое действие журнал аудита записать не может. |
AuditDateRangeInverted | 400 | Начало периода не может быть позже его конца. |
AuditOutcomeUnknown | 400 | У записи аудита не может быть такого результата. |
CurrentPasswordIncorrect | 400 | Текущий пароль указан неверно. |
EmailInvalidFormat | 400 | Введите корректный адрес электронной почты. |
EmailTaken | 409 | Этот адрес электронной почты уже зарегистрирован. |
InvalidCredentialsUnauthorized | 401; 400, если пусто или слишком длинно | Неверное имя пользователя или пароль. |
InvalidTwoFactorCodeClockUnsynchronizedUnauthorized | 401 | Код неверен. Часы сервера не синхронизированы, из-за чего правильные коды могут не приниматься. Попросите администратора сервера проверить синхронизацию времени. |
InvalidTwoFactorCodeUnauthorized | 401 | Код неверен. Проверьте приложение-аутентификатор и попробуйте снова. |
InvitationAccountNotFound | 404; 400, если идентификатор пуст | Такой хостинг-аккаунт не найден. |
InvitationAccountSuspended | 409 | Пока аккаунт приостановлен, приглашение выдать нельзя. Сначала возобновите аккаунт. |
InvitationLoginNotPending | 409 | Приглашать некого: у этой учётной записи уже есть пароль. |
InvitationTokenInvalid | 400 | Эта ссылка-приглашение больше недействительна. Попросите администратора отправить её снова. |
MembershipOfferAccountSuspended | 409 | Аккаунт приостановлен, поэтому принять предложение сейчас нельзя. |
MembershipOfferNotFound | 404 | Такого предложения нет, или оно уже недействительно. |
PasswordResetEmailInvalid | 400 | Введите корректный адрес электронной почты. |
PasswordResetTokenInvalid | 400 | Ссылка для сброса пароля больше недействительна. Запросите новую. |
PasswordTooWeak | 400 | Выберите пароль не короче минимальной длины, заданной администратором (по умолчанию 12 символов). |
PasswordTooLong | 400 | Этот пароль слишком длинный. Выберите более короткий. |
PasswordSameAsUsername | 400 | Выберите пароль, отличающийся от имени пользователя. |
PinnedPageAlreadyPinned | 409 | Эта страница уже закреплена. |
PinnedPageKeyInvalid | 400 | Эту страницу нельзя закрепить. |
PinnedPageLimitReached | 409 | Вы закрепили максимально возможное число страниц. Сначала открепите одну из них. |
PinnedPageNotFound | 404 | Эта страница не закреплена. |
RefreshTokenInvalidUnauthorized | 401 | Сеанс завершён. Войдите заново. |
RefreshTokenReusedUnauthorized | 401 | Сеанс завершён из соображений безопасности. Войдите заново. |
SecurityPolicyInvalid | 400 | Эти настройки безопасности выходят за допустимые пределы. |
SessionNotFound | 404 | Сеанс не найден. |
SetupAlreadyCompletedForbidden | 403 | Панель уже настроена. |
SetupTokenExpiredUnauthorized | 401 | Срок действия этого токена установки истёк, поэтому администратор не создан: из соображений безопасности одноразовый токен установщика перестаёт работать через определённое время после установки панели. Введённые вами данные верны. Чтобы получить доступ к серверу, задайте новый токен установки в конфигурации окружения панели, перезапустите панель и введите здесь новый токен. |
SetupTokenInvalidUnauthorized | 401 | Ссылка настройки недействительна. |
SubUserFeatureInvalid | 400 | Выберите возможности из списка, который предлагает панель. |
SubUserLimitReached | 409 | В вашем аккаунте уже максимально допустимое число дополнительных пользователей. Удалите одного, прежде чем приглашать следующего. |
SubUserNotFound | 404 | Такого пользователя нет. |
SubUserNotPending | 409 | Этот человек уже принял приглашение, поэтому отправлять его повторно не нужно. |
SubUsersOwnerOnly | 403 | Управлять пользователями аккаунта может только его владелец. |
TwoFactorAlreadyEnabled | 409 | Двухфакторная аутентификация уже включена. |
TwoFactorNotEnabled | 409 | Двухфакторная аутентификация не включена. |
TwoFactorRequiredUnauthorized | нет² | Введите код из приложения-аутентификатора, чтобы завершить вход. |
UserNotFound | 404 | Пользователь не найден. |
UsernameInvalidFormat | 400 | Имя пользователя может содержать только буквы, цифры, точки, дефисы и подчёркивания. |
UsernameTaken | нет² | Это имя пользователя уже занято. |
ViewAsAccountNotFound | 404 | Аккаунт не найден, или у него нет входа, от имени которого можно просматривать панель. |
ViewAsLoginUnavailable | 409 | Вход этого аккаунта приостановлен или заблокирован, поэтому просмотреть панель от его имени нельзя. |
ViewAsNotViewing | 409 | Вы не просматриваете панель от имени аккаунта. |
ViewAsResellerNotFound | 404 | Реселлер не найден, или у него нет входа, от имени которого можно просматривать панель. |
Лицензия
| Код | HTTP | Значение |
|---|---|---|
LicenceInstallExpired | 400 | Срок действия отправленной лицензии уже истёк. Ничего не было установлено, предыдущая лицензия (если она была) не изменена. Продлите лицензию и отправьте обновлённый файл. |
LicenceInstallFingerprintMismatch | 400 | Отправленная лицензия была выпущена для другого сервера. Ничего не было установлено, предыдущая лицензия (если она была) не изменена. Используйте самостоятельный перенос лицензии на этот сервер либо обратитесь в поддержку, если считаете это ошибкой. |
LicenceInstallMalformed | 400 | Отправленный файл лицензии имеет формат, который панель не может прочитать: возможно, он был скопирован не полностью, изменён, либо это вообще не файл лицензии. Ничего не было установлено, предыдущая лицензия (если она была) не изменена. Загрузите свежую копию лицензии и попробуйте снова, не редактируя файл. |
LicenceInstallProductMismatch | 400 | Отправленный файл лицензии выпущен для другого продукта и не может быть использован здесь. Ничего не было установлено, предыдущая лицензия (если она была) не изменена. Отправьте файл лицензии, выпущенный именно для этой панели. |
LicenceInstallSignatureInvalid | 400 | Подпись отправленного файла лицензии не соответствует его содержимому: файл был изменён после выпуска либо он не подлинный. Ничего не было установлено, предыдущая лицензия (если она была) не изменена. Получите свежую копию лицензии вместо ручного редактирования этой и отправьте её. |
LicenceInstallTextRequired | 400 | Текст лицензии не был отправлен. Вставьте или загрузите содержимое файла лицензии. |
Почта
| Код | HTTP | Значение |
|---|---|---|
MailDeliveryFailed | 502 | Почтовый сервер отклонил сообщение. |
MailRecipientInvalid | 400 | Получатель должен быть одним обычным адресом электронной почты, без отображаемого имени. |
MailServerUnreachable | 503 | Почтовый сервер по указанному адресу не ответил. Проверьте хост и порт или повторите попытку позже. |
SmtpAlertRecipientInvalid | 400 | Получатель оповещений должен быть одним обычным адресом электронной почты, без отображаемого имени. |
SmtpFromAddressInvalid | 400 | Отправитель должен быть одним обычным адресом электронной почты, без отображаемого имени. |
SmtpFromNameInvalid | 400 | Отображаемое имя отправителя должно быть одной строкой обычного текста. |
SmtpHostInvalid | 400 | Имя почтового сервера обязательно и должно быть одной строкой обычного текста. |
SmtpNotConfigured | 400 | Настройки исходящей почты ещё не заданы, письмо не отправлено. |
SmtpPasswordInvalid | 400 | Пароль длиннее, чем принимает панель. |
SmtpPortInvalid | 400 | Порт почтового сервера должен быть от 1 до 65535. |
SmtpSecurityInvalid | 400 | Выберите один из предложенных способов защиты соединения. |
SmtpUsernameInvalid | 400 | Имя пользователя должно быть одной строкой обычного текста. |
SFTP
| Код | HTTP | Значение |
|---|---|---|
AccountNotFound | 404 | Аккаунт не найден. |
SftpUserLimitReached | 409 | Ваш тариф не позволяет создать больше пользователей SFTP. |
SftpUserLimitReachedConcurrently | 409 | Лимит пользователей SFTP вашего тарифа был исчерпан другим запросом, сделанным в тот же момент, поэтому этот пользователь не создан и пароль не выдан. Введённые вами данные верны. Удалите ненужного пользователя SFTP или перейдите на более крупный тариф, затем повторите попытку. |
SftpUserNameInvalidFormat | 400 | Имя пользователя SFTP может содержать только строчные латинские буквы и цифры. |
SftpUserNameTaken | 409 | У вас уже есть пользователь SFTP с таким именем. |
SftpUserNameTooLong | 400 | Это имя слишком длинное вместе с префиксом вашего аккаунта. |
SftpUserNotFound | 404 | Пользователь SFTP не найден. |
SftpUserProvisioningFailed | 500 | Не удалось создать пользователя SFTP. Ничего не осталось на сервере, попробуйте ещё раз. |
Сайты
| Код | HTTP | Значение |
|---|---|---|
AccountNotFound | 404 | Аккаунт не найден. |
PhpInstallOutcomeUnobserved | 500 | Сервер не сообщил, была ли установлена эта версия PHP. Утверждать, что была, здесь не на чем, поэтому попытка считается неудачной: прежде чем повторять, проверьте менеджер пакетов на сервере. Незавершённую установку отличить от медленной отсюда невозможно. |
PhpVersionInvalidFormat | 400 | Это не корректная версия PHP. |
PhpVersionNotInstallable | 400 | Эту версию PHP нельзя установить на этом сервере. |
PhpVersionNotInstalled | 400 | Эта версия PHP не установлена на сервере. |
SiteAliasDuplicated | 400 | Одно и то же имя указано несколько раз. |
SiteAliasInvalidFormat | 400 | Одно из дополнительных имён не является корректным доменным именем. |
SiteAliasLimitExceeded | 400 | У сайта не может быть больше дополнительных имён, чем покрывает один сертификат. |
SiteAliasReserved | 400 | Одно из дополнительных имён нельзя использовать для сайта. |
SiteBackendNotPhp | 400 | Этот сайт не использует PHP, поэтому у него нет версии PHP для изменения. |
SiteBackendTypeUnknown | 400 | Это не тип серверной части сайта. |
SiteDomainInvalidFormat | 400 | Это не корректное доменное имя. |
SiteDomainReserved | 400 | Это имя нельзя использовать для сайта. |
SiteDomainTaken | 409 | Этот домен уже используется другим сайтом. |
SiteLimitReached | 409 | Ваш тариф не позволяет создать больше сайтов. |
SiteLimitReachedConcurrently | 409 | Лимит сайтов вашего тарифа был исчерпан другим запросом, сделанным в тот же момент, поэтому этот сайт не создан. Введённые вами данные верны. Удалите ненужный сайт или перейдите на более крупный тариф, затем повторите попытку. |
SiteLogHistoryLinesInvalid | 400 | Запрошено больше строк истории, чем допустимо. |
SiteLogSourceInvalid | 400 | Такого журнала у этого сайта нет. |
SiteLogTailFailed | поток лога³ | Не удалось прочитать журнал. |
SiteNotFound | 404 | Сайт не найден. |
SiteProxyUpstreamInvalidFormat | 400 | Это не корректный адрес upstream. |
SiteStatusUnknown | 400 | Это не статус сайта. |
Сертификаты
| Код | HTTP | Значение |
|---|---|---|
AccountNotFound | 404 | Аккаунт не найден. |
AcmeAccountRejected | 502 | Центр сертификации отклонил регистрацию этого сервера. |
AcmeAuthorityUnreachable | 503 | Не удалось связаться с центром сертификации. Попробуйте позже. |
AcmeCertificateUnreadable | 502 | Не удалось прочитать сертификат, выпущенный центром сертификации. |
AcmeChallengeTokenInvalid | 502 | Центр сертификации прислал проверочный токен, который сервер не принимает. |
AcmeChallengeUnavailable | 503 | Центр сертификации не предложил проверки, которую этот сервер может пройти. |
AcmeChallengeWriteFailed | 500 | Не удалось поместить проверочный файл в корневую папку сайта. |
AcmeOrderRejected | 502 | Центр сертификации отклонил заказ сертификата для этого домена. |
AcmeValidationFailed | 502 | Центру сертификации не удалось проверить домен. Убедитесь, что он указывает на этот сервер. |
AcmeValidationTimedOut | 503 | Центр сертификации не завершил проверку домена вовремя. |
CertificateAlreadyExists | 409 | Для этого домена уже выпущен сертификат. |
CertificateDomainInvalidFormat | 400 | Это некорректное доменное имя. |
CertificateDomainReserved | 400 | Для этого имени нельзя выпустить или установить сертификат. |
CertificateNotFound | 404 | Сертификат не найден. |
CertificatePemInvalid | 400 | Цепочка сертификатов не является корректным PEM: она должна содержать блок, начинающийся с -----BEGIN CERTIFICATE-----. |
CertificatePemRequired | 400 | Вставьте цепочку сертификатов в формате PEM. |
CertificatePemTooLarge | 400 | Цепочка сертификатов слишком велика: допускается не более 65 536 символов. |
CertificateStatusUnknown | 400 | Это не статус сертификата. |
PanelCertificateNotIssued | 404 | Для панели не выпущен доверенный сертификат; она работает с самоподписанным сертификатом. |
PanelChallengeWriteFailed | 500 | Не удалось разместить на сервере проверочный файл для имени хоста панели. |
PanelHostNameNotConfigured | 409 | Для панели не задано имя хоста, поэтому сертификат для неё заказать нельзя. Укажите Panel__HostName в /etc/maran/panel.env и перезапустите панель. |
PrivateKeyPemInvalid | 400 | Закрытый ключ не является корректным PEM: он должен содержать блок, начинающийся с -----BEGIN и заканчивающийся на PRIVATE KEY-----. |
PrivateKeyPemRequired | 400 | Вставьте закрытый ключ в формате PEM. |
PrivateKeyPemTooLarge | 400 | Закрытый ключ слишком велик: допускается не более 65 536 символов. |
SiteNotFound | 404 | Сайт не найден. |
Уровень журнала
| Код | HTTP | Значение |
|---|---|---|
LogLevelUnknown | 400 | Панель не предлагает такого уровня журнала. |
Фоновые задачи
| Код | HTTP | Значение |
|---|---|---|
TaskAbandonedByRestart | задача¹ | Панель перезапустилась, пока эта задача выполнялась, поэтому она не завершилась. |
TaskDateRangeInverted | 400 | Начало периода не может быть позже его конца. |
TaskFailureUnexplained | задача¹ | Операция не завершилась, и у панели нет описания причины. Код ниже называет сбой; укажите его, обращаясь за помощью. |
TaskKindFilterInvalid | 400 | Такой вид фоновой задачи панель записать не может. |
TaskNotFound | 404 | Эта фоновая задача не найдена. |
TaskStatusUnknown | 400 | Фоновая задача не может быть в таком состоянии. |