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

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

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

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

Название Тип Описание
idstringУникальный идентификатор обновляемой записи
DomainIdstringУникальный идентификатор домена
IPstringIPv6 адрес в формате XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX:XXXX
NamestringДоменное имя или симовол "@"

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/recordaaaa/1" -d '{"DomainId":"1", "IP":"3fff:ffff:ffff:ffff:ffff:ffff:ffff:ffff", "Name":"@"}'

Request Header

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

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

[
  {
    "ID":"4",
    "TypeRecord":"AAAA",
    "IP":"3fff:ffff:ffff:ffff:ffff:ffff:ffff:ffff",
    "HostName":"@",
    "Priority":"",
    "Text":"",
    "MnemonicName":"",
    "ExtHostName":"",
    "State":"New",
    "TTL":"3600",
    "CanonicalDescription":"@ 3600 IN AAAA 3fff:ffff:ffff:ffff:ffff:ffff:ffff:ffff"
  }
]