Перевірити і Купити Доменне ім'я, Безкоштовно SSL Сертифікати для Сайту і Сервера

Додавання ресурсних записів DNS

Дозволяє додавати записи ресурсів DNS до домену. Ця операція буде ефективна тільки в тому випадку, якщо домен делегований одному з провайдерів DNS під керуванням Regery

Параметри URL

•︎ domain string

Повне доменне ім'я FQDN

Параметри POST

•︎ records object[]

Масив ресурсних записів DNS. Загальні властивості для всіх записів перераховані нижче

•︎ name string

Ім'я запису DNS відноситься до доменного імені, пов'язаного з певним записом DNS. Це ліва частина доменного імені, яка вказує хост або піддомен, до якого застосовується запис. Якщо ім'я відноситься до кореневого домену, а частина хоста/піддомену має бути порожньою, то використовується значення @.

•︎ type string

Типи записів DNS – це певні записи у файлі зони DNS, які допомагають зіставляти доменні імена з відповідними IP-адресами або надають інші типи інформації.

•︎ ttl number | default = 3600

DNS TTL означає час життя (секунди). Це параметр запису системи доменних імен (DNS), який визначає, як довго 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

Повне доменне ім'я. Значення може містити @ для посилання на кореневе доменне ім'я. Наприклад, для домену example.com CNAME target 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 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

Вказує тип властивості

issue визначає центри сертифікації, уповноважені видавати сертифікати для домену

issuewild визначає центри сертифікації, уповноважені видавати універсальні сертифікати для домену

iodef вказує адресу електронної пошти, на яку центри сертифікації повинні повідомляти про порушення політики

•︎ NS object

NS - цей тип запису вказує авторитативний DNS сервер для доменного імені (цей сервер містить актуальні записи DNS). Найчастіше домен делегується декільком серверам DNS і має кілька NS записів, які вказують на primary і backup сервера.

Regery забороняє створення NS записи для кореневого домена зони . Для цього скористайтеся інструментом зміни Провайдер DNS.

•︎ ns string

Сервера доменних імен

•︎ ALIAS object

ALIAS - як і запис CNAME пов'язує ім'я-псевдонім з іншим доменним ім'ям (канонічний домен).

Даний тип запису безпосередньо не визначається специфікацією DNS і, на відміну від CNAME, дозволяє вказувати додатково записи інших типів. Наприклад, якщо запис AAAA запитується клієнтом DNS, але не існує для домену-псевдоніма, то вона буде рекурсивно запрошена у канонічного домену. Якщо запис AAAA існує, то її значення буде повернуто без рекурсивного запиту.

•︎ target string

Повне доменне ім'я. Значення може містити @ для посилання на кореневе доменне ім'я. Наприклад, для apex example.com мета www.@ призведе до значення, що відображається як www.example.com

HTTP ENDPOINT
POST /v1/domains/:domain/records

ПРИКЛАД ЗАПИТА: POST /v1/domains/example.com/records
{
    "records": [
        {
           "type": "A",
           "name": "@",
           "address": "192.168.0.1"
        },
        {
           "type": "CNAME",
           "name": "www",
           "target": "@"
        }
    ]
}

Зовнішній API

Додавання ресурсних записів DNS

Параметри URL

Параметри POST

Визначення типів