Разное

Управление dns yandex: Подтвердить домен и настроить сервер

03.07.2023

Домен на reg.ru — Яндекс 360 для бизнеса. Справка

Для подключения домена нужно быть его владельцем и подтвердить домен.

Если вы планируете использовать домен для отправки и получения корпоративной почты, настройте на нем DNS-записи. При делегировании домена на DNS-серверы Яндекса эти записи будут настроены автоматически и вы сможете управлять ими непосредственно в Яндекс 360 для бизнеса.

Важно. Обновление записей может занять до 72 часов. Чтобы узнать, обновилась ли запись, в Яндекс 360 для бизнеса нажмите кнопку «Проверить».

  1. Подтвердить домен
  2. Настроить DNS-записи

  1. Войдите в личный кабинет reg.ru.

  2. На панели слева выберите Домены и нажмите ссылку с именем домена, который вы добавили в Яндекс 360 для бизнеса и хотите подтвердить.

  3. В разделе DNS-серверы и управление зоной нажмите Изменить.

  4. На открывшейся странице добавьте TXT-запись с параметрами:

    1. Subdomain (имя поддомена): @ (если хотите выбрать ваш основной домен).

      Примечание. Если в Яндекс 360 для бизнеса вы хотите использовать поддомен, например отправлять письма с адресов типа [email protected] (где example.org — ваш домен), то в качестве subdomain укажите название поддомена.

    2. Text (значение): скопируйте значение со страницы подтверждения домена в Яндекс 360 для бизнеса. Оно должно выглядеть примерно так:

      yandex-verification: 5ceefc4d774euv84c4.

Внимание. Если вы переносите данные вашей организации из другой платформы, рекомендуем сначала импортировать ящики, а затем настраивать DNS-записи. После настройки записей письма будут приходить уже в ящики Яндекс Почты.

Настроить DNS-записи, необходимые для работы Почты для бизнеса, можно двумя способами:

  • Если вы делегируете домен на серверы Яндекса, все записи будут настроены автоматически.

  • Если вы не хотите делегировать домен на серверы Яндекса, настройте DNS-записи для вашего домена на сайте компании-регистратора reg.ru.

Делегировать домен — значит передать управление доменом на выбранный DNS-сервер. Вы можете делегировать домен на DNS-серверы Яндекса — тогда они будут хранить служебную информацию о вашем домене и управлять этой информацией.

Если вы делегируете домен:

Чтобы делегировать домен на серверы Яндекса:

  1. В разделе DNS-серверы и управление зоной из пункта 3 инструкции про подтверждение домена нажмите Изменить.

  2. Во всплывающей шторке выберите блок Свой список DNS-серверов и укажите следующие значения:

  3. На странице управления доменами убедитесь, что статус вашего домена отображается как Делегирован.

Чтобы по адресу вашего домена открывался сайт, убедитесь, что адрес сайта привязан к имени домена. Для этого в DNS-редакторе Яндекс 360 для бизнеса проверьте A-записи домена.

Настройка MX-записи

MX-запись указывает на сервер, принимающий почту для вашего домена. Чтобы вашу почту обрабатывал сервер Яндекса, нужно создать MX-запись, указывающую на этот сервер.

Чтобы создать MX-запись вручную:

  1. В разделе DNS-серверы и управление зоной из пункта 3 инструкции про подтверждение домена нажмите Изменить и удалите существующие MX-записи.

  2. Добавьте новую MX-запись со следующими значениями полей:

Настройка SPF-записи

SPF-запись снижает риск того, что письмо, отправленное с адреса на вашем домене, попадет в спам у адресата. Чтобы настроить SPF-запись, нужно создать TXT-запись со списком серверов, которые отвечают за отправку почты с вашего домена.

Чтобы создать SPF-запись вручную:

  1. В разделе DNS-серверы и управление зоной из пункта 3 инструкции про подтверждение домена нажмите Изменить и удалите существующие TXT-записи, которые содержат

    v=spf1.

  2. Добавьте новую TXT-запись со следующими значениями полей:

Настройка DKIM-подписи

С помощью DKIM-подписи получатель письма может удостовериться в том, что оно действительно пришло от предполагаемого отправителя. Чтобы установить DKIM-подпись для писем, отправляемых с вашего домена, создайте для вашего домена TXT-запись с публичным ключом подписи.

Чтобы настроить DKIM-подпись вручную:

  1. Войдите в аккаунт администратора организации.

  2. Перейдите на страницу Домены.

  3. Рядом с именем домена, для которого вы хотите добавить подпись, нажмите Настроить DKIM.

    Если нужного домена нет в списке, убедитесь, что он подключен и подтвержден.

  4. В блоке Настройка DKIM-подписи скопируйте значение публичного ключа для вашего домена.

  5. В разделе DNS-серверы и управление зоной из пункта 3 инструкции про подтверждение домена нажмите Изменить и добавьте новую TXT-запись со следующими значениями полей:

Проверьте DNS-записи домена и убедитесь, что они обновились и настроены верно.

Общая инструкция — Яндекс 360 для бизнеса. Справка

Для подключения домена нужно быть его владельцем и подтвердить домен.

Если вы планируете использовать домен для отправки и получения корпоративной почты, настройте на нем DNS-записи. При делегировании домена на DNS-серверы Яндекса эти записи будут настроены автоматически и вы сможете управлять ими непосредственно в Яндекс 360 для бизнеса.

Важно. Обновление записей может занять до 72 часов. Чтобы узнать, обновилась ли запись, в Яндекс 360 для бизнеса нажмите кнопку «Проверить».

  1. Подтвердить домен
  2. Настроить DNS-записи

Выберите способ подтверждения домена:

  • DNS-запись. Этот способ подходит, если у вас есть доступ к панели управления доменом (зоной DNS) у вашего провайдера DNS-хостинга (по умолчанию это регистратор вашего домена). Чтобы подтвердить домен, добавьте DNS-запись типа TXT, содержащую указанное значение.

    Как это сделать

    1. Войдите в панель управления доменом (зоной DNS) на сайте компании, которая предоставляет вам DNS-хостинг.

    2. Создайте новую TXT-запись с параметрами:

  • Метатег. Этот способ подходит, если на вашем домене находится сайт и у вас есть возможность редактировать его страницы. Чтобы подтвердить домен, добавьте специальный тег в HTML-код главной страницы вашего сайта.

  • HTML-файл. Этот способ подходит, если на вашем домене находится сайт и у вас есть доступ к корневому каталогу сайта на сервере вашего хостинг-провайдера. Чтобы подтвердить домен, скачайте специальный HTML-файл и разместите его в корневом каталоге вашего сайта..

Внимание. Если вы переносите данные вашей организации из другой платформы, рекомендуем сначала импортировать ящики, а затем настраивать DNS-записи. После настройки записей письма будут приходить уже в ящики Яндекс Почты.

Настроить DNS-записи, необходимые для работы Почты для бизнеса, можно двумя способами:

  • Если вы делегируете домен на серверы Яндекса, все записи будут настроены автоматически.

  • Если вы не хотите делегировать домен на серверы Яндекса, настройте DNS-записи для вашего домена на сайте компании-регистратора.

Делегировать домен — значит передать управление доменом на выбранный DNS-сервер. Вы можете делегировать домен на DNS-серверы Яндекса — тогда они будут хранить служебную информацию о вашем домене и управлять этой информацией.

Если вы делегируете домен:

Чтобы делегировать домен на серверы Яндекса:

  1. Войдите в аккаунт администратора организации.

  2. Перейдите на страницу Домены.

  3. Убедитесь, что статус вашего домена отображается как Подтвержден.

  4. Откройте панель управления доменом на сайте вашего регистратора и перейдите в раздел управления DNS-серверами (делегирования).

  5. Удалите существующие значения записей. Задайте значения первичного и вторичного DNS-серверов следующим образом (буква «d» в начале имен — не ошибка):

    Если в настройках делегирования есть поля для ввода IP-адресов, оставьте их пустыми.

  6. На странице управления доменами убедитесь, что статус вашего домена отображается как Делегирован.

Чтобы по адресу вашего домена открывался сайт, убедитесь, что адрес сайта привязан к имени домена. Для этого в DNS-редакторе Яндекс 360 для бизнеса проверьте A-записи домена.

MX-запись указывает на сервер, принимающий почту для вашего домена. Чтобы вашу почту обрабатывал сервер Яндекса, нужно создать MX-запись, указывающую на этот сервер.

SPF-запись снижает риск того, что письмо, отправленное с адреса на вашем домене, попадет в спам у адресата.

С помощью DKIM-подписи получатель письма может удостовериться в том, что оно действительно пришло от предполагаемого отправителя. Чтобы установить DKIM-подпись для писем, отправляемых с вашего домена, создайте для вашего домена TXT-запись с публичным ключом подписи.

Тип записиИмя поддоменаПриоритетЗначение
MX @ 10 mx. yandex.net.
TXT (SPF) @не указывается v=spf1 redirect=_spf.yandex.net
TXT (DKIM) mail._domainkeyне указываетсяСкопируйте значение из настроек домена

Проверьте DNS-записи домена и убедитесь, что они обновились и настроены верно.

Добавить запись DNS — API. Яндекс.Почта для домена API

Этот запрос используется для добавления записи DNS для домена.

  1. Синтаксис запроса
  2. Пример запроса
  3. Структура ответа

Запрос должен быть отправлен по протоколу HTTPS методом POST.

 ПОСТ /api2/admin/dns/добавить
Хост: pddimp.yandex.ru
  Описание  
 Токен PDD. 
 "}}">: <токен PDD>
...
  Тип  
 Строка 
 
  Значение  
 
 Имя домена. 
 "}}">=<имя домена>
&  Тип  
 Строка 
 
  Значение  
 
 Тип записи DNS. 
 
 Возможные значения: 
 
     
  •  
      SRV  
     
    •  
  •  
      TXT  
     
    •  
  •  
      NS  
     
    •  
  •  
      MX  
     
    •  
  •  
      SOA  
     
    •  
  •  
      A  
     
    •  
  •  
      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.

Возможные значения:

  • SRV

  • TXT

  • NS

  • MX

  • SOA

  • A 9 0003

  • AAAA

  • CNAME

admin_mail Строка

Адрес электронной почты администратора домена.

Этот параметр требуется только для записей SOA.

content String

Содержимое записи 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»). СРВ и Записи 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/registrar/dns/add
Хост: pddimp.yandex.ru
  Описание  
 Токен PDD. 
 "}}">: <токен PDD>
  Описание  
 Маркер доступа OAuth. 
 "}}">: OAuth <токен OAuth>
...
  Тип  
 Строка 
 
  Значение  
 
 Имя домена. 
 "}}">=<имя домена>
&  Тип  
 Строка 
 
  Значение  
 
 Тип записи DNS. 
 
 Возможные значения: 
 
     
  •  
      SRV  
     
    •  
  •  
      TXT  
     
    •  
  •  
      НС  
     
    •  
  •  
      MX  
     
    •  
  •  
      SOA  
     
    •  
  •  
      А  
     900 06 
  •  
      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.

Авторизация

Маркер доступа OAuth.

Параметры:

906 97

Адрес электронной почты администратора домена.

Этот параметр требуется только для записей SOA.

Параметр Тип Значение
Обязательный
домен Строка

Имя домена.

тип Строка

Тип записи DNS.

Возможные значения:

  • SRV

  • TXT

  • NS

  • MX

  • SOA

  • A 9 0003

  • AAAA

  • CNAME

admin_mail Строка
content String

Содержимое записи 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.

порт Строка

Порт 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: 123456789ABCDEF00000000000000000000000000000000000000' -d 'domain=domain.com&type=A&subdomain=www&ttl=1440 0&content=127.0.0.1' 'https://pddimp.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: 123456789ABCDEF00000000000000000000000000000000000000' -H 'Авторизация: OAuth 00123456789ABCDEF0 0000000000000000000000000000000000' -d 'domain=domain.com&type=A&subdomain=www&ttl=14400&content=127.0.0.1' 'https://pddimp.yandex.ru ru/api2/admin/dns/add'soa 
 {
  "  Тип значения  
 Строка 
 
  Описание  
 
 Имя домена. 
 "}}">": "{имя домена}",
   Тип значения  
 Объект 
 
  Описание  
 
 Информация о записи DNS. 
 "}}">":
  {
    "  Тип значения  
 Целое число 
 
  Описание  
 
 Идентификатор записи DNS.  
 "}}">": "{ID записи}",
    "  Тип значения  
 Строка 
 
  Описание  
 
 Тип записи DNS. 
 
 Возможные значения: 
 
     
  •  
      SRV  
     
    •  
  •  
      TXT  
     
    •  
  •  
      NS  
     
    •  
  •  
      MX  
     9 0006 
  •  
      SOA  
     
    •  
  •  
      А  
     
    •  
  •  
      AAAA  
     
    •  9004 2 
      ЗАПИСЬ  
      
 "}}">": "{тип записи}",
    "  Тип значения  
 Строка 
 
  Описание  
 
 Имя домена.  
 "}}">": "{имя домена}",
     Тип значения  
 Строка 
 
  Описание  
 
 Имя поддомена. Например, «my.domain.com» — это имя субдомена домена «domain.com». Вы можете использовать «мой» вместо «мой.домен.com». 
 "}}">": "{имя субдомена}",
    "  Тип значения  
 Строка 
 
  Описание  
 
 Абсолютное доменное имя (FQDN). 
 "}}">": "{абсолютное доменное имя}",
    "  Тип значения  
 Строка 
 
  Описание  
 
 Содержимое записи DNS. 
 "}}">": "{содержимое записи}",
    "  Тип значения  
 Целое число 
 
  Описание  
 
 Время жизни записи DNS, в секундах. 
 "}}">": "{срок жизни записи}",
    "  Тип значения  
 Целое число 
 
  Описание  
 
 Приоритет записи DNS. Существует для записей MX и SRV. Для всех остальных записей DNS возвращается пустая строка. 
 "}}">": "{ приоритет записи}"
  },
   Тип значения  
 Строка 
 
  Описание  
 
 Статус выполнения запроса.  
 
 Возможные значения: 
 "}}">": "{статус выполнения запроса}"
} 
 {
  "  Тип значения  
 Строка 
 
  Описание  
 
 Имя домена. 
 "}}">": "{имя домена}",
  "  Тип значения  
 Строка 
 
  Описание  
 
 Статус выполнения запроса. 
 
 Возможные значения: 
 "}}">": "{статус выполнения запроса}",
  "  Тип значения  
 Строка 
 
  Описание  
 
 Код ошибки. 
 
 Включается в ответ, если запрос привел к ошибке. 
 
 Возможные значения: 
 
     900 42 
      неизвестно  — Временный сбой или 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 можно указать с помощью идентификатора.

  1. Синтаксис запроса
  2. Пример запроса
  3. Структура ответа

Запрос должен быть отправлен по протоколу 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 редактируется. 
 "}}">=<время кэширования>]

Заголовки:

90 211
Имя Описание
PddToken

Токен 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.

Для записей типа:

  • 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»).

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.

Для записей типа:

  • 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.

порт Строка

Порт TCP или UDP хоста, на котором находится служба. Услуга может быть, например, jabber.

Этот параметр требуется только для записей SRV.

вес Целое число

Вес записи SRV по отношению к другим записям SRV для того же домена и с тем же приоритетом.

Этот параметр требуется только для записей SRV.

цель Строка

Каноническое имя хоста, предоставляющего услугу.

Этот параметр требуется только для записей SRV.

 POST /api2/admin/dns/edit HTTP/1.1
Хост: pddimp.yandex.ru
PddToken: 123456789ABCDEF00000000000000000000000000000000000000
...
домен = домен. 00000000000' -d 'домен=domain.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
...
домен = домен. 00000000000' -H 'Авторизация: OAuth 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 (или имя пользователя/пароль).

Добавить комментарий

Ваш адрес email не будет опубликован. Обязательные поля помечены *