Экспорт файла зоны

Экспорт файла DNS-зоны позволяет получить текстовый файл со всеми ресурсными записями вашего домена. Это необходимо для создания резервных копий, экстренного переноса на другую платформу или для массового редактирования записей с их последующим импортом.

Ограничения и права доступа

Следующие условия и ограничения являются общими для всех способов экспорта:

  • Частота запросов: Экспортировать одну и ту же зону можно не чаще, чем один раз в минуту. При превышении этого лимита вы увидите сообщение об ошибке с предложением повторить попытку позже.

  • Тип зоны: Экспорт доступен только для основных (primary) зон.

  • Права доступа: Возможность экспорта зависит от ролевой модели и может быть доступна не всем пользователям.

Способы экспорта

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

Экспорт через интерфейс панели управления

Это самый простой и быстрый способ получить файл зоны в несколько кликов. Инициировать экспорт можно из двух разделов: из общего списка зон или со страницы с записями конкретной зоны.

Способ 1: Из списка основных зон

  1. Перейдите в раздел DNS → Основные зоны в боковом меню.

  2. В списке зон найдите домен, который вы хотите экспортировать, и нажмите на иконку с тремя точками (…​) в конце его строки, чтобы открыть меню действий.

  3. В появившемся меню выберите опцию Экспортировать файл зоны.

    Меню действий для зоны с опцией экспорта

  4. В появившемся модальном окне с запросом: "Вы уверены, что хотите экспортировать файл зоны \{имя зоны}?" нажмите кнопку Экспортировать для подтверждения.

    Модальное окно подтверждения экспорта зоны

  5. Сразу после подтверждения появится уведомление "Экспорт файла DNS-зоны начался и скоро появится в загрузках вашего браузера", и на ваш компьютер начнется загрузка текстового файла.

Содержимое файла будет описано в формате BIND, файл будет сохранен с расширением .txt.

Экспорт через API

Вы также можете автоматизировать процесс экспорта, используя API Servicepipe.

Шаг 1. Авторизация в API

Для выполнения запросов необходим API-токен. Авторизуйтесь в API Servicepipe для его получения.

Шаг 2. Выполнение запроса на экспорт

Отправьте GET-запрос на указанный эндпоинт, чтобы получить файл зоны.

Метод: GET

URL:

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

Параметры URL: {id}:: Идентификатор вашей DNS-зоны (ресурса).

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

Шаг 3. Обработка ответа

В ответ на успешный запрос вы получите JSON-объект, содержащий одну строку attachment, в которой находится содержимое вашего файла зоны, закодированное в base64.

Пример ответа:

{
  "data": {
    "result": {
      "attachment": "ZXhhbXBsZS5ydS4gICAgICAgICAgIDM2MDAgICAgIElOIFNPQSAgbnMxLmV4YW1wbGUucnUuIGV4YW1wbGUucnUuIDQgODY0MDAgOTAwIDY5MTIwMCAzNjAwCmV4YW1wbGUucnUuICAgICAgICAgICAzNjAwICAgICBJTiBBICAgICAgIDEuMS4xLjEKZXhhbXBsGUucnUuICAgICAgICAgICAzNjAwICAgICBJTiBOUyAgIG5zMS5leGFtcGxlLnJ1LgpleGFtcGxlLnJ1LiAgICAgICAgICAgMzYwMCAgICAgSU4gTlMgICAgbnMyLmV4YW1wbGUucnUu"
    }
  }
}

Чтобы получить читаемый файл зоны в формате BIND, вам необходимо декодировать значение из поля attachment с помощью любого декодера base64.