Домены
Безопасность
Инструменты
Компания
USD
РУС

Внешний API

Добавление ресурсных DNS-записей

Позволяет добавить ресурсные DNS-записи для домена. Операция действует, только если домен делегирован одному из DNS-провайдеров, которыми управляет Regery

Параметры URL 

•︎ domain string 
Полное доменное имя FQDN

Параметры тела POST-запроса 

•︎ records object[] 
Массив ресурсных DNS-записей. Общие свойства всех записей перечислены ниже
•︎ name string 
Имя DNS-записи — это доменное имя, с которым связана конкретная DNS-запись. Это крайняя левая часть DNS-записи, указывающая хост или поддомен, к которому относится запись. Если имя относится к корневому (apex) домену и часть хоста/поддомена должна быть пустой, используется значение @.
•︎ type string 
Типы DNS-записей (Domain Name System) — это записи в файле DNS-зоны, которые сопоставляют доменные имена с IP-адресами или содержат другие виды информации.
•︎ ttl number | default = 3600 
DNS TTL (Time to Live) — время жизни записи в секундах. Это параметр DNS-записи, определяющий, как долго DNS-резолвер должен хранить информацию в кеше, прежде чем обновить её с авторитативных DNS-серверов. Задаётся в секундах и помогает управлять DNS-кешированием и обеспечивать эффективное разрешение имён в интернете. Минимальное значение: 60. Максимальное значение: 32767

Определения типов 

•︎ A object 

A — 32-битный адрес IPv4, обычно используется для указания соответствия между именем хоста и IP-адресом.

•︎ address string 
IPv4-адрес
•︎ AAAA object 

AAAA — 128-битный адрес IPv6, используется для указания соответствия между именем хоста и IP-адресом.

•︎ address string 
IPv6-адрес
•︎ CNAME object 

CNAME — тип ресурсной записи в системе доменных имён (DNS), который указывает, что данное имя является псевдонимом другого имени (канонического домена).

Запись CNAME всегда должна указывать на другое доменное имя, а не на IP-адрес.

Вся информация о других записях домена-псевдонима, включая записи MX и прочие, будет получена из канонического домена. Запись CNAME должна быть единственной записью для данного доменного имени, и по спецификации CNAME нельзя использовать для корневого домена зоны.

•︎ target string 
Полное доменное имя (FQDN). Значение может содержать @ для ссылки на корневое доменное имя. Например, для домена example.com цель CNAME www.@ будет отображаться как www.example.com.
•︎ MX object 

MX (почтовый сервис) — тип ресурсной записи в системе доменных имён (DNS), который указывает почтовые серверы, отвечающие за обработку почты для данного доменного имени, а также приоритет серверов, если их несколько.

•︎ priority number 
Поле priority задаёт порядок, в котором почтовые серверы используются для доставки почты на домен. Сначала используются серверы с меньшим значением приоритета, а если они недоступны — серверы с большим значением.
•︎ exchange string 
Поле exchange задаёт доменное имя почтового сервера, который принимает письма от имени домена.
•︎ TXT object 

TXT (текстовая запись) — тип ресурсной записи в системе доменных имён (DNS), который используется для указания дополнительной информации о домене; часто эти данные предназначены не только для программ, но и для людей.

Например, эта запись используется для задания политик SPF (Sender Policy Framework) для почтовых серверов.

•︎ value string 
Текстовые данные, связанные с записью. Они могут содержать любую информацию, которую владелец домена хочет добавить в DNS-запись. TXT-записи обычно используются для разных целей: подтверждения домена для почтовых сервисов, SPF-записей для аутентификации почты, DKIM-записей для защиты почты и другой текстовой информации, необходимой для настройки или подтверждения домена.
•︎ SRV object 

SRV (Service Record Value) часто используется для обнаружения сервисов, связанных с доменом. Эта запись содержит имя хоста, порт и другие данные, необходимые для обнаружения сервиса.

•︎ service string 
Символьное имя сервиса, для которого создаётся запись. Значение должно начинаться с символа подчёркивания _. Это поле определяет конкретный сервис или протокол, описываемый SRV-записью. Примеры распространённых имён сервисов в SRV-записях: «_sip» для сервисов SIP (Session Initiation Protocol), «_ldap» для сервисов LDAP (Lightweight Directory Access Protocol), «_xmpp» для сервисов XMPP (Extensible Messaging and Presence Protocol) и т. д.
•︎ proto string 
Транспортный протокол сервиса, описанного в записи. Значение должно начинаться с символа подчёркивания _, например _tcp. Это поле указывает, использует ли сервис для связи TCP (Transmission Control Protocol), UDP (User Datagram Protocol) или другой транспортный протокол.
•︎ priority number 
Приоритет целевого хоста в SRV-записи. Определяет порядок использования целевых хостов, если для сервиса доступно несколько хостов
•︎ weight number 
Используется вместе с полем priority для балансировки нагрузки между несколькими SRV-записями с одинаковым приоритетом. Поле «weight» задаёт относительный вес SRV-записи по сравнению с другими SRV-записями с тем же приоритетом
•︎ port number 
Номер порта TCP или UDP, на котором доступен указанный в записи сервис.
•︎ target string 
Доменное имя целевого хоста, предоставляющего сервис. Это поле содержит имя хоста сервера, который предоставляет указанный в SRV-записи сервис
•︎ CAA object 

CAA позволяет владельцу доменного имени DNS указать один или несколько центров сертификации (CA), которым разрешено выпускать сертификаты для домена.

•︎ value string 
Доменное имя центра сертификации (CA), которому разрешено выпускать SSL/TLS-сертификаты для соответствующего домена.
•︎ tag enum 
Тип свойства CAA-записи
issue определяет центры сертификации, которым разрешено выпускать сертификаты для домена
issuewild определяет центры сертификации, которым разрешено выпускать Wildcard-сертификаты для домена
iodef задаёт адрес электронной почты, на который центры сертификации должны сообщать о нарушениях политики
issuemail нестандартное расширение, разрешающее центру сертификации выпускать для домена сертификаты S/MIME (для электронной почты)
issuevmc нестандартное расширение, разрешающее центру сертификации выпускать сертификаты VMC (Verified Mark Certificates), которые позволяют показывать логотип бренда в почтовых клиентах с поддержкой BIMI (Brand Indicators for Message Identification)
•︎ NS object 

NS — этот тип записи указывает авторитативный DNS-сервер для доменного имени (на этом сервере хранятся актуальные DNS-записи). Часто домен делегирован нескольким DNS-серверам и имеет несколько записей NS, указывающих на основной и резервные серверы.

Regery запрещает создавать запись NS для корневого домена зоны. Для этого используйте Действия > Изменить NS-серверы.

•︎ ns string 
Доменное имя NS-сервера
•︎ ALIAS object 

ALIAS — как и запись CNAME, связывает имя-псевдоним с другим доменным именем (каноническим доменом).

Этот тип записи напрямую не описан в спецификации DNS и, в отличие от CNAME, позволяет указывать дополнительные записи других типов. Например, если DNS-клиент запрашивает запись AAAA, а у домена-псевдонима её нет, она будет рекурсивно запрошена у канонического домена. Если запись AAAA существует, её значение будет возвращено без рекурсивного запроса.

•︎ target string 
Полное доменное имя (FQDN). Значение может содержать @ для ссылки на корневое (apex) доменное имя. Например, для apex-домена example.com цель www.@ будет отображаться как www.example.com.