SOA-запись (Start of Authority) — начальная запись зоны. SOA-запись содержит в себе контактную информацию лица, ответственного за зону, время кэширования информации на серверах, данные о взаимодействии DNS-серверов, номер версии зоны (serial).
Пример SOA-записи:
servicepipe.ru. 600 IN SOA ns1.servicepipe.ru. admin.servicepipe.ru. (
2024011043 ; serial
1440 ; refresh (24 minutes)
3600 ; retry (1 hour)
2592000 ; expire (4 weeks 2 days)
600 ; minimum (10 minutes)
)
SOA-запись является обязательной для зоны и создается автоматически при создании Основной зоны. Вы не можете удалить SOA-запись.
Редактирование SOA-записи
Возможность редактирования доступна только через API.
Авторизуйтесь в API Servicepipe.
Для редактирования SOA-записи используйте API-запрос.
В URL-запроса вместо {id} укажите идентификатор DNS-зоны (ресурса).
В теле запроса передайте нужные параметры:
ttl — время жизни (time to live) записи в секундах.
mname — основная NS-запись зоны. Например, ns1.example.ru
rname — электронная почта администратора зоны. Например, [email protected]
refresh — периодичность запросов с резервных серверов на основные серверы для обновление информации о зоне (в секундах).
retry — время ожидания повторного запроса на обновление информации о зоне в случае неудачи (в секундах).
expire — период в секундах, после которого информация о зоне на резервных серверах теряет актуальность.
minimumTtl — время кеширования информации о зоне (в секундах).
Метод | GET |
URL | https://api.servicepipe.ru/api/v1/dns/resource/primary/{id}/records/soa |
Заголовок | Bearer token |
Тело запроса | { "ttl": 3600, "mname": "ns1.servicepipe.ru", "rname": "[email protected]", "refresh": 86400, "retry": 900, "expire": 691200, "minimumTtl": 3600 } |
После успешного сохранения новых значений значение параметра serial SOA-записи автоматически увеличится на 1.