Список доменов(зон)

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

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

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

Название Тип Описание
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 GET -H 'Content-Type: application/json' -H 'Authorization: Bearer 75bb9805c018b1267b2cf599a38b95a3a811e2ef7ad9ca5ed838ea4c6bafaf50' "https://api.1cloud.ru/Dns"

Request Header

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

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

[
  {
    "ID":1,
    "Name":"test.ru",
    "TechName":"test_ru",
    "State":"New",
    "IsDelegate":"true",
    "LinkedRecords":
    [
      {
        "ID":"1",
        "TypeRecord":"A",
        "IP":"1.1.1.1",
        "HostName":"@",
        "Priority":"",
        "Text":"",
        "MnemonicName":"",
        "ExtHostName":"",
        "State":"New",
        "TTL":"3600",
        "CanonicalDescription":"test.ru 3600 IN A 1.1.1.1" 
      }
    ]
  },
  {
    "ID":2,
    "Name":"test2.ru",
    "TechName":"test2_ru",
    "State":"Active",
    "IsDelegate":"true",
    "LinkedRecords":
    [
      {
        "ID":"2",
        "TypeRecord":"A",
        "IP":"1.1.1.2",
        "HostName":"@",
        "Priority":"",
        "Text":"",
        "MnemonicName":"",
        "ExtHostName":"",
        "State":"Active",
        "TTL":"3600",
        "CanonicalDescription":"test2.ru 3600 IN A 1.1.1.2" 
      }
    ]
  }
]