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

Как отредактировать SOA-запись основной зоны через UI, API или импорт файла зоны.

О SOA-записи

Для каждой созданной вами основной DNS-зоны наша система автоматически добавит SOA-запись.

SOA-запись (Start of Authority) — это обязательная служебная DNS-запись, которая описывает, кто управляет DNS-зоной домена и как эта зона синхронизируется между серверами.

Проще говоря, это что-то вроде паспорта вашей зоны с самой важной информацией о ней. Такой «паспорт» есть у каждой зоны в интернете. Там указаны:

  • Серийный номер зоны

  • Основной (авторитетный) DNS-сервер — «источник правды» зоны, хранит её исходную версию

  • Почта ответственного за зону администратора

  • Частота обновления зоны для резервных DNS-серверов

  • Время кэширования отрицательных ответов (ответов, что запрошенная запись не существует)

  • TTL SOA-записи

Параметры

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

Параметр Что значит Значение по умолчанию

Серийный номер

Номер версии DNS-зоны.

Меняется при каждом изменении записей. Используется резервными серверами — по изменению номера они понимают, что зону нужно обновить.

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

Номер пишется в формате ГГГГММДДNN, где ГГГГММДД – текущая дата, а NN – номер изменения за этот день (начиная с 01). Например, если создали зону 12 января 2026 года, серийный номер по умолчанию будет 2026011201.

Как только внесёте изменения в записи зоны, номер обновится автоматически.

Основной сервер имён

Основной (авторитетный) DNS-сервер — он хранит исходную версию зоны

ns1.servicepipe.ru

Почта ответственного лица

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

support.servicepipe.ru

Интервал обновления

Как часто резервные серверы должны проверять обновления зоны

86400 (1 день)

Интервал повтора

Через какое время резервный сервер должен пытаться снова обновить зону, если предыдущая попытка закончилась ошибкой

900 (15 минут)

Время истечения

Как долго резервные серверы могут продолжать обслуживать зону после последнего успешного обновления

691200 (8 дней)

Минимальный TTL

Как долго кэшируется отрицательный ответ (ответ, что запрошенной записи не существует)

3600 (1 час)

TTL записи

Время жизни SOA-записи

3600 (1 час)

Редактировать

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

Через UI

  1. Откройте DNS-хостинг → Основные зоны.

    SOA Record Management upd 1

  2. Выберите нужную зону и нажмите напротив неё …​ → Редактировать SOA-запись.

    SOA Record Management upd 2

  3. Отредактируйте нужные поля и нажмите Сохранить

    SOA Record Management upd 3

Поздравляем, вы отредактировали запись!

Через API

Отправьте PATCH-запрос с нужными параметрами SOA-записи.

Для доступа к API вам нужен API-токен. Чтобы получить его, воспользуйтесь инструкцией из статьи Управление API-ключами.

Запрос

Метод

PATCH /api/v1/dns/resource/primary/{id}/rrsets/soa

Параметры URL

Параметр Описание

{id}

Идентификатор вашей DNS-зоны

Заголовки

Заголовок Значение

Authorization

Bearer <ваш_api_токен>

Content-Type

application/json

Тело запроса

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

Поле Тип Пример значения Описание

ttl

number

3600

Время жизни SOA-записи (в секундах)

mname

string

ns1.example.ru

Доменное имя основного DNS-сервера зоны (NS-запись)

rname

string

support.example.ru

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

refresh

number

86400

Как часто резервные серверы должны проверять обновления зоны (в секундах)

retry

number

900

Через какое время резервный сервер должен пытаться снова обновить зону, если предыдущая попытка закончилась ошибкой (в секундах)

expire

number

691200

Как долго резервные серверы могут продолжать обслуживать зону после последнего успешного обновления (в секундах)

minimumTtl

number

3600

Как долго кэшируется отрицательный ответ (в секундах)

Параметр serial изменить нельзя — его значение всегда устанавливается системой автоматически.

Пример запроса

curl --request PATCH \
     --url 'https://api.servicepipe.ru/api/v1/dns/resource/primary/<id вашей зоны>/rrsets/soa' \
     --header 'Authorization: Bearer <ваш_api_токен>' \
     --header 'Content-Type: application/json' \
     --data '{
       "ttl": 3600,
       "mname": "ns1.example.ru",
       "rname": "support.example.ru",
       "refresh": 86400,
       "retry": 900,
       "expire": 691200,
       "minimumTtl": 3600
     }'

Ответ

При успешном запросе сервер вернёт статус 200 OK и JSON-объект с обновлённой SOA-записью. Пример ответа:

{
  "name": "example.com.",
  "rtype": "SOA",
  "ttl": 3600,
  "mode": "OFF",
  "records": [
    {
      "data": "ns1.example.ru support.example.ru 2 86400 900 691200 3600",
      "keys": []
    }
  ]
}

В случае ошибки сервер вернёт такой ответ:

{
  "statusCode": 400,
  "message": "Bad Request Exception"
}

Импорт файла зоны

Вы можете импортировать файл зоны с готовыми DNS-записями. Если в файле будет SOA-запись, её параметры заменят текущие. Не изменится только значение serial — его наша система устанавливает сама автоматически.

Импортировать через UI или API поможет инструкция: Импорт файла зоны.