Содержание
Домен на reg.ru — Яндекс 360 для бизнеса. Справка
Для подключения домена нужно быть его владельцем и подтвердить домен.
Если вы планируете использовать домен для отправки и получения корпоративной почты, настройте на нем DNS-записи. При делегировании домена на DNS-серверы Яндекса эти записи будут настроены автоматически и вы сможете управлять ими непосредственно в Яндекс 360 для бизнеса.
Важно. Обновление записей может занять до 72 часов. Чтобы узнать, обновилась ли запись, в Яндекс 360 для бизнеса нажмите кнопку «Проверить».
- Подтвердить домен
- Настроить DNS-записи
Войдите в личный кабинет reg.ru.
На панели слева выберите Домены и нажмите ссылку с именем домена, который вы добавили в Яндекс 360 для бизнеса и хотите подтвердить.
В разделе DNS-серверы и управление зоной нажмите Изменить.
На открывшейся странице добавьте TXT-запись с параметрами:
Subdomain (имя поддомена):
@
(если хотите выбрать ваш основной домен).Примечание. Если в Яндекс 360 для бизнеса вы хотите использовать поддомен, например отправлять письма с адресов типа
[email protected]
(гдеexample.org
— ваш домен), то в качествеsubdomain
укажите название поддомена.Text (значение): скопируйте значение со страницы подтверждения домена в Яндекс 360 для бизнеса. Оно должно выглядеть примерно так:
yandex-verification: 5ceefc4d774euv84c4
.
Внимание. Если вы переносите данные вашей организации из другой платформы, рекомендуем сначала импортировать ящики, а затем настраивать DNS-записи. После настройки записей письма будут приходить уже в ящики Яндекс Почты.
Настроить DNS-записи, необходимые для работы Почты для бизнеса, можно двумя способами:
Если вы делегируете домен на серверы Яндекса, все записи будут настроены автоматически.
Если вы не хотите делегировать домен на серверы Яндекса, настройте DNS-записи для вашего домена на сайте компании-регистратора reg.ru.
Делегировать домен — значит передать управление доменом на выбранный DNS-сервер. Вы можете делегировать домен на DNS-серверы Яндекса — тогда они будут хранить служебную информацию о вашем домене и управлять этой информацией.
Если вы делегируете домен:
Чтобы делегировать домен на серверы Яндекса:
В разделе DNS-серверы и управление зоной из пункта 3 инструкции про подтверждение домена нажмите Изменить.
Во всплывающей шторке выберите блок Свой список DNS-серверов и укажите следующие значения:
На странице управления доменами убедитесь, что статус вашего домена отображается как Делегирован.
Чтобы по адресу вашего домена открывался сайт, убедитесь, что адрес сайта привязан к имени домена. Для этого в DNS-редакторе Яндекс 360 для бизнеса проверьте A-записи домена.
Настройка MX-записи
MX-запись указывает на сервер, принимающий почту для вашего домена. Чтобы вашу почту обрабатывал сервер Яндекса, нужно создать MX-запись, указывающую на этот сервер.
Чтобы создать MX-запись вручную:
В разделе DNS-серверы и управление зоной из пункта 3 инструкции про подтверждение домена нажмите Изменить и удалите существующие MX-записи.
Добавьте новую MX-запись со следующими значениями полей:
Настройка SPF-записи
SPF-запись снижает риск того, что письмо, отправленное с адреса на вашем домене, попадет в спам у адресата. Чтобы настроить SPF-запись, нужно создать TXT-запись со списком серверов, которые отвечают за отправку почты с вашего домена.
Чтобы создать SPF-запись вручную:
В разделе DNS-серверы и управление зоной из пункта 3 инструкции про подтверждение домена нажмите Изменить и удалите существующие TXT-записи, которые содержат
v=spf1
.Добавьте новую TXT-запись со следующими значениями полей:
Настройка DKIM-подписи
С помощью DKIM-подписи получатель письма может удостовериться в том, что оно действительно пришло от предполагаемого отправителя. Чтобы установить DKIM-подпись для писем, отправляемых с вашего домена, создайте для вашего домена TXT-запись с публичным ключом подписи.
Чтобы настроить DKIM-подпись вручную:
Войдите в аккаунт администратора организации.
Перейдите на страницу Домены.
Рядом с именем домена, для которого вы хотите добавить подпись, нажмите Настроить DKIM.
Если нужного домена нет в списке, убедитесь, что он подключен и подтвержден.
В блоке Настройка DKIM-подписи скопируйте значение публичного ключа для вашего домена.
В разделе DNS-серверы и управление зоной из пункта 3 инструкции про подтверждение домена нажмите Изменить и добавьте новую TXT-запись со следующими значениями полей:
Проверьте DNS-записи домена и убедитесь, что они обновились и настроены верно.
Домен на beget.ru — Яндекс 360 для бизнеса. Справка
Для подключения домена нужно быть его владельцем и подтвердить домен.
Если вы планируете использовать домен для отправки и получения корпоративной почты, настройте на нем DNS-записи. При делегировании домена на DNS-серверы Яндекса эти записи будут настроены автоматически и вы сможете управлять ими непосредственно в Яндекс 360 для бизнеса.
Важно. Обновление записей может занять до 72 часов. Чтобы узнать, обновилась ли запись, в Яндекс 360 для бизнеса нажмите кнопку «Проверить».
- Подтвердить домен
- Настроить DNS-записи
Войдите в личный кабинет beget.ru.
В разделе DNS разверните строку с именем домена, который вы добавили в Яндекс 360 для бизнеса и хотите подтвердить, и нажмите значок с карандашом.
Нажмите Добавить запись и добавьте TXT-запись с параметрами:
Имя домена/поддомена: оставьте пустым.
Примечание. Если в Яндекс 360 для бизнеса вы хотите использовать поддомен, например отправлять письма с адресов типа
[email protected]
(гдеexample.org
— ваш домен), то в качествеХост
укажите название поддомена (в примере этоsubdomain
).Тип записи: TXT.
Значение: скопируйте значение со страницы подтверждения домена в Яндекс 360 для бизнеса. Оно должно выглядеть примерно так:
yandex-verification: 5ceefc4d774euv84c4
.
Внимание. Если вы переносите данные вашей организации из другой платформы, рекомендуем сначала импортировать ящики, а затем настраивать DNS-записи. После настройки записей письма будут приходить уже в ящики Яндекс Почты.
Настроить DNS-записи, необходимые для работы Почты для бизнеса, можно двумя способами:
Если вы делегируете домен на серверы Яндекса, все записи будут настроены автоматически.
Если вы не хотите делегировать домен на серверы Яндекса, настройте DNS-записи для вашего домена на сайте компании-регистратора beget.ru.
Делегировать домен — значит передать управление доменом на выбранный DNS-сервер. Вы можете делегировать домен на DNS-серверы Яндекса — тогда они будут хранить служебную информацию о вашем домене и управлять этой информацией.
Если вы делегируете домен:
Чтобы делегировать домен на серверы Яндекса:
В разделе DNS разверните строку с именем домена, который вы добавили в Яндекс 360 для бизнеса, и нажмите Редактирование DNS-серверов.
Удалите существующие значения DNS и укажите следующие значения:
На странице управления доменами убедитесь, что статус вашего домена отображается как Делегирован.
Чтобы по адресу вашего домена открывался сайт, убедитесь, что адрес сайта привязан к имени домена. Для этого в DNS-редакторе Яндекс 360 для бизнеса проверьте A-записи домена.
Настройка записей MX и SPF
MX-запись указывает на сервер, принимающий почту для вашего домена. Чтобы вашу почту обрабатывал сервер Яндекса, нужно создать MX-запись, указывающую на этот сервер.
SPF-запись снижает риск того, что письмо, отправленное с адреса на вашем домене, попадет в спам у адресата.
Чтобы создать записи вручную:
В разделе управления записями DNS из пункта 2 инструкции про подтверждение домена удалите существующие MX-записи.
Нажмите надпись MX шаблоны и выберите Yandex. Все настройки будут сделаны автоматически.
Настройка DKIM-подписи
С помощью DKIM-подписи получатель письма может удостовериться в том, что оно действительно пришло от предполагаемого отправителя. Чтобы установить DKIM-подпись для писем, отправляемых с вашего домена, создайте для вашего домена TXT-запись с публичным ключом подписи.
Чтобы настроить DKIM-подпись вручную:
Войдите в аккаунт администратора организации.
Перейдите на страницу Домены.
Рядом с именем домена, для которого вы хотите добавить подпись, нажмите Настроить DKIM.
Если нужного домена нет в списке, убедитесь, что он подключен и подтвержден.
В блоке Настройка DKIM-подписи скопируйте значение публичного ключа для вашего домена.
В разделе управления записями DNS из пункта 2 инструкции про подтверждение домена для вашего домена нажмите Добавить подзону. В качестве имени поддомена укажите
mail._domainkey
. Созданная подзона появится в общем списке.В блоке Быстрое добавление выберите созданную подзону, укажите тип записи TXT и заполните поле
txt data
значением публичного ключа, полученного в пункте 4.Например,
v=DKIM1; k=rsa; t=s; p=MIGfMA0GCSEBtaCOteh5EBqJlKpe...
Проверьте DNS-записи домена и убедитесь, что они обновились и настроены верно.
Добавить запись DNS — API. Яндекс.Почта для домена API
Этот запрос используется для добавления записи DNS для домена.
- Синтаксис запроса
- Пример запроса
- Структура ответа
Запрос должен быть отправлен по протоколу HTTPS методом POST.
POST /api2/admin/dns/добавить Хост: pddimp.yandex.ru ОписаниеТокен PDD.
"}}">: <токен PDD> ... ТипСтрока
Значение
Имя домена.
"}}">=<имя домена> & ТипСтрока
Значение
Тип записи DNS.
Возможные значения:
-
SRV
-
TXT
-
NS
0042
MX
-
SOA
-
А
-
AAAA
-
CNAME
Строка
Значение
Адрес электронной почты администратора домена.
Этот параметр требуется только для записей SOA.
"}}">=<адрес электронной почты администратора>] [& ТипСтрока
Значение
Содержимое записи DNS.
Для записей типа:
-
A — адрес в формате IPv4 (например, «194.84.46.241»).
-
AAAA — адрес в формате IPv6 (например, «2001:0db8:11a3:09d7:1f34:8a2e:07a0:765d»).
-
CNAME, MX или NS — абсолютное доменное имя (FQDN).
-
TXT — текст TXT-записи (например, «v=spf1 redirect=_spf.yandex.ru»).
Целое число
Значение
Приоритет записи DNS (чем меньше значение, тем выше ее приоритет).
Этот параметр требуется только для записей SRV и MX.
Значение по умолчанию — 10.
"}}">=<приоритет записи>] [& ТипЦелое число
Значение
Вес записи SRV по отношению к другим записям SRV для того же домена и с тем же приоритетом.
Этот параметр требуется только для записей SRV.
"}}">=<вес записи SRV>] [&port"}}">=<порт хоста>] [& ТипСтрока
Значение
Каноническое имя хоста, предоставляющего услугу.
Этот параметр требуется только для записей SRV.
"}}">=<каноническое имя хоста>] [& ТипСтрока
Значение
Имя поддомена. Например, «domain.com» — это имя субдомена домена «com», а «my.domain.com» — это субдомен домена «domain.com».
Значение по умолчанию — «@» (корневой домен домена).
Этот параметр следует передавать, если вам нужно создать или изменить DNS-запись для поддомена, а не для домена.
"}}">=<имя поддомена>] [& ТипЦелое число
Значение
Время жизни записи DNS в секундах. Значение по умолчанию — 21600.
"}}">=<срок жизни записи>]Заголовки:
Имя | Описание |
---|---|
PddToken | Токен PDD. |
Параметры:
Параметр | Значение Тип | |
---|---|---|
Обязательный | ||
домен | Строка | Имя домена . |
тип | Строка | Тип записи DNS. Возможные значения:
|
admin_mail | Строка | Адрес электронной почты администратора домена. Этот параметр требуется только для записей SOA. |
content | String | Содержимое записи DNS. Для записей типа:
|
вес | Целое число | Вес записи SRV по отношению к другим записям SRV для того же домена и с тем же приоритетом. Этот параметр требуется только для записей SRV. |
порт | Строка | Порт TCP или UDP хоста, на котором находится служба. Услуга может быть, например, jabber. Этот параметр требуется только для записей SRV. |
цель | Строка | Каноническое имя хоста, предоставляющего услугу. Этот параметр требуется только для записей SRV. |
Дополнительно | ||
субдомен | Строка | Имя субдомена. Например, «domain.com» — это имя субдомена домена «com», а «my.domain.com» — это субдомен домена «domain.com». Значение по умолчанию — «@» (корневой домен домена). Этот параметр следует передавать, если вам нужно создать или изменить DNS-запись для поддомена, а не для домена. |
ttl | Целое число | Время жизни записи DNS в секундах. Значение по умолчанию — 21 600. |
POST /api2/registrar/dns/add Хост: pddimp.yandex.ru ОписаниеТокен PDD.
"}}">: <токен PDD> ОписаниеМаркер доступа OAuth.
"}}">: OAuth <токен OAuth> ... ТипСтрока
Значение
Имя домена.
"}}">=<имя домена> & ТипСтрока
Значение
Тип записи DNS.
Возможные значения:
-
SRV
-
TXT
-
5 NS
0003
-
MX
-
SOA
-
А
- 3
- 6 90AA AA
-
CNAME
Строка
Значение
Адрес электронной почты администратора домена.
Этот параметр требуется только для записей SOA.
"}}">=<адрес электронной почты администратора>] [& ТипСтрока
Значение
Содержимое записи DNS.
Для записей вида:
-
A — адрес в формате IPv4 (например, «194.84.46.241»).
-
AAAA — адрес в формате IPv6 (например, «2001:0db8:11a3:09d7:1f34:8a2e:07a0:765d»).
-
CNAME, MX или NS — абсолютное доменное имя (FQDN).
-
TXT — текст TXT-записи (например, «v=spf1 redirect=_spf.yandex.ru»).
Целое число
Значение
Приоритет записи DNS (чем меньше значение, тем выше ее приоритет).
Этот параметр требуется только для записей SRV и MX.
Значение по умолчанию — 10.
"}}">=<приоритет записи>] [& ТипЦелое число
Значение
Вес записи SRV по отношению к другим записям SRV для того же домена и с тем же приоритетом.
Этот параметр требуется только для записей SRV.
"}}">=<вес записи SRV>] [&port"}}">=<порт хоста>] [& ТипСтрока
Значение
Каноническое имя хоста, предоставляющего услугу.
Этот параметр требуется только для записей SRV.
"}}">=<каноническое имя хоста>] [& ТипСтрока
Значение
Имя поддомена. Например, «domain.com» — это имя субдомена домена «com», а «my.domain.com» — это субдомен домена «domain.com».
Значение по умолчанию — «@» (корневой домен домена).
Этот параметр следует передавать, если вам нужно создать или изменить DNS-запись для поддомена, а не для домена.
"}}">=<имя поддомена>] [& ТипЦелое число
Значение
Время жизни записи DNS в секундах. Значение по умолчанию — 21600.
"}}">=<срок жизни записи>]Заголовки:
Имя | Описание |
---|---|
PddToken | Токен PDD. |
Авторизация | Маркер доступа OAuth. |
Параметры:
Параметр | Значение Тип | |
---|---|---|
Обязательный | ||
домен | Строка | Имя домена. |
тип | Строка | Тип записи DNS. Возможные значения:
|
admin_mail | String | |
content | String | Содержимое записи DNS. Для записей типа:
|
приоритет | Целое число | Приоритет записи DNS (чем меньше значение, тем выше ее приоритет). Этот параметр требуется только для записей SRV и MX. Значение по умолчанию — 10. |
вес | Целое число | Вес записи SRV по отношению к другим записям SRV для того же домена и с тем же приоритетом. Этот параметр требуется только для записей SRV. |
порт | Строка | Порт TCP или UDP хоста, на котором находится служба. Услуга может быть, например, jabber. Этот параметр требуется только для записей SRV. |
цель | Строка | Каноническое имя хоста, предоставляющего услугу. Этот параметр требуется только для записей SRV. |
Дополнительно | ||
субдомен | Строка | Имя субдомена. Например, «domain.com» — это имя субдомена домена «com», а «my.domain.com» — это субдомен домена «domain. com». Значение по умолчанию — «@» (корневой домен домена). Этот параметр следует передавать, если вам нужно создать или изменить DNS-запись для поддомена, а не для домена. |
ttl | Целое число | Время жизни записи DNS в секундах. Значение по умолчанию — 21 600. |
POST /api2/admin/dns/add HTTP/1.1 Хост: pddimp.yandex.ru PddToken: 123456789ABCDEF00000000000000000000000000000000000000 ... domain=domain.com&type=A&subdomain=www&ttl=14400&content=127.0.0.1
cURL
curl -H 'PddToken: 123456789ABCDEF0000000000000000000000000000000000000' -d 'domain=domain.com&type=A&subdomain=www&ttlpp.142400&content=142400&content=1 .yandex.ru/api2/admin/dns/ add'soa
POST /api2/admin/dns/добавить HTTP/1. 1 Хост: pddimp.yandex.ru PddToken: 123456789ABCDEF00000000000000000000000000000000000000 Авторизация: OAuth 00123456789ABCDEF000000000000000000000000000000000000 ... domain=domain.com&type=A&subdomain=www&ttl=14400&content=127.0.0.1
cURL
curl -H 'PddToken: 123456789ABCDEF0000000000000000000000000000000000000' -H 'Авторизация: OAuth 00123456700000000000000000000000000000000000000000000000000' 000000000000' -d 'domain=domain.com&type=A&subdomain=www&ttl=14400&content=127.0.0.1' 'https://pddimp.yandex. ru/api2/admin/dns/add'soa
{ " Тип значенияСтрока
Описание
Имя домена.
"}}">": "{имя домена}", Тип значенияОбъект
Описание
Информация о записи DNS.
"}}">": { " Тип значенияЦелое число
Описание
Идентификатор записи DNS.
"}}">": "{ID записи}", " Тип значенияСтрока
Описание
Тип записи DNS.
Возможные значения:
-
SRV
-
TXT
-
NS
-
MX
- 3
- 6
- 6 SOA
-
A
-
AAAA
-
CNAME
3
Строка
Описание
Имя домена.
"}}">": "{имя домена}", Тип значенияСтрока
Описание
Имя поддомена. Например, «my.domain.com» — это имя субдомена домена «domain.com». Вы можете использовать «мой» вместо «мой.домен.com».
"}}">": "{имя субдомена}", " Тип значенияСтрока
Описание
Абсолютное доменное имя (FQDN).
"}}">": "{абсолютное доменное имя}", " Тип значенияСтрока
Описание
Содержимое записи DNS.
"}}">": "{содержимое записи}", " Тип значенияЦелое число
Описание
Время жизни записи DNS, в секундах.
"}}">": "{срок жизни записи}", " Тип значенияЦелое число
Описание
Приоритет записи DNS. Существует для записей MX и SRV. Для всех остальных записей DNS возвращается пустая строка.
"}}">": "{ приоритет записи}" }, Тип значенияСтрока
Описание
Статус выполнения запроса.
Возможные значения:
"}}">": "{статус выполнения запроса}" }{ " Тип значенияСтрока
Описание
Имя домена.
"}}">": "{имя домена}", " Тип значенияСтрока
Описание
Статус выполнения запроса.
Возможные значения:
"}}">": "{статус выполнения запроса}", " Тип значенияСтрока
Описание
Код ошибки.
Включается в ответ, если запрос привел к ошибке.
Возможные значения:
- 2 90 Временный сбой или API произошла ошибка (повторите запрос позже).0045 ) — пропущен обязательный параметр.
-
bad_domain
— доменное имя не указано или не соответствует RFC. -
запрещено
— Запрещенное доменное имя. -
bad_token
(bad_login
,bad_passwd
) — был передан недопустимый токен PDD (или имя пользователя/пароль). -
no_auth
— заголовокPddToken
был опущен. -
not_allowed
— Эта операция не разрешена для данного пользователя (пользователь не является администратором домена). -
заблокирован
— Заблокированный домен (например, из-за спама и так далее).
-
занято
— Доменное имя используется другим пользователем. -
domain_limit_reached
— Превышено допустимое количество подключенных доменов (50). -
no_reply
— Яндекс.Почта для домена не может подключиться к серверу-источнику для импорта.
Была ли статья полезной?
Редактировать запись DNS - API. Яндекс.Почта для домена API
Этот запрос используется для редактирования DNS-записи для домена.
Запись DNS можно указать с помощью идентификатора.
- Синтаксис запроса
- Пример запроса
- Структура ответа
Запрос должен быть отправлен по протоколу HTTPS методом POST.
ПУБЛИКАЦИЯ /api2/admin/dns/edit Хост: pddimp.yandex.ru ОписаниеТокен PDD.
"}}">: <токен PDD> ... ТипСтрока
Значение
Имя домена.
"}}">=<имя домена> & ТипЦелое число
Значение
Идентификатор записи DNS.
"}}">=<идентификатор записи> [& ТипСтрока
Значение
Адрес электронной почты администратора домена.
Этот параметр требуется только для записей SOA.
"}}">=<адрес электронной почты администратора>] [& ТипСтрока
Значение
Содержимое записи DNS.
Для записей вида:
-
A — адрес в формате IPv4 (например, «194.84.46.241»).
-
AAAA — адрес в формате IPv6 (например, \"2001:0db8:11a3:09d7:1f34:8a2e:07a0:765d\").
-
CNAME, MX или NS — абсолютное доменное имя (FQDN).
-
TXT — текст TXT-записи (например, «v=spf1 redirect=_spf. yandex.ru»).
Целое число
Значение
Приоритет записи DNS (чем меньше значение, тем выше ее приоритет).
Этот параметр требуется только для записей SRV и MX.
Значение по умолчанию — 10.
"}}">=<приоритет записи>] [& ТипЦелое число
Значение
Вес записи SRV по отношению к другим записям SRV для того же домена и с тем же приоритетом.
Этот параметр требуется только для записей SRV.
"}}">=<вес записи SRV>] [& ТипСтрока
Значение
Порт TCP или UDP хоста, на котором находится служба. Услуга может быть, например, jabber.
Этот параметр требуется только для записей SRV.
"}}">=<хост-порт>] [& ТипСтрока
Значение
Каноническое имя хоста, предоставляющего услугу.
Этот параметр требуется только для записей SRV.
"}}">=<каноническое имя хоста>] [& ТипСтрока
Значение
Имя поддомена. Например, «domain.com» — это имя субдомена домена «com», а «my.domain.com» — это субдомен домена «domain.com».
Значение по умолчанию — «@» (корневой домен домена).
Этот параметр следует передавать, если вам нужно создать или изменить DNS-запись для поддомена, а не для домена.
"}}">=<имя поддомена>] [& ТипЦелое число
Значение
Время жизни записи DNS в секундах.
Для записей SOA это время, в течение которого значение записи DNS кэшируется промежуточными DNS-серверами. Этот отрезок времени также будет использоваться по умолчанию для всех других новых записей в зоне. Допустимые значения — от 900 до 1209600. Рекомендуемое значение — 21600.
"}}">=<срок жизни записи>] [& ТипЦелое число
Значение
Частота в секундах, с которой вторичные DNS-серверы проверяют записи DNS для этой зоны. Допустимые значения от 9От 00 до 86400. Рекомендуемое значение — 10800.
Этот параметр необходимо передать, если редактируется запись SOA.
"}}">=<время между обновлениями>] [& ТипЦелое число
Значение
Время в секундах между повторными попытками вторичных DNS-серверов получить записи зоны. Повторные запросы отправляются, если основной сервер не отвечает. Допустимые значения — от 90 до 3600. Рекомендуемое значение — 900.
Этот параметр необходимо передавать, если запись SOA редактируется.
"}}">=<время между попытками получить запись>] [& ТипЦелое число
Значение
Время в секундах, по истечении которого вторичные DNS-серверы считают записи зоны несуществующими, если первичный сервер не отвечает. Допустимые значения — от 90 до 3600. Рекомендуемое значение — 900.
Этот параметр необходимо передавать, если запись SOA редактируется.
"}}">=<лимит времени>] [& ТипЦелое число
Значение
Время в секундах, в течение которого отрицательный ответ от DNS-сервера (ERROR = NXDOMAIN) будет кэшироваться. Допустимые значения — от 90 до 86400. Рекомендуемое значение — 10800.
Этот параметр необходимо передавать, если запись SOA редактируется.
"}}">=<время кэширования>]Заголовки:
Имя | Описание | Токен PDD. |
---|
Параметры:
Параметр | Значение Тип | |
---|---|---|
Обязательный | ||
домен | Строка | Имя домена . |
record_id | Целое число | Идентификатор записи DNS. |
Дополнительно | ||
субдомен | Строка | Имя субдомена. Например, «domain.com» — это имя субдомена домена «com», а «my.domain.com» — это субдомен домена «domain.com». Значение по умолчанию — «@» (корневой домен домена). Этот параметр следует передавать, если вам нужно создать или изменить DNS-запись для поддомена, а не для домена. |
ttl | Целое число | Время жизни записи DNS в секундах. Для записей SOA это время, в течение которого значение записи DNS кэшируется промежуточными DNS-серверами. Этот отрезок времени также будет использоваться по умолчанию для всех других новых записей в зоне. Допустимые значения — от 900 до 1209600. Рекомендуемое значение — 21600. |
обновление | Целое число | Частота в секундах, с которой вторичные DNS-серверы проверяют записи DNS для этой зоны. Допустимые значения от 9От 00 до 86400. Рекомендуемое значение — 10800. Этот параметр необходимо передать, если редактируется запись SOA. |
повторная попытка | Целое число | Время в секундах между повторными попытками вторичных DNS-серверов получить записи зоны. Повторные запросы отправляются, если основной сервер не отвечает. Допустимые значения — от 90 до 3600. Рекомендуемое значение — 900. Этот параметр необходимо передавать, если запись SOA редактируется. |
expire | Целое число | Время в секундах, по истечении которого вторичные DNS-серверы считают записи зоны несуществующими, если первичный сервер не отвечает. Допустимые значения — от 90 до 3600. Рекомендуемое значение — 900. Этот параметр необходимо передавать, если запись SOA редактируется. |
neg_cache | Целое число | Время в секундах, в течение которого отрицательный ответ от DNS-сервера (ERROR = NXDOMAIN) будет кэшироваться. Допустимые значения от 9От 0 до 86400. Рекомендуемое значение — 10800. Этот параметр необходимо передать, если редактируется запись SOA. |
admin_mail | Строка | Адрес электронной почты администратора домена. Этот параметр требуется только для записей SOA. |
content | String | Содержимое записи DNS. Для записей типа:
|
priority | Integer | Приоритет записи DNS (чем меньше значение, тем выше ее приоритет). Этот параметр требуется только для записей SRV и MX. Значение по умолчанию — 10. |
порт | Строка | Порт TCP или UDP хоста, на котором находится служба. Услуга может быть, например, jabber. Этот параметр требуется только для записей SRV. |
вес | Целое число | Вес записи SRV по отношению к другим записям SRV для того же домена и с тем же приоритетом. Этот параметр требуется только для записей SRV. |
цель | Строка | Каноническое имя хоста, предоставляющего услугу. Этот параметр требуется только для записей SRV. |
POST /api2/registrar/dns/edit Хост: pddimp.yandex.ru ОписаниеТокен PDD.
"}}">: <токен PDD> ОписаниеМаркер доступа OAuth.
"}}">: OAuth <токен OAuth> ... ТипСтрока
Значение
Имя домена.
"}}">=<имя домена> & ТипЦелое число
Значение
Идентификатор записи DNS.
"}}">=<идентификатор записи> [& ТипСтрока
Значение
Адрес электронной почты администратора домена.
Этот параметр требуется только для записей SOA.
"}}">=<адрес электронной почты администратора>] [& ТипСтрока
Значение
Содержимое записи DNS.
Для записей вида:
-
A — адрес в формате IPv4 (например, «194.84.46.241»).
-
AAAA — адрес в формате IPv6 (например, «2001:0db8:11a3:09d7:1f34:8a2e:07a0:765d»).
-
CNAME, MX или NS — абсолютное доменное имя (FQDN).
-
TXT — текст TXT-записи (например, «v=spf1 redirect=_spf.yandex.ru»).
Целое число
Значение
Приоритет записи DNS (чем меньше значение, тем выше ее приоритет).
Этот параметр требуется только для записей SRV и MX.
Значение по умолчанию — 10.
"}}">=<приоритет записи>] [& ТипЦелое число
Значение
Вес записи SRV по отношению к другим записям SRV для того же домена и с тем же приоритетом.
Этот параметр требуется только для записей SRV.
"}}">=<вес записи SRV>] [& ТипСтрока
Значение
Порт TCP или UDP хоста, на котором находится служба. Услуга может быть, например, jabber.
Этот параметр требуется только для записей SRV.
"}}">=<хост-порт>] [& ТипСтрока
Значение
Каноническое имя хоста, предоставляющего услугу.
Этот параметр требуется только для записей SRV.
"}}">=<каноническое имя хоста>] [& ТипСтрока
Значение
Имя поддомена. Например, «domain.com» — это имя субдомена домена «com», а «my.domain.com» — это субдомен домена «domain.com».
Значение по умолчанию — «@» (корневой домен домена).
Этот параметр следует передавать, если вам нужно создать или изменить DNS-запись для поддомена, а не для домена.
"}}">=<имя поддомена>] [& ТипЦелое число
Значение
Время жизни записи DNS в секундах.
Для записей SOA это время, в течение которого значение записи DNS кэшируется промежуточными DNS-серверами. Этот отрезок времени также будет использоваться по умолчанию для всех других новых записей в зоне. Допустимые значения — от 900 до 1209600. Рекомендуемое значение — 21600.
"}}">=<срок жизни записи>] [& ТипЦелое число
Значение
Частота в секундах, с которой вторичные DNS-серверы проверяют записи DNS для этой зоны. Допустимые значения — от 900 до 86400. Рекомендуемое значение — 10800.
Этот параметр необходимо передать, если запись SOA редактируется.
"}}">=<время между обновлениями>] [& ТипЦелое число
Значение
Время в секундах между повторными попытками вторичных DNS-серверов получить записи зоны. Повторные запросы отправляются, если основной сервер не отвечает. Допустимые значения от 9От 0 до 3600. Рекомендуемое значение — 900.
Этот параметр необходимо передать, если редактируется запись SOA.
"}}">=<время между попытками получения записей>] [& ТипЦелое число
Значение
Время в секундах, по истечении которого вторичные DNS-серверы считают записи зоны несуществующими, если первичный сервер не отвечает. Допустимые значения — от 90 до 3600. Рекомендуемое значение — 900.
Этот параметр необходимо передавать, если запись SOA редактируется.
"}}">=<лимит времени>] [& ТипЦелое число
Значение
Время в секундах, в течение которого отрицательный ответ от DNS-сервера (ERROR = NXDOMAIN) будет кэшироваться. Допустимые значения — от 90 до 86400. Рекомендуемое значение — 10800.
Этот параметр необходимо передавать, если запись SOA редактируется.
"}}">=<время кэширования>]Заголовки:
Имя | Описание |
---|---|
PddToken | Токен PDD. |
Авторизация | Маркер доступа OAuth. |
Параметры:
Параметр | Значение Тип | |
---|---|---|
Обязательный | ||
домен | Строка | Имя домена. |
record_id | Integer | Идентификатор записи DNS. |
Дополнительно | ||
субдомен | Строка | Имя субдомена. Например, «domain.com» — это имя субдомена домена «com», а «my.domain.com» — это субдомен домена «domain.com». Значение по умолчанию — «@» (корневой домен домена). Этот параметр следует передавать, если вам нужно создать или изменить запись DNS для поддомена, а не для домена. |
ttl | Целое число | Время жизни записи DNS в секундах. Для записей SOA это время, в течение которого значение записи DNS кэшируется промежуточными DNS-серверами. Этот отрезок времени также будет использоваться по умолчанию для всех других новых записей в зоне. Допустимые значения от 900 до 1209600. Рекомендуемое значение 21600. |
обновление | Целое число | Частота в секундах, с которой вторичные DNS-серверы проверяют записи DNS для этой зоны. Допустимые значения — от 900 до 86400. Рекомендуемое значение — 10800. Этот параметр необходимо передать, если запись SOA редактируется. |
повторная попытка | Целое число | Время в секундах между повторными попытками вторичных DNS-серверов получить записи зоны, если первичный сервер не вернул ответ. Допустимые значения от 9От 0 до 3600. Рекомендуемое значение — 900. Этот параметр необходимо передать, если редактируется запись SOA. |
expire | Целое число | Время в секундах, по истечении которого вторичные DNS-серверы считают записи зоны несуществующими, если первичный сервер постоянно не отвечает. Допустимые значения — от 90 до 3600. Рекомендуемое значение — 900. Этот параметр необходимо передавать, если запись SOA редактируется. |
neg_cache | Integer | Время в секундах, в течение которого отрицательный ответ от DNS-сервера (ERROR = NXDOMAIN) будет кэшироваться. Допустимые значения — от 90 до 86400. Рекомендуемое значение — 10800. Этот параметр необходимо передавать, если запись SOA редактируется. |
admin_mail | Строка | Адрес электронной почты администратора домена. Этот параметр требуется только для записей SOA. |
content | Строка | Содержимое записи DNS. Для записей типа:
|
приоритет | Целое число | Приоритет записи DNS (чем меньше значение, тем выше ее приоритет). Этот параметр требуется только для записей SRV и MX. Значение по умолчанию — 10. |
порт | Строка | Порт TCP или UDP хоста, на котором находится служба. Услуга может быть, например, jabber. Этот параметр требуется только для записей SRV. |
вес | Целое число | Вес записи SRV по отношению к другим записям SRV для того же домена и с тем же приоритетом. Этот параметр требуется только для записей SRV. |
цель | Строка | Каноническое имя хоста, предоставляющего услугу. Этот параметр требуется только для записей SRV. |
POST /api2/admin/dns/edit HTTP/1.1 Хост: pddimp.yandex.ru PddToken: 123456789ABCDEF00000000000000000000000000000000000000 ... домен = домен. com&record_id=1&subdomain=www&ttl=14400&content=127.0.0.1' 'https ://pddimp.yandex.ru/api2/admin/dns/edit'
POST /api2/admin/dns/edit HTTP/1.1 Хост: pddimp.yandex.ru Пддтокен: 123456789ABCDEF00000000000000000000000000000000000000 Авторизация: OAuth 00123456789ABCDEF000000000000000000000000000000000000 ... домен = домен. Аутентификация 00123456789ABCDEF000000000000000000000000000000000000' -d 'domain=domain.com&record_id=1&subdomain=www&ttl= 14400&content=127. 0.0.1' 'https://pddimp.yandex.ru/api2/admin/dns/edit'
{ "домен": "{имя домена}", "record_id": "{ID записи}", "записывать": { "record_id": "{ID записи}", "тип": "{тип записи}", "домен": "{имя домена}" "fqdn": {"абсолютное доменное имя"}, "ttl": "{срок жизни записи}", "субдомен": "{имя субдомена}", "content": "{содержимое записи}", "priority": "{приоритет записи}", "операция": "{редактирование}" }, "success": "{статус выполнения запроса}" }
{
" Тип значенияСтрока
Описание
Имя домена.
"}}">": "{имя домена}",
" Тип значенияСтрока
Описание
Статус выполнения запроса.
Возможные значения:
"}}">": "{статус выполнения запроса}",
" Тип значенияСтрока
Описание
Код ошибки.
Включается в ответ, если запрос привел к ошибке.
Возможные значения:
неизвестно
— Произошел временный сбой или ошибка API (повторите запрос позже).no_token
(no_domain
,no_ip
) — пропущен обязательный параметр.bad_domain
— доменное имя не указано или не соответствует RFC.запрещено
— Запрещенное доменное имя.bad_token
(bad_login
,bad_passwd
) — был передан недопустимый токен PDD (или имя пользователя/пароль).no_auth
— заголовокPddToken
был опущен.