DNS
- Получение списка DNS-зон
- Создание DNS-зоны
- Получение информации о DNS-зоне
- Обновление DNS-зоны
- Удаление DNS-зоны
- Получение списка записей в DNS-зоне
Получение списка DNS-зон
URL: /api/v1/dns/zones/
Метод: GET
Результат: JSON
Параметры запроса
Необязательные параметры:
offset
:int
- Индекс первой строки выборки, начиная с 0limit
:int
- Количество элементов в выборке в диапазоне от 10 до 100
Коды ответов
Код | Описание |
---|---|
200 | Успешный запрос |
Возвращаемое значение
count
:int
- Количество элементовentities
- Список dns-зонid
:int
- Идентификатор зоныname
:str
- Доменное имя зоныcomment
:str
- Комментарий к зонеrecords_count
:int
- Количество записей в зонеttl
:int
- Время обновления (TTL) записей в DNSsoa_email
:str
- Электронная почта для SOA-записи в DNSis_in_transfer
:bool
- Находится ли зона в процессе передачи на другой аккаунтis_technical_zone
:bool
- Размещена ли зона на техническом доменеsecondary_dns
:Список str
- IP-адреса вторичных (Secondary) DNS-серверов
Пример запроса
curl --request GET 'https://api-ms.netangels.ru/api/v1/dns/zones/' \
--header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"
Создание DNS-зоны
URL: /api/v1/dns/zones/
Метод: POST
Результат: JSON
Параметры тела запроса
Обязательные параметры:
name
:str
- Название DNS-зоны
Необязательные параметры:
soa_email
:str
- Электронная почта для SOA-записи в DNSttl
:int
- Время обновления (TTL) записей в DNS
Коды ответов
Код | Описание |
---|---|
201 | Успешный запрос |
400 | Данные в запросе имеют неверный формат или отсутствуют обязательные параметры |
Возвращаемое значение
DNS-зона
id
:int
- Идентификатор зоныname
:str
- Доменное имя зоныcomment
:str
- Комментарий к зонеrecords_count
:int
- Количество записей в зонеttl
:int
- Время обновления (TTL) записей в DNSsoa_email
:str
- Электронная почта для SOA-записи в DNSis_in_transfer
:bool
- Находится ли зона в процессе передачи на другой аккаунтis_technical_zone
:bool
- Размещена ли зона на техническом доменеsecondary_dns
:Список str
- IP-адреса вторичных (Secondary) DNS-серверов
Пример запроса
curl --request POST 'https://api-ms.netangels.ru/api/v1/dns/zones/' \
--header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
--header "Content-Type: application/json" \
--data '{
"name": "example.com",
"soa_email": "hostmaster@example.com",
"ttl": 1800
}'
Получение информации о DNS-зоне
URL: /api/v1/dns/zones/{id}/
Метод: GET
Результат: JSON
Параметры запроса
Обязательные параметры:
id
:int
- Идентификатор DNS-зоны
Коды ответов
Код | Описание |
---|---|
200 | Успешный запрос |
404 | DNS-зона не найдена |
Возвращаемое значение
DNS-зона
id
:int
- Идентификатор зоныname
:str
- Доменное имя зоныcomment
:str
- Комментарий к зонеrecords_count
:int
- Количество записей в зонеttl
:int
- Время обновления (TTL) записей в DNSsoa_email
:str
- Электронная почта для SOA-записи в DNSis_in_transfer
:bool
- Находится ли зона в процессе передачи на другой аккаунтis_technical_zone
:bool
- Размещена ли зона на техническом доменеsecondary_dns
:Список str
- IP-адреса вторичных (Secondary) DNS-серверов
Пример запроса
curl --request GET 'https://api-ms.netangels.ru/api/v1/dns/zones/{id}/' \
--header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"
Обновление DNS-зоны
URL: /api/v1/dns/zones/{id}/
Метод: POST
Результат: JSON
Параметры запроса
Обязательные параметры:
id
:int
- Идентификатор DNS-зоны
Параметры тела запроса
Необязательные параметры:
name
:str
- Название DNS-зоныsoa_email
:str
- Электронная почта для SOA-записи в DNSttl
:int
- Дефолтное время обновления (TTL) записей в DNScomment
:str
- Комментарийsecondary_dns
:Список IP
- IP-адреса вторичных (Secondary) DNS-серверов
Коды ответов
Код | Описание |
---|---|
200 | Успешный запрос |
400 | Данные в запросе имеют неверный формат или отсутствуют обязательные параметры |
404 | DNS-зона не найдена |
Возвращаемое значение
DNS-зона
id
:int
- Идентификатор зоныname
:str
- Доменное имя зоныcomment
:str
- Комментарий к зонеrecords_count
:int
- Количество записей в зонеttl
:int
- Время обновления (TTL) записей в DNSsoa_email
:str
- Электронная почта для SOA-записи в DNSis_in_transfer
:bool
- Находится ли зона в процессе передачи на другой аккаунтis_technical_zone
:bool
- Размещена ли зона на техническом доменеsecondary_dns
:Список str
- IP-адреса вторичных (Secondary) DNS-серверов
Пример запроса
curl --request POST 'https://api-ms.netangels.ru/api/v1/dns/zones/{id}/' \
--header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY" \
--header "Content-Type: application/json" \
--data '{
"name": "example.com",
"soa_email": "hostmaster@example.com",
"ttl": 1800,
"comment": "Комментарий к DNS-зоне",
"secondary_dns": ["127.0.0.1"]
}'
Удаление DNS-зоны
URL: /api/v1/dns/zones/{id}/
Метод: DELETE
Результат: JSON
Параметры запроса
Обязательные параметры:
id
:int
- Идентификатор DNS-зоны
Коды ответов
Код | Описание |
---|---|
200 | Успешный запрос |
404 | DNS-зона не найдена |
Возвращаемое значение
DNS-зона
id
:int
- Идентификатор зоныname
:str
- Доменное имя зоныcomment
:str
- Комментарий к зонеrecords_count
:int
- Количество записей в зонеttl
:int
- Время обновления (TTL) записей в DNSsoa_email
:str
- Электронная почта для SOA-записи в DNSis_in_transfer
:bool
- Находится ли зона в процессе передачи на другой аккаунтis_technical_zone
:bool
- Размещена ли зона на техническом доменеsecondary_dns
:Список str
- IP-адреса вторичных (Secondary) DNS-серверов
Пример запроса
curl --request DELETE 'https://api-ms.netangels.ru/api/v1/dns/zones/{id}/' \
--header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"
Получение списка записей в DNS-зоне
URL: /api/v1/dns/zones/{id}/records/
Метод: GET
Результат: JSON
Параметры запроса
Обязательные параметры:
id
:int
- Идентификатор DNS-зоны
Необязательные параметры:
offset
:int
- Индекс первой строки выборки, начиная с 0limit
:int
- Количество элементов в выборке в диапазоне от 10 до 100
Коды ответов
Код | Описание |
---|---|
200 | Успешный запрос |
404 | DNS-зона не найдена |
Возвращаемое значение
count
:int
- Количество элементовentities
- Список 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
- Вес
- A-запись
Пример запроса
curl --request GET 'https://api-ms.netangels.ru/api/v1/dns/zones/{id}/records/' \
--header "Authorization: Bearer EhFf68LM0Mot7jmvdxMp64Ua0Bd4iCzIVLMcuhxUC1Ox7.8UrjAkXmguoYDQBPnliwZUOWedf3Z21BNHYetkph7XwdSHLapAfDYAwfqWmYUtAY.2ZfFJid0s7bmyVOoLdjClW8wh13AWmvLuNfY"