Создать NS запись

Для того, чтобы создать новую запись на DNS серверах 1cloud, необходимо отправить POST запрос по адресу https://api.1cloud.ru/dns/recordns.

Ответом будет JSON объект, данный объект будет содержать все атрибуты домена к которому добавлена запись.

Входные параметры

Название Тип Описание
DomainIdstringУникальный идентификатор домена
HostNamestringДоменное имя или @
NamestringДоменное имя NS сервера

TTL

string

Длительность кэширования записи в секундах. Может содержать следующие значения:
  • 60
  • 300
  • 600
  • 900
  • 1800
  • 3600
  • 7200
  • 21160
  • 43200
  • 86400

Выходные параметры

Название Тип Описание
IDnumberУникальный идентификатор домена
NamestringНаименование домена
TechNamestringТехническое наименование домена
StatestringСтатус домена на момент обработки запроса. Может содержать следующие значения:
  1. New: создание домена на DNS 1cloud
  2. Active: домен активен
DateCreateDateTimeДата создания домена
LinkedRecordslistСписок записей, которые ассоциированы с данным доменом. Содержит список объектов, каждый из которых имеет следующие атрибуты:
  1. ID: уникальный идентификатор записи
  2. TypeRecord: тип записи, может содержать следующие значения: A, AAAA, MX, CNAME, TXT, NS, SRV
  3. IP: IP адрес
  4. HostName: @ - если запись создана для домена, или наименование поддомена, если запись создана для него
  5. Priority: приоритет записи, актуально только для MX и SRV записей
  6. Text: текст записи, актуально только для TXT записей
  7. MnemonicName: мнемоническое имя, актуально только для CNAME записей
  8. ExtHostName: наименование внешнего к 1cloud хоста, актуально для MX или NS записей
  9. Weight: относительный вес для записей с одинаковым приоритетом, актуально для SRV записей
  10. Port: порт на котором работает сервис, актуально для SRV записей
  11. Target: канонические имя машины, предоставляющей сервис, актуально для SRV записей
  12. Proto: транспортный протокол используемый сервисом, актуально для SRV записей
  13. Service: символьное имя сервиса, предоставляющей сервис, актуально для SRV записей
  14. TTL: Длительность кэширования записи, в секундах
  15. State:
    1. New: создание записи на DNS 1cloud
    2. Active: запись активна
  16. Дата создания записи

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

curl -X POST -H 'Content-Type: application/json' -H 'Authorization: Bearer 75bb9805c018b1267b2cf599a38b95a3a811e2ef7ad9ca5ed838ea4c6bafaf50' "https://api.1cloud.ru/dns/recordns" -d '{"DomainId":"1", "Name":"hostname.ns"}'

Request Header

Content-Type: application/json Authorization: Bearer 75bb9805c018b1267b2cf599a38b95a3a811e2ef7ad9ca5ed838ea4c6bafaf50

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

[
  {
    "ID":"8",
    "TypeRecord":"NS",
    "IP":"",
    "HostName":"@",
    "Priority":"",
    "Text":"",
    "MnemonicName":"",
    "ExtHostName":"hostname.ns.",
    "State":"New",
    "TTL":"3600",
    "CanonicalDescription":"@ 3600 IN NS hostname.ns." 
  }
]