Войти

Добавление GEO-записи

Метод HTTP

POST

URL ресурса

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

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

Параметр

Описание

domain_name

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

record_name

Имя записи. Должно соответствовать стандарту. Имена национальных доменов должны передаваться в Punycode формате. Обязательно должно содержать в себе доменное имя. Например: foo.example.com, при добавлении записи в домен example.com.

record_type

Тип записи:

  • A — Устанавливает соответствие между доменным именем/субдоменом и его IPv4-адресом
  • AAAA — Устанавливает соответствие между доменным именем/субдоменом и его IPv6-адресом
  • CNAME — Устанавливает соответствие между субдоменом и другим доменным именем (не применимо для доменного имени непосредственно)
  • ALIAS — Устанавливает соответствие между доменным именем/субдоменом и другим доменным именем (применимо без ограничений)

geo_region

GEO-идентификатор записи из geo_records

record_value

Значение записи для региона. Должно соответствовать стандарту. Имена национальных доменов должны передаваться в Punycode формате. Формат значения зависит от типа записи.

Внимание! GEO-записи можно созать только со значениями record_name, record_type перечисленными в запросе geo_records

Форматы значений записей по типам:

  • A - Формат: IPv4 адрес,
    Пример: 203.0.113.1
  • AAAA - Формат: IPv6 адрес,
    Пример: 2001:0db8:0000:0000:0000:0000:0000:0000
  • CNAME - Формат: Доменное имя,
    Пример: www.example.com
  • ALIAS - Формат: Доменное имя,
    Пример: www.example.com

Поля ответа

Параметр

Описание

record_id

Идентификатор добавленной гео записи

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

POST https://api.zilore.com/dns/v1/domains/example.com/geo
X-Auth-Key: 6fac94db-691b-ec08-d22c-00000b7c06c0
Content-Type: application/x-www-form-urlencoded

record_name=a.example.com&record_type=A&record_value=1.1.1.100&geo_region=_NA

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

{
"status": "ok",
"response": {
"record_id": 65426,
"record_status": "added"
}
}