Получение списка фэйловер-записей - Документация по API

Метод HTTP

GET

URL ресурса

https://api.zilore.com/dns/v1/domains/{domain_name}/failovers

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

Параметр	Описание
domain_name	Доменное имя. Должно соответствовать стандарту. Имена национальных доменов должны передаваться в Punycode формате.

Дополнительные параметры

Параметр	Описание
offset	Пропуск заданного количества записей в ответе
limit	Ограничение количества записей в ответе
order_by	Параметр сортировки, принимает значение: record_id — Идентификатор записи idn_record_name — Имя записи в Unicode формате record_type — Тип записи record_value — Значение записи в Unicode формате failover_check_type — Тип проверки failover_check_interval — Интервал проверки failover_return_to_main_value — Флаг возврата на главное значение
order_param	Параметр сортировки, принимает значение: asc — по алфавиту / возрастанию (A-Z) desc — по алфавиту в обратном порядке / убыванию (Z-A)

Поля ответа

Параметр	Описание
record_id	Идентификатор родительской записи
record_name	Имя записи в Unicode формате
record_type	Тип записи: A — Устанавливает соответствие между доменным именем/субдоменом и его IPv4-адресом
record_value	Исходное значение записи (по умолчанию) в Unicode формате
record_ttl	Максимальное разрешенное время кеширования записи
geo_region	GEO-идентификатор записи
geo_full_region	Полное название GEO-региона
record_active_value	Текущее активное значение записи в Unicode формате
record_value_status	Статус проверки значения по умолчанию (0\|1)
failover_check_type	Тип проверки
failover_check_interval	Интервал проверки
failover_return_to_main_value	Возврат к основной записи при восстановлении доступа к ней (0 - выкл, 1 - вкл)
failover_notification_email	Email адреса для уведомлений о сбоях через запятую
failover_notification_sms	Телефоны для уведомлений о сбоях по SMS через запятую
failover_use_fws	Можно ли использовать FWS в качесте failover для данной записи
failover_fws_active	Активен ли FWS в данный момент для этой записи
failover_additional_port	Порт для запроса (TCP-проверка)
failover_additional_request	Запрос для передачи серверу (TCP-проверка)
failover_additional_response	Ожидаемый ответ (TCP-проверка)
failover_record_backups	Массив резеврных значений записи из объектов с полями status и value
failover_record_backups.status	Статус проверки резервного значения (0\|1)
failover_record_backups.value	Резервное значение в Unicode формате

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

GET https://api.zilore.com/dns/v1/domains/example.com/failovers
X-Auth-Key: 6fac94db-691b-ec08-d22c-00000b7c06c0

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

{
"status": "ok",
"response": [{
"record_id": "65483",
"record_name": "test.example.com",
"record_type": "A",
"record_ttl": "60",
"geo_region": null,
"geo_full_region": "",
"record_value": "176.58.124.228",
"record_active_value": "176.58.124.228",
"record_value_status": "0",
"failover_check_type": "HTTP",
"failover_check_interval": "60",
"failover_return_to_main_value": "1",
"failover_record_backups": [],
"failover_notification_email": "",
"failover_notification_sms": "",
"failover_use_fws": "1",
"failover_fws_active": true,
"failover_additional_port": 0,
"failover_additional_request": 0,
"failover_additional_response": 0
}]
}