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

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

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

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

Название Тип Описание
DomainId string Уникальный идентификатор домена
Name string Доменное имя или символ "@"
Text string Текст

TTL

string

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

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

Название Тип Описание
ID number Уникальный идентификатор домена
Name string Наименование домена
TechName string Техническое наименование домена
State string Статус домена на момент обработки запроса. Может содержать следующие значения:
  1. New: создание домена на DNS 1cloud
  2. Active: домен активен
DateCreate DateTime Дата создания домена
LinkedRecords list Список записей, которые ассоциированы с данным доменом. Содержит список объектов, каждый из которых имеет следующие атрибуты:
  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/recordtxt" -d '{"DomainId":"1", "Name":"hostname", "TTL":"3600", "Text":"text_description"}'

Request Header

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

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

[
  {
    "ID":"9",
    "TypeRecord":"TXT",
    "IP":"",
    "HostName":"hostname.test.ru.",
    "Priority":"",
    "Text":"text_description",
    "Proto":"",
    "Service":"",
    "Weight":"",
    "TTL":"3600",
    "CanonicalDescription":"hostname.test.ru. 3600 IN TXT text_description" 
  }
]