Редактирование SOA-записи

Последние изменения: 28.02.2025

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.

  1. Авторизуйтесь в API Servicepipe.

  2. Для редактирования SOA-записи используйте API-запрос.

  3. В URL-запроса вместо {id} укажите идентификатор DNS-зоны (ресурса).

  4. В теле запроса передайте нужные параметры:

    1. ttl  время жизни (time to live) записи в секундах.

    2. mname  основная NS-запись зоны. Например, ns1.example.ru

    3. rname электронная почта администратора зоны. Например, [email protected]

    4. refresh периодичность запросов с резервных серверов на основные серверы для обновление информации о зоне (в секундах).

    5. retry  время ожидания повторного запроса на обновление информации о зоне в случае неудачи (в секундах).

    6. expire период в секундах, после которого информация о зоне на резервных серверах теряет актуальность.

    7. 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.

Помогла ли вам статья?