Сведения об аккаунте: баланс, тариф, ресурсы, сервер.

Переключить SSH-доступ для основного или FTP-аккаунта.

Args: status: 1 = включить, 0 = выключить ftplogin: Логин FTP-аккаунта (если пусто — применяется к основному аккаунту)

Средняя нагрузка по всем сайтам за месяц.

Средняя нагрузка по всем базам данных за месяц.

Детальная статистика нагрузки сайта (почасовая и посуточная за месяц).

Args: site_id: ID сайта

Детальная статистика нагрузки БД: CPU, размер, почасовая и посуточная.

Args: db_name: Имя базы данных

Доступные файловые резервные копии.

Доступные резервные копии баз MySQL.

Откатить файлы из резервной копии.

Args: backup_id: ID бэкапа (получить через backup_files_list) paths: Список путей для восстановления

Откатить базу MySQL из резервной копии.

Args: backup_id: ID бэкапа (получить через backup_mysql_list) databases: Список имён баз для восстановления

Содержимое файлового бэкапа (файлы и каталоги).

Args: backup_id: ID бэкапа (не указан = текущая копия) path: Путь от корня директории (пусто = корень)

Базы данных внутри резервной копии.

Args: backup_id: ID бэкапа (не указан = текущая копия)

Выгрузить файлы из бэкапа в корневую директорию аккаунта.

Args: paths: Список путей для скачивания backup_id: ID бэкапа (не указан = текущая копия)

Выгрузить дамп MySQL из бэкапа в корневую директорию аккаунта.

Args: bases: Список имён баз данных backup_id: ID бэкапа (не указан = текущая копия)

Журнал операций восстановления и скачивания бэкапов.

Все cron-задачи аккаунта.

Зарегистрировать новую cron-задачу.

Args: minutes: Минуты (0-59, * или */N) hours: Часы (0-23, * или */N) days: Дни месяца (1-31, * или */N) months: Месяцы (1-12, * или */N) weekdays: Дни недели (0-7, 0 и 7 = воскресенье) command: Команда для выполнения

Убрать cron-задачу.

Args: task_id: ID задачи

Изменить параметры cron-задачи. Указывайте только обновляемые поля.

Args: task_id: ID задачи minutes: Минуты (0-59, * или */N) hours: Часы (0-23, * или */N) days: Дни месяца (1-31, * или */N) months: Месяцы (1-12, * или */N) weekdays: Дни недели (0-7) command: Команда для выполнения

Переключить активность cron-задачи.

Args: task_id: ID задачи (полученный из cron_list) is_hidden: 1 = выключить (скрыть), 0 = включить

Адрес уведомлений о выполнении cron-задач.

Назначить email для отчётов cron. Пустая строка отключает уведомления.

Args: email: Email-адрес или пустая строка для отключения

DNS-записи FQDN плюс фактический ответ авторитативного NS.

В Beget поддомен — отдельная сущность со своим getData. Если прямой запрос вернул METHOD_FAILED, функция пробует родительскую зону и возвращает её records с пометкой (актуально для DKIM типа mail._domainkey.site.ru, которые иногда хранятся на уровне родителя).

ВАЖНО: отсутствие записи в зоне НЕ означает, что имя не резолвится. У зоны бывает catch-all на shared-хостинг Beget, невидимый для dns/getData: имя отвечает чужим адресом, хотя в выдаче API его нет. Поле effective — фактический ответ авторитативного NS зоны, запрошенный напрямую по UDP мимо кеша резолвера. Расхождение «в зоне нет, а отвечает» видно сразу.

Args: fqdn: Имя домена (site.ru или sub.site.ru) check_effective: Спросить авторитативный NS (по умолчанию да)

Подтвердить факт у авторитативного NS зоны: отдаётся ли значение миру.

success от dns_set_* означает «принято панелью», а dns_get подтверждает ровно это — он читает тот же источник, куда писал. Авторитативный NS может отдавать старое значение ещё несколько минут. Запуск certbot в этом окне сжигает попытку и приближает лимит Let's Encrypt на домен.

Тул опрашивает авторитативные NS зоны напрямую по UDP (мимо кеша любого резолвера) до совпадения с expect или до дедлайна.

Вручную сверять надо nslookup, а НЕ Resolve-DnsName -Server: флаг -Server не обходит клиентский кеш Windows и отдаёт устаревшее значение.

Args: fqdn: Имя, которое проверяем expect: Ожидаемое значение (IP для A, имя для CNAME/MX). Пусто — просто вернуть текущий ответ NS одним запросом, без ожидания type: Тип записи (A, AAAA, CNAME, MX, TXT, NS) timeout: Сколько секунд ждать совпадения (по умолчанию 120)

Задать A-запись (IPv4) для FQDN.

Безопасно: делает getData → merge → changeRecords. Прочие записи (MX, TXT, CNAME, NS) в зоне сохраняются. Прежние A-записи заменяются на переданную.

TTL: Beget управляет TTL на уровне зоны (типичный минимум 600 сек) и может игнорировать значение в запросе. Параметр оставлен для совместимости.

Если в зоне есть CAA/SRV — вернёт ошибку (changeRecords их затирает). Передайте force=True, чтобы продолжить и потерять их.

Args: fqdn: Имя домена address: IPv4-адрес (203.0.113.1) ttl: TTL в секундах (может быть проигнорирован; по умолчанию 600) force: Продолжить при наличии CAA/SRV (они будут удалены)

Задать CNAME-запись для поддомена.

Безопасно мерджится с существующими записями. ВАЖНО: у Beget set_type у зоны при CNAME становится эксклюзивным (A/MX/TXT при этом не работают). Используйте CNAME только на поддоменах, где у вас нет других записей.

Args: fqdn: Имя поддомена (www.site.ru) cname: Каноническое имя (site.ru — автоматически без trailing dot) ttl: TTL в секундах (см. dns_set_a) force: Продолжить при наличии CAA/SRV

Задать TXT-запись (SPF, верификация, DKIM и пр.).

Заменяет все TXT-записи одной. Если нужно добавить к существующим (верификация

• SPF, например) — используйте dns_patch_record с add=...

Прочие записи (A/MX/CNAME/NS) сохраняются.

Args: fqdn: Имя домена txtdata: Содержимое TXT-записи (v=spf1 redirect=_spf.yandex.net) ttl: TTL в секундах (см. dns_set_a) force: Продолжить при наличии CAA/SRV

Задать MX-запись (почтовый сервер) домена.

Заменяет все MX-записи одной. Прочие типы записей в зоне сохраняются. Для нескольких MX за один вызов — используйте dns_set_records.

Args: fqdn: Имя домена exchange: Имя сервера (mx.yandex.net — trailing dot снимается автоматически) preference: Приоритет (меньше = выше) ttl: TTL в секундах (см. dns_set_a) force: Продолжить при наличии CAA/SRV

Задать несколько типов DNS-записей одним вызовом.

По умолчанию — безопасный merge: типы, отсутствующие в records, сохраняются. replace_all=True — полная замена зоны (как делает голый dns/changeRecords): ВСЕ записи, кроме переданных, будут удалены.

Args: fqdn: Имя домена records: JSON с записями, например: {"A": [{"address": "1.2.3.4"}], "MX": [{"exchange": "mx.yandex.net", "preference": 10}]} replace_all: True — полная замена зоны; по умолчанию False (merge) force: Продолжить при наличии CAA/SRV (будут удалены)

Частично изменить записи одного типа (add/remove/replace).

Внутри: getData → merge → changeRecords. Прочие типы в зоне не затрагиваются. Удобно для многозначных TXT (SPF + DKIM + verification) и нескольких MX.

• add — JSON-массив записей для добавления к существующим

• remove — JSON-массив записей для удаления (match по полям кроме ttl)

• replace — JSON-массив для полной замены массива этого типа (если задан, add и remove игнорируются)

Примеры: type="TXT", add='[{"txtdata":"google-site-verification=abc"}]' — добавить к существующим TXT-записям type="TXT", remove='[{"txtdata":"v=spf1 include:old.example"}]' — снять старую SPF type="MX", replace='[{"exchange":"mx.yandex.net","preference":10}]' — заменить весь массив MX одной записью

Args: fqdn: Имя домена type: Тип записи (A, AAAA, MX, TXT, CNAME, NS) add: JSON-массив для добавления remove: JSON-массив для удаления replace: JSON-массив для полной замены этого типа force: Продолжить при наличии CAA/SRV

Все домены, привязанные к аккаунту.

Зарегистрировать виртуальный домен (без покупки).

Args: hostname: Имя домена (например: example.com) zone_id: ID доменной зоны (1 = .ru). Получить список: domain_zones

Убрать домен из аккаунта.

Args: domain_id: ID домена

Доступные доменные зоны (.ru, .com и пр.).

Все поддомены аккаунта.

Beget не отдаёт здесь www-алиасы, которые сам создаёт к поддомену (www.sub.site.ru к sub.site.ru): их нет ни в этом списке, ни в dns/getData. Записи такого имени смотреть через dns_get — он уходит на фолбэк к родительской зоне.

Текущая версия PHP на домене.

Args: full_fqdn: Полное имя домена (например: site.ru)

Переключить версию PHP для домена.

Args: full_fqdn: Полное имя домена (например: site.ru) php_version: Версия PHP (например: 8.1, 8.2, 8.3)

Создать поддомен на базе существующего домена.

subdomain — ТОЛЬКО префикс (blog), без родителя. Родитель задаётся через domain_id (см. domain_list). Полный FQDN (blog.site.ru) будет отклонён.

ВНИМАНИЕ: Beget не создаёт пустую сущность. Сразу после создания у поддомена появляются собственные записи — A на shared-хостинг Beget плюс MX и TXT(SPF) на beget.com. Имя начинает резолвиться на shared-хостинг ДО вашей A-записи, а MX и SPF переживают dns_set_a (тот мерджит зону) и остаются молча. Ответ тула показывает фактически созданные записи в поле records.

Args: subdomain: Имя поддомена (например: blog) domain_id: ID родительского домена

Убрать поддомен.

Args: subdomain_id: ID поддомена

Проверка доступности домена для покупки.

Args: hostname: Имя домена (например: example) zone_id: ID доменной зоны period: Период регистрации в годах (по умолчанию 1)

Пользовательские PHP-директивы домена.

Args: full_fqdn: Полное имя домена (например: site.ru)

Задать PHP-директивы для домена.

Args: full_fqdn: Полное имя домена directives: JSON-массив директив, например: [{"name": "max_execution_time", "value": "60"}]

Снять PHP-директивы с домена.

Args: full_fqdn: Полное имя домена directives: JSON-массив директив, например: [{"name": "max_execution_time", "value": "60"}]

Все FTP-аккаунты на хостинге.

Добавить FTP-аккаунт. Итоговый логин: login_suffix.

Args: suffix: Суффикс логина homedir: Домашняя директория (например: site.ru/public_html) password: Пароль FTP

Убрать FTP-аккаунт.

Args: suffix: Суффикс логина FTP

Сменить пароль FTP-аккаунта.

Args: suffix: Суффикс логина FTP password: Новый пароль

Почтовые ящики на указанном домене.

Args: domain: Домен (например: site.ru)

Добавить почтовый ящик.

Args: domain: Домен (например: site.ru) mailbox: Имя ящика (часть до @) password: Пароль

Сменить пароль почтового ящика.

Args: domain: Домен (например: site.ru) mailbox: Имя ящика (часть до @) password: Новый пароль

Убрать почтовый ящик.

Args: domain: Домен mailbox: Имя ящика (часть до @)

Настройки почтового ящика: спам-фильтр и пересылка.

Args: domain: Домен mailbox: Имя ящика spam_filter_status: 1 = включить спам-фильтр, 0 = выключить (-1 = не менять) spam_filter: Уровень фильтрации (-1 = не менять) forward_mail_status: no_forward / forward / forward_and_delete (пусто = не менять)

Включить пересылку на указанный адрес.

Args: domain: Домен mailbox: Имя ящика forward_mailbox: Email для пересылки

Снять пересылку на указанный адрес.

Args: domain: Домен mailbox: Имя ящика forward_mailbox: Email для удаления из пересылки

Адреса пересылки для ящика.

Args: domain: Домен mailbox: Имя ящика

Назначить catch-all ящик для домена.

Args: domain: Домен domain_mailbox: Имя ящика, на который будет приходить вся почта домена

Отключить catch-all для домена.

Args: domain: Домен

Прописать MX и SPF для Яндекс 360 одним вызовом.

Ставит:

• MX: mx.yandex.net, preference 10 (заменяет существующие MX)

• TXT SPF: v=spf1 redirect=_spf.yandex.net (заменяет существующую SPF, прочие TXT — DKIM, верификации — сохраняются)

DKIM Яндекс настраивается отдельно (Я.Почта для домена → DKIM), там выдаётся ключ для mail._domainkey.<домен>. После получения ключа — dns_set_txt на соответствующий поддомен (либо сначала domain_add_subdomain).

Не трогает A-записи, NS и прочие TXT. Если в зоне есть CAA/SRV — потребует force=True (они будут удалены).

Args: fqdn: Имя домена (site.ru) force: Продолжить при наличии CAA/SRV

Прописать MX и SPF для Mail.ru для бизнеса одним вызовом.

Ставит:

• MX: emx.mail.ru, preference 10

• TXT SPF: v=spf1 redirect=_spf.mail.ru (прочие TXT сохраняются)

DKIM настраивается в панели Mail.ru для бизнеса — ключ кладётся на mailru._domainkey.<домен>.

Не трогает A-записи, NS и прочие TXT. Если в зоне есть CAA/SRV — потребует force=True.

Args: fqdn: Имя домена force: Продолжить при наличии CAA/SRV

Все базы данных MySQL на аккаунте.

Добавить базу MySQL. Итоговое имя: login_suffix.

Args: suffix: Суффикс имени БД password: Пароль для доступа к БД

Убрать базу данных MySQL.

Args: suffix: Суффикс имени БД

Сменить пароль к базе MySQL.

Args: suffix: Суффикс имени БД password: Новый пароль access: Хост доступа (по умолчанию localhost)

Открыть доступ к базе MySQL с указанного хоста.

Args: suffix: Суффикс имени БД access: Откуда разрешить доступ (IP, домен, localhost или * для всех) password: Пароль (минимум 6 символов)

Отозвать доступ к базе MySQL с указанного хоста.

Args: suffix: Суффикс имени БД access: Хост доступа для удаления (IP, домен, localhost или *)

Все сайты аккаунта и связанные с ними домены.

Зарегистрировать сайт. В файловой системе появится каталог name/public_html.

Args: name: Имя сайта (латиницей)

Убрать сайт из аккаунта.

Args: site_id: ID сайта (получить через site_list)

Назначить домен для сайта.

Args: site_id: ID сайта domain_id: ID домена

Снять привязку домена от сайта.

Args: domain_id: ID домена

Блокировка изменений файлов сайта. Активируется в течение 5-10 минут.

Args: site_id: ID сайта excluded_paths: Пути-исключения, где изменения останутся разрешены

Снять блокировку изменений файлов сайта. Активируется в течение 5-10 минут.

Args: site_id: ID сайта

Статус блокировки файлов сайта.

Args: site_id: ID сайта