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

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

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

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

НазваниеТипОписание

DomainId

number

Уникальный идентификатор домена.

Service

string

Символьное имя сервиса.

Proto

number

Транспортный протокол используемый сервисом. Может содержать следующие значения:
  • tcp
  • udp
  • tls

Name

string

Доменное имя, для которого эта запись действует.

Priority

string

Приоритет целевого хоста.

Weight

string

Относительный вес для записей с одинаковым приоритетом.

Port

string

Порт на котором работает сервис.

Target

string

Канонические имя машины, предоставляющей сервис.

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/recordsrv" -d '{"DomainId":"1", "Name":"Name", "Proto":"protocol", "Service":"service", "Priority":"priority", "Weight":"weight", "Port":"port", "Target":"target", "TTL":"ttl"}'

Request Header

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

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

[
  {
    "ID":"9",
    "TypeRecord":"SRV",
    "HostName":"hostname.test.ru.",
    "Priority":"1",
    "Weight":"1",
    "Port":"44000",
    "Proto":"tcp",
    "Service":"sip.",
    "State":"New",
    "TTL":"3600",
    "Target":"sip.test.ru.",
    "CanonicalDescription":"_sip._tcp.hostname.test.ru. 3600 IN SRV 1 1 44000 sip.test.ru." 
  }
]