Домени
Безпека
Інструменти
Компанія
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 (Domain Name System), який визначає, як довго 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 дає змогу власнику доменного імені вказати один або кілька центрів сертифікації (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.