Создать новый домен

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

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

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

Название Тип Описание
DomainNamestringНазвание домена (пример: 1cloud.ru)
MigrateboolЭто процесс автоматического переноса существующих записей доменной зоны на DNS-серверы 1cloud. В ходе автоматической миграции мы попытаемся найти и перенести на DNS-серверы 1cloud все существующие записи для указанного Вами домена и его поддоменов
  1. true: произвести миграцию
  2. false: просто добавить доменную зону

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

Название Тип Описание
IDnumberУникальный идентификатор домена
NamestringНаименование домена
TechNamestringТехническое наименование домена
StatestringСтатус домена на момент обработки запроса. Может содержать следующие значения:
  1. New: создание домена на DNS 1cloud
  2. Active: домен активен
DateCreateDateTimeДата создания домена
IsDelegatestringСостояние делегирования доменного имени под управление dns серверами 1cloud
  1. true: домен делегирован
  2. false: домен не делегирован
  3. null: нет информации о делегировании
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. Дата создания записи
  17. CanonicalDescription: каноническое описание dns записи

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

curl -X POST -H 'Content-Type: application/json' -H 'Authorization: Bearer 75bb9805c018b1267b2cf599a38b95a3a811e2ef7ad9ca5ed838ea4c6bafaf50' "https://api.1cloud.ru/dns" -d '{"DomainName":"test.ru"}'

Request Header

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

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

[
  {
    "ID":1,
    "Name":"test.ru",
    "TechName":"test_ru",
    "State":"New",
    "IsDelegate":"true",
    "LinkedRecords":[]
  }
]