Обновить SRV запись

Для того, чтобы обновить существующую SRV запись на наших DNS серверах, необходимо отправить PUT запрос по адресу https://api.1cloud.ru/dns/recordsrv/{id}, где {id} - уникальный идентификатор записи.

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


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

НазваниеТипОписание
idstringУникальный идентификатор обновляемой записи

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 PUT -H 'Content-Type: application/json' -H 'Authorization: Bearer 75bb9805c018b1267b2cf599a38b95a3a811e2ef7ad9ca5ed838ea4c6bafaf50' "https://api.1cloud.ru/dns/recordsrv/1" -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." 
  }
]