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

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

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

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

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

TTL

string

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

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

Название Тип Описание
ID number Уникальный идентификатор домена
TypeRecord string Тип записи, может содержать следующие значения: A, AAAA, MX, CNAME, TXT, NS, SRV
IP number IP адрес
HostName string @ - если запись создана для домена, или наименование поддомена, если запись создана для него
Priority number Приоритет записи, актуально только для MX и SRV записей
Text string Текст записи, актуально только для TXT записей
MnemonicName  string Мнемоническое имя, актуально только для CNAME записей
ExtHostName string Наименование внешнего к 1cloud хоста, актуально для MX или NS записей
State string
  1. New: создание записи на DNS 1cloud
  2. Active: запись активна
DateCreate DateTime Дата создания записи
Service string Символьное имя сервиса, предоставляющей сервис, актуально для SRV записей
Proto string Транспортный протокол используемый сервисом, актуально для SRV записей
Weight number Относительный вес для записей с одинаковым приоритетом, актуально для SRV записей
TTL number Длительность кэширования записи, в секундах
Port number Порт, на котором работает сервис, актуально для SRV записей
Target string Канонические имя машины, предоставляющей сервис, актуально для SRV записей
CanonicalDescription string Каноническое описание

Пример запроса

curl -X PUT -H 'Content-Type: application/json' -H 'Authorization: Bearer 75bb9805c018b1267b2cf599a38b95a3a811e2ef7ad9ca5ed838ea4c6bafaf50' "https://api.1cloud.ru/dns/recordtxt/13408" -d '{"DomainId":"13408", "Name":"hostname", "TTL":"3600", "Text":"text_description"}'

Request Header

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

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

{
    "ID": 13408,
    "TypeRecord": "TXT",
    "IP": "",
    "HostName": "hostname.test.ru.",
    "Priority": "",
    "Text": "\"text_description\" ",
    "MnemonicName": "",
    "ExtHostName": "",
    "State": "New",
    "DateCreate": "2023-07-01T14:05:27.083",
    "Service": "",
    "Proto": "",
    "Weight": "",
    "TTL": 3600,
    "Port": "",
    "Target": "",
    "CanonicalDescription": "hostname.test.ru. 3600 IN TXT \"text_description\" ",
    "PunyName": "\"text_description\" "
}