Управление SOA-записью

В этой статье подробно описаны параметры SOA-записи, которая автоматически создается для основной зоны, а также способы ее редактирования.

Описание SOA-записи

SOA-запись (Start of Authority) — начальная запись зоны, которая указывает на эталонный сервер с информацией о домене. Она содержит контактные данные ответственного администратора, серийный номер зоны и таймеры, управляющие взаимодействием между DNS-серверами.

SOA-запись является обязательной для зоны. Система создает ее автоматически при создании зоны. Эту запись нельзя удалить, но можно отредактировать ее параметры при необходимости.

Параметры SOA-записи по умолчанию

По умолчанию SOA-запись создается со следующими параметрами:

Параметр Значение по умолчанию Определение

Primary Name Server

ns1.servicepipe.ru.

Основной (мастер) DNS-сервер для этой зоны.

Responsible Person

support.servicepipe.ru.

Электронная почта администратора зоны (символ @ заменяется на точку .).

Serial Number

Генерируется автоматически

32-разрядное число, которое увеличивается при каждом изменении файла зоны. Servicepipe использует формат ГГГГММДДNN, где ГГГГММДД – текущая дата, а NN – порядковый номер изменения за этот день (начиная с 01). Например: 2025062701.

Refresh Interval

86400 (1 день)

Периодичность (в секундах), с которой вторичные DNS-серверы запрашивают обновление информации о зоне с основного сервера.

Retry Interval

900 (15 минут)

Время ожидания (в секундах) перед повторной попыткой запроса на обновление в случае неудачи.

Expire Time

691200 (8 дней)

Время (в секундах), в течение которого информация на вторичном сервере считается актуальной в случае полного отсутствия связи с основным сервером.

Minimum TTL

3600 (1 час)

Время жизни кеша для негативного ответа (NXDOMAIN) на запрос о несуществующей записи в этой зоне.

Способы редактирования SOA-записи

Отредактировать параметры SOA-записи можно двумя способами: через импорт файла зоны или с помощью прямого API-запроса.

Редактирование через импорт файла зоны

Вы можете изменить параметры SOA-записи, включив ее в файл зоны для импорта. При импорте система обновит все поля (такие как mname, rname и таймеры), кроме серийного номера (serial), который Servicepipe всегда устанавливает автоматически.

Подробнее о процессе и особенностях импорта читайте в статье Импорт файла зоны.

Редактирование через API

Вы можете напрямую изменить параметры SOA-записи, используя соответствующий метод API. Для выполнения запроса требуется авторизация по токену. Подробное описание метода доступно в документации по API.

Метод: PATCH

URL:

https://api.servicepipe.ru/api/v1/dns/resource/primary/\{id}/records/soa

Параметры URL: {id} (обязательный):: Идентификатор DNS-зоны.

Заголовки: Authorization:: Bearer {ваш_api_токен}

Тело запроса (application/json):

Поле

Тип

Описание

ttl

number

Время жизни записи в секундах.

mname

string

Основной NS-сервер зоны.

rname

string

Email администратора зоны.

refresh

number

Интервал обновления в секундах.

retry

number

Интервал повторной попытки в секундах.

expire

number

Время актуальности зоны в секундах.

minimumTtl

number

Минимальное время жизни кеша для негативных ответов.

Пример тела запроса:

{
  "ttl": 3600,
  "mname": "ns1.example.ru",
  "rname": "support@example.ru",
  "refresh": 86400,
  "retry": 900,
  "expire": 691200,
  "minimumTtl": 3600
}

Пример успешного ответа (200 OK):

{
  "data": "ns1.example.ru support.example.ru 2 86400 900 691200 3600",
  "name": "example.com",
  "rtype": "SOA",
  "ttl": 3600
}