Beget.API: задачи Cron
Читайте расписание CronTab аккаунта Beget и автоматизируйте его обслуживание; метод getList возвращает ID, поля расписания, команду и состояние каждой задачи.
Что делает API
Раздел cron управляет задачами планировщика хостингового аккаунта. Для безопасного аудита начните с getList: результат содержит row_number как ID задачи, календарные поля minutes, hours, days, months и weekdays, команду и is_hidden. API также позволяет создавать задачи; созданная задача сразу активна, поэтому создание не подходит для пробного чтения.
Когда использовать
- При переносе сайта получить текущий список расписаний и сверить команды с новым окружением.
- Панель обслуживания может показывать владельцу аккаунта ID и команду каждой задачи, чтобы найти устаревший запуск.
- Перед изменением расписания сохранить текущее состояние getList для последующего сравнения.
Подключение и ограничения
- Авторизация
- Нужны login аккаунта и отдельный пароль доступа к API; включите API в панели управления. Ограничения IP из панели распространяются на API. Запросы выполняются по HTTPS, параметры кодируются URL-кодированием; GET и POST поддерживаются, документация рекомендует POST.
- Что учесть
- getList читает все задания CronTab аккаунта. add принимает minutes (0–59), hours (0–23), days (1–31), months (1–12), weekdays (0–7; 0 и 7 — воскресенье) и command. Созданное задание сразу активно. Общий лимит Beget.API — не более 60 запросов в минуту на пользователя; распределите его между всеми разделами интеграции.
Пример использования
Подготовьте доступ по инструкции выше и замените параметры своими. Пример не выполняется на этой странице.
# Задайте BEGET_LOGIN и BEGET_API_PASSWORD в окружении.
curl --silent --show-error --fail-with-body --request POST 'https://api.beget.com/api/cron/getList' \
--data-urlencode "login=${BEGET_LOGIN:?Укажите логин аккаунта}" \
--data-urlencode "passwd=${BEGET_API_PASSWORD:?Укажите пароль API}" \
--data-urlencode 'output_format=json'
- Результат
- Сначала проверьте status и answer.status: оба должны быть success. В answer.result ожидается массив задач; у каждой документация показывает row_number, minutes, hours, days, months, weekdays, command и is_hidden. В примере документации is_hidden описан как признак активности/неактивности.
- Ошибки
- При status=error проверьте error_code и error_text: AUTH_ERROR означает ошибку доступа, INCORRECT_REQUEST — некорректный запрос, NO_SUCH_METHOD — неверный путь метода. При answer.status=error разберите answer.errors; LIMIT_ERROR может означать лимит ресурсов или частоты запросов, поэтому одного повторения запроса недостаточно.
Сверено с документацией: .
Порядок интеграции
- Включить Beget.API и подготовить отдельный пароль API.
- Запросить cron/getList и сохранить расписание вместе с row_number.
- Выберите задачу по row_number и проверьте команду и пути в окружении сайта перед изменением её расписания.
- Если создаёте задачу через add, проверьте выражение времени и путь к исполняемой программе: новая задача активируется сразу.
Что проверить перед запуском
- row_number — идентификатор задачи, тогда как остальные поля описывают расписание.
- Для weekdays документация задаёт диапазон 0–7, причём и 0, и 7 означают воскресенье.
- Метод add сразу активирует задачу; не отправляйте его в качестве тестового запроса.
Хостинг-провайдер, предлагающий услуги по размещению сайтов и их обслуживанию. Компания обеспечивает стабильную работу серверов, предоставляет различные тарифные планы и помогает клиентам с настройкой и оптимизацией сайтов.