DNS

• Создание DNS-записи
• Получение информации о DNS-записи
• Обновление DNS-записи
• Удаление DNS-записи

Создание DNS-записи

URL: /api/v1/dns/records/
Метод: POST
Результат: JSON

Обязательный параметр:

• type: str - Тип DNS-записи:
  • A
  • AAAA
  • CNAME
  • MX
  • TXT
  • CAA
  • SRV
  • NS

Список остальных параметров зависит от типа записи.

A-запись

Обязательные параметры:

• name: str – Название DNS-записи
• ip: IP – IPv4-адрес

Необязательные параметры:

• ttl: int – Время обновления (TTL) записи в DNS

AAAA-запись

Обязательные параметры:

• name: str – Название DNS-записи
• ip: IP – IPv6-адрес

Необязательные параметры:

• ttl: int – Время обновления (TTL) записи в DNS

MX-запись

Обязательные параметры:

• name: str – Название DNS-записи
• hostname: str – Имя хоста, получающего почту

Необязательные параметры:

• ttl: int – Время обновления (TTL) записи в DNS
• ip: str – IP-адрес почтового сервера
• priority: int – Приоритет MX-записи

TXT-запись

Обязательные параметры:

• name: str – Название DNS-записи
• value: str – Значение

Необязательные параметры:

• ttl: int – Время обновления (TTL) записи в DNS

CNAME-запись

Обязательные параметры:

• name: str – Название DNS-записи
• domain: str – Алиасом к какому домену является

Необязательные параметры:

• ttl: int – Время обновления (TTL) записи в DNS

NS-запись

Обязательные параметры:

• name: str – Название DNS-записи
• nameserver: str – Имя DNS-сервера

Необязательные параметры:

• ttl: int – Время обновления (TTL) записи в DNS

CAA-запись

Обязательные параметры:

• name: str – Название DNS-записи
• value: str – Значение
• flag: bool – Специальный флаг (RFC 8659, пункт 4.5):
  • False – Издатель сертификата может продолжить выпуск, если не смог обработать эту CAA-запись
  • True – Издатель сертификата обязан отклонить выпуск, если не смог обработать эту CAA-запись
• tag: str – Тег CAA-записи (RFC 8659, пункты 4.2-4.4):
  • Issue – Выпуск SSL-сертификатов разрешен для указанного в записи издателя
  • Issuewild – Выпуск Wildcard SSL-сертификатов разрешен для указанного в записи издателя
  • Iodef – В записи находится URL или адрес почты для сообщений об ошибках выпуска SSL

Необязательные параметры:

• ttl: int – Время обновления (TTL) записи в DNS

SRV-запись

Обязательные параметры:

• name: str – Название DNS-записи
• service: str – Сервис
• protocol: str – Протокол
• hostname: str – Доменное имя назначения
• priority: int – Приоритет
• weight: int – Вес
• port: int – Порт

Необязательные параметры:

• ttl: int – Время обновления (TTL) записи в DNS

Коды ответов

Код	Описание
201	Успешный запрос
400	Данные в запросе имеют неверный формат или отсутствуют обязательные параметры

Возвращаемое значение

DNS-запись

• id: int – Идентификатор записи
• zone_id: int – Идентификатор DNS-зоны, в которой находится запись
• name: str – Имя записи
• type: str – Тип записи:
  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • SRV
  • TXT
  • CAA
• details: Details – Данные (в зависимости от типа записи)
  • A-запись
    • ip: str – IPv4-адрес
  • AAAA-запись
    • ip: str – IPv6-адрес
  • MX-запись
    • hostname: str – Полное доменное имя почтового сервера
    • ip: str – IP-адрес сервера
    • priority: int – Приоритет
  • TXT-запись
    • value: str – Текст записи
  • CNAME-запись
    • domain: str – Алиасом к какому домену является
  • NS-запись
    • nameserver: str – Доменное имя авторитетного DNS-сервера
  • CAA-запись
    • value: str – Значение CAA-записи
    • tag: str – Тег CAA-записи (RFC 8659, пункты 4.2-4.4):
      • Issue – Выпуск SSL-сертификатов разрешен для указанного в записи издателя
      • Issuewild – Выпуск Wildcard SSL-сертификатов разрешен для указанного в записи издателя
      • Iodef – В записи находится URL или адрес почты для сообщений об ошибках выпуска SSL
    • flag: str – Специальный флаг (RFC 8659, пункт 4.5):
      • Default – Издатель сертификата может продолжить выпуск, если не смог обработать эту CAA-запись
      • IssuerCritical – Издатель сертификата обязан отклонить выпуск, если не смог обработать эту CAA-запись
  • SRV-запись
    • hostname: str – Доменное имя назначения
    • port: int – Порт
    • priority: int – Приоритет
    • protocol: str – Название протокола
    • service: str – Сервис
    • weight: int – Вес

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

curl --request POST 'https://api-ms.netangels.ru/api/v1/dns/records/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "name": "name.example.com", 
          "type": "A", 
          "ip": "127.0.0.1", 
          "ttl": 1800 
    }'

---

Получение информации о DNS-записи

URL: /api/v1/dns/records/{id}/
Метод: GET
Результат: JSON

Параметры запроса

Обязательные параметры:

• id: int – Идентификатор DNS-записи

Коды ответов

Код	Описание
200	Успешный запрос
404	DNS-запись не найдена

Возвращаемое значение

DNS-запись

• id: int – Идентификатор записи
• zone_id: int – Идентификатор DNS-зоны, в которой находится запись
• name: str – Имя записи
• type: str – Тип записи:
  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • SRV
  • TXT
  • CAA
• details: Details – Данные (в зависимости от типа записи)
  • A-запись
    • ip: str – IPv4-адрес
  • AAAA-запись
    • ip: str – IPv6-адрес
  • MX-запись
    • hostname: str – Полное доменное имя почтового сервера
    • ip: str – IP-адрес сервера
    • priority: int – Приоритет
  • TXT-запись
    • value: str – Текст записи
  • CNAME-запись
    • domain: str – Алиасом к какому домену является
  • NS-запись
    • nameserver: str – Доменное имя авторитетного DNS-сервера
  • CAA-запись
    • value: str – Значение CAA-записи
    • tag: str – Тег CAA-записи (RFC 8659, пункты 4.2-4.4):
      • Issue – Выпуск SSL-сертификатов разрешен для указанного в записи издателя
      • Issuewild – Выпуск Wildcard SSL-сертификатов разрешен для указанного в записи издателя
      • Iodef – В записи находится URL или адрес почты для сообщений об ошибках выпуска SSL
    • flag: str – Специальный флаг (RFC 8659, пункт 4.5):
      • Default – Издатель сертификата может продолжить выпуск, если не смог обработать эту CAA-запись
      • IssuerCritical – Издатель сертификата обязан отклонить выпуск, если не смог обработать эту CAA-запись
  • SRV-запись
    • hostname: str – Доменное имя назначения
    • port: int – Порт
    • priority: int – Приоритет
    • protocol: str – Название протокола
    • service: str – Сервис
    • weight: int – Вес

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

curl --request GET 'https://api-ms.netangels.ru/api/v1/dns/records/{id}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"

---

Обновление DNS-записи

URL: /api/v1/dns/records/{id}/
Метод: POST
Результат: JSON

Параметры запроса

Обязательные параметры:

• id: int – Идентификатор DNS-записи

A-запись

Необязательные параметры:

• name: str – Название DNS-записи
• ttl: int – Время обновления (TTL) записи в DNS
• ip: IP – IPv4-адрес

AAAA-запись

Необязательные параметры:

• name: str – Название DNS-записи
• ttl: int – Время обновления (TTL) записи в DNS
• ip: IP – IPv6-адрес

MX-запись

Необязательные параметры:

• name: str – Название DNS-записи
• ttl: int – Время обновления (TTL) записи в DNS
• hostname: str – Имя хоста, получающего почту
• ip: str – IP-адрес почтового сервера
• priority: int – Приоритет MX-записи

TXT-запись

Необязательные параметры:

• name: str – Название DNS-записи
• ttl: int – Время обновления (TTL) записи в DNS
• value: str – Значение

CNAME-запись

Необязательные параметры:

• name: str – Название DNS-записи
• ttl: int – Время обновления (TTL) записи в DNS
• domain: str – Алиасом к какому домену является

NS-запись

Необязательные параметры:

• name: str – Название DNS-записи
• ttl: int – Время обновления (TTL) записи в DNS
• nameserver: str – Имя DNS-сервера

CAA-запись

Необязательные параметры:

• name: str – Название DNS-записи
• ttl: int – Время обновления (TTL) записи в DNS
• value: str – Значение
• flag: bool – Специальный флаг (RFC 8659, пункт 4.5)
• tag: str – Тег CAA-записи (RFC 8659, пункты 4.2-4.4):
  • Issue – Выпуск SSL-сертификатов разрешен для указанного в записи издателя
  • Issuewild – Выпуск Wildcard SSL-сертификатов разрешен для указанного в записи издателя
  • Iodef – В записи находится URL или адрес почты для сообщений об ошибках выпуска SSL

SRV-запись

Необязательные параметры:

• name: str – Название DNS-записи
• ttl: int – Время обновления (TTL) записи в DNS
• service: str – Сервис
• protocol: str – Протокол
• hostname: str – Доменное имя назначения
• priority: int – Приоритет
• weight: int – Вес
• port: int – Порт

Коды ответов

Код	Описание
200	Успешный запрос
400	Данные в запросе имеют неверный формат или отсутствуют обязательные параметры
404	DNS-запись не найдена

Возвращаемое значение

DNS-запись

• id: int – Идентификатор записи
• zone_id: int – Идентификатор DNS-зоны, в которой находится запись
• name: str – Имя записи
• type: str – Тип записи:
  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • SRV
  • TXT
  • CAA
• details: Details – Данные (в зависимости от типа записи)
  • A-запись
    • ip: str – IPv4-адрес
  • AAAA-запись
    • ip: str – IPv6-адрес
  • MX-запись
    • hostname: str – Полное доменное имя почтового сервера
    • ip: str – IP-адрес сервера
    • priority: int – Приоритет
  • TXT-запись
    • value: str – Текст записи
  • CNAME-запись
    • domain: str – Алиасом к какому домену является
  • NS-запись
    • nameserver: str – Доменное имя авторитетного DNS-сервера
  • CAA-запись
    • value: str – Значение CAA-записи
    • tag: str – Тег CAA-записи (RFC 8659, пункты 4.2-4.4):
      • Issue – Выпуск SSL-сертификатов разрешен для указанного в записи издателя
      • Issuewild – Выпуск Wildcard SSL-сертификатов разрешен для указанного в записи издателя
      • Iodef – В записи находится URL или адрес почты для сообщений об ошибках выпуска SSL
    • flag: str – Специальный флаг (RFC 8659, пункт 4.5):
      • Default – Издатель сертификата может продолжить выпуск, если не смог обработать эту CAA-запись
      • IssuerCritical – Издатель сертификата обязан отклонить выпуск, если не смог обработать эту CAA-запись
  • SRV-запись
    • hostname: str – Доменное имя назначения
    • port: int – Порт
    • priority: int – Приоритет
    • protocol: str – Название протокола
    • service: str – Сервис
    • weight: int – Вес

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

curl --request POST 'https://api-ms.netangels.ru/api/v1/dns/records/{id}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
    --header "Content-Type: application/json" \
    --data '{
          "name": "name.example.com", 
          "ttl": 1800, 
          "ip": "127.0.0.1" 
    }'

---

Удаление DNS-записи

URL: /api/v1/dns/records/{id}/
Метод: DELETE
Результат: JSON

Параметры запроса

Обязательные параметры:

• id: int – Идентификатор DNS-записи

Коды ответов

Код	Описание
200	Успешный запрос
404	DNS-запись не найдена

Возвращаемое значение

DNS-запись

• id: int – Идентификатор записи
• zone_id: int – Идентификатор DNS-зоны, в которой находится запись
• name: str – Имя записи
• type: str – Тип записи:
  • A
  • AAAA
  • CNAME
  • MX
  • NS
  • SRV
  • TXT
  • CAA
• details: Details – Данные (в зависимости от типа записи)
  • A-запись
    • ip: str – IPv4-адрес
  • AAAA-запись
    • ip: str – IPv6-адрес
  • MX-запись
    • hostname: str – Полное доменное имя почтового сервера
    • ip: str – IP-адрес сервера
    • priority: int – Приоритет
  • TXT-запись
    • value: str – Текст записи
  • CNAME-запись
    • domain: str – Алиасом к какому домену является
  • NS-запись
    • nameserver: str – Доменное имя авторитетного DNS-сервера
  • CAA-запись
    • value: str – Значение CAA-записи
    • tag: str – Тег CAA-записи (RFC 8659, пункты 4.2-4.4):
      • Issue – Выпуск SSL-сертификатов разрешен для указанного в записи издателя
      • Issuewild – Выпуск Wildcard SSL-сертификатов разрешен для указанного в записи издателя
      • Iodef – В записи находится URL или адрес почты для сообщений об ошибках выпуска SSL
    • flag: str – Специальный флаг (RFC 8659, пункт 4.5):
      • Default – Издатель сертификата может продолжить выпуск, если не смог обработать эту CAA-запись
      • IssuerCritical – Издатель сертификата обязан отклонить выпуск, если не смог обработать эту CAA-запись
  • SRV-запись
    • hostname: str – Доменное имя назначения
    • port: int – Порт
    • priority: int – Приоритет
    • protocol: str – Название протокола
    • service: str – Сервис
    • weight: int – Вес

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

curl --request DELETE 'https://api-ms.netangels.ru/api/v1/dns/records/{id}/' \
    --header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"