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

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

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

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

Название Тип Описание
idstringУникальный идентификатор обновляемой записи
DomainIdstringУникальный идентификатор домена
NamestringКаноническое имя или симовол "@"
MnemonicNamestringМнемоническое имя

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/recordcname/1" -d '{"DomainId":"1", "Name":"@", "MnemonicName":"test"}'

Request Header

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

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

[
  {
    "ID":"5",
    "TypeRecord":"CNAME",
    "IP":"",
    "HostName":"@",
    "Priority":"",
    "Text":"",
    "MnemonicName":"test.test.ru.",
    "ExtHostName":"",
    "State":"New",
    "TTL":"3600",
    "CanonicalDescription":"test.test.ru. 3600 IN CNAME @" 
  }
]