Разное

Управление dns yandex: Настроить DNS-записи — Яндекс 360 для бизнеса. Справка

18.06.1991

запись — Яндекс 360 для бизнеса. Справка

Переезд в Яндекс 360 для бизнеса

Мы собрали ответы на частые вопросы о том, как перенести данные вашей организации в Яндекс 360 для бизнеса из Google Workspace, Microsoft 365 и других платформ. Смотреть >

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

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

  1. Общая инструкция по настройке SPF-записи
  2. Инструкции по настройке SPF-записи у некоторых хостинг-провайдеров

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

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

    • Значение— v=spf1 redirect=_spf.yandex.net

      Если вы хотите отправлять письма не только с серверов Яндекса, укажите дополнительные серверы в таком формате:

      v=spf1 ip4:IP-1 ip4:IP-2 ip4:IP-3 include:_spf.yandex.net ~all

      Где IP-1, IP-2, IP-3 — IP-адреса дополнительных серверов.

    • Имя поддомена (или Хост) — @

      В некоторых панелях управления вместо символа @ нужно указать имя вашего домена (например, example.org.). Если вам не удается указать ни @, ни имя домена, оставьте это поле пустым.

      Если это поле отсутствует в панели управления, можно его не указывать.

    • Если требуется заполнить поле TTL, укажите 21600.

  3. Подождите, пока изменения вступят в силу. Может потребоваться до 72 часов, чтобы DNS-серверы в интернете обменялись данными о новых DNS-записях.

reg.ru

  1. Откройте страницу https://reg.ru и войдите в ваш аккаунт.

  2. Нажмите кнопку с вашим логином и выберите Домены и услуги.

  3. Нажмите ссылку с именем нужного домена. Откроется страница Управление.

  4. Выберите DNS-серверы и управление зоной.

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

  6. Подождите, пока изменения в DNS вступят в силу. Может потребоваться до 72 часов, чтобы DNS-серверы в интернете обменялись данными о новых DNS-записях.

masterhost.ru

  1. Откройте страницу https://cp.masterhost.ru и войдите в ваш аккаунт.

  2. На панели справа выберите DNS-зоны.

  3. Нажмите ссылку с именем нужного домена. Откроется страница Просмотр DNS-зоны.

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

    Поле MX preference оставьте пустым.

  5. Подождите, пока изменения в DNS вступят в силу. Может потребоваться до 72 часов, чтобы DNS-серверы в интернете обменялись данными о новых DNS-записях.

sweb.ru

  1. Откройте страницу https://mcp.sweb.ru и войдите в ваш аккаунт.

  2. В разделе Управление хостингом нажмите ссылку DNS.

  3. В выпадающем списке выберите нужный домен.

  4. В разделе Записи для основного домена добавьте новую TXT-запись. В поле укажите v=spf1 redirect=_spf. yandex.net.

    Если вы хотите отправлять письма не только с серверов Яндекса, укажите дополнительные серверы в таком формате:

    v=spf1 ip4:IP-1 ip4:IP-2 ip4:IP-3 include:_spf.yandex.net ~all

    Где IP-1, IP-2, IP-3 — IP-адреса дополнительных серверов.

  5. Подождите, пока изменения в DNS вступят в силу. Может потребоваться до 72 часов, чтобы DNS-серверы в интернете обменялись данными о новых DNS-записях.

beget.com

  1. Откройте страницу https://cp.beget.com и войдите в ваш аккаунт.

  2. Нажмите ссылку DNS.

  3. В выпадающем списке выберите нужный домен.

  4. В нижней части страницы найдите строку с нужным доменом и нажмите значок . DNS-записи домена станут доступными для редактирования.

  5. Добавьте новую TXT-запись, в поле txt data укажите v=spf1 redirect=_spf.yandex.net.

    Если вы хотите отправлять письма не только с серверов Яндекса, укажите дополнительные серверы в таком формате:

    v=spf1 ip4:IP-1 ip4:IP-2 ip4:IP-3 include:_spf.yandex.net ~all

    Где IP-1, IP-2, IP-3 — IP-адреса дополнительных серверов.

  6. Подождите, пока изменения в DNS вступят в силу. Может потребоваться до 72 часов, чтобы DNS-серверы в интернете обменялись данными о новых DNS-записях.

Собственные инструкции провайдеров по настройке DNS-записей:

  • Timeweb

  • Hostinger

  • RedDock

подпись — Яндекс 360 для бизнеса.

Справка

Переезд в Яндекс 360 для бизнеса

Мы собрали ответы на частые вопросы о том, как перенести данные вашей организации в Яндекс 360 для бизнеса из Google Workspace, Microsoft 365 и других платформ. Смотреть >

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

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

  1. Общая инструкция по настройке DKIM-подписи
  2. Инструкции по настройке DKIM-подписи у некоторых хостинг-провайдеров

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

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

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

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

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

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

  6. Создайте TXT-запись со следующими значениями полей (в разных панелях управления названия полей могут отличаться):

    • Имя поддомена (или Хост) — mail._domainkey. В некоторых панелях управления DNS для публичного ключа DKIM необходимо также указывать домен, например mail._domainkey.yourdomain.tld.

    • Значение — текст публичного ключа, который вы скопировали из блока Настройка DKIM-подписи в настройках домена.

      Например, v=DKIM1; k=rsa; t=s; p=MIGfMA0GCSEBtaCOteh5EBqJlKpe. ..

    • Если требуется заполнить поле TTL, укажите 21600.

  7. Подождите, пока изменения вступят в силу. Может потребоваться до 72 часов, чтобы DNS-серверы в интернете обменялись данными о новых DNS-записях.

reg.ru

  1. Перейдите на страницу настройки домена в Почте для бизнеса и скопируйте значение публичного ключа для вашего домена (см. в общей инструкции по настройке DKIM-подписи).

  2. Откройте страницу https://reg.ru и войдите в ваш аккаунт.

  3. Нажмите кнопку с вашим логином и выберите Домены и услуги.

  4. Нажмите ссылку с именем нужного домена. Откроется страница Управление.

  5. Выберите DNS-серверы и управление зоной.

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

  7. Подождите, пока изменения вступят в силу. Может потребоваться до 72 часов, чтобы DNS-серверы в интернете обменялись данными о новых DNS-записях.

masterhost.ru

  1. Перейдите на страницу настройки домена в Почте для бизнеса и скопируйте значение публичного ключа для вашего домена (см. в общей инструкции по настройке DKIM-подписи).

  2. Откройте страницу https://cp.masterhost.ru и войдите в ваш аккаунт.

  3. На панели справа выберите DNS-зоны.

  4. Нажмите ссылку с именем нужного домена. Откроется страница Просмотр DNS-зоны.

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

    Поле MX preference оставьте пустым.

  6. Подождите, пока изменения вступят в силу. Может потребоваться до 72 часов, чтобы DNS-серверы в интернете обменялись данными о новых DNS-записях.

sweb.ru

  1. Перейдите на страницу настройки домена в Почте для бизнеса и скопируйте значение публичного ключа для вашего домена (см. в общей инструкции по настройке DKIM-подписи).

  2. Откройте страницу https://mcp.sweb.ru и войдите в ваш аккаунт.

  3. В разделе Управление хостингом нажмите ссылку DNS.

  4. В выпадающем списке выберите нужный домен.

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

  6. Подождите, пока изменения вступят в силу. Может потребоваться до 72 часов, чтобы DNS-серверы в интернете обменялись данными о новых DNS-записях.

beget.com

  1. Перейдите на страницу настройки домена в Почте для бизнеса и скопируйте значение публичного ключа для вашего домена (см. в общей инструкции по настройке DKIM-подписи).

  2. Откройте страницу https://cp.beget.com и войдите в ваш аккаунт.

  3. Нажмите ссылку DNS.

  4. В выпадающем списке выберите нужный домен.

  5. Нажмите ссылку Добавить подзону. Откроется дополнительное окно.

  6. Добавьте поддомен с именем mail._domainkey. Появится сообщение об успешном создании поддомена.

  7. В нижней части страницы найдите строку с добавленным поддоменом и нажмите значок . DNS-записи поддомена станут доступными для редактирования.

  8. Удалите А-запись, добавленную по умолчанию.

  9. Добавьте новую TXT-запись, в поле txt data которой укажите значение публичного ключа, полученное на странице настройки домена в Почте для бизнеса.

    Например, v=DKIM1; k=rsa; t=s; p=MIGfMA0GCSEBtaCOteh5EBqJlKpe...

  10. Подождите, пока изменения вступят в силу. Может потребоваться до 72 часов, чтобы DNS-серверы в интернете обменялись данными о новых DNS-записях.

Собственные инструкции провайдеров по настройке DNS-записей:

  • Timeweb

  • Hostinger

  • RedDock

Добавить запись DNS — API.

Яндекс.Почта для домена API

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

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

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

 POST /api2/admin/dns/добавить
Хост: pddimp.yandex.ru
  Описание  
 Токен PDD. 
 "}}">: <токен PDD>
...
  Тип  
 Строка 
 
  Значение  
 
 Имя домена. 
 "}}">=<имя домена>
&  Тип  
 Строка 
 
  Значение  
 
 Тип записи DNS. 
   
 Possible values:  
  
      
  •   
       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.

Parameters:

Parameter Type Value
Mandatory
domain String

Name of the domain .

тип
Строка

Тип записи DNS.

Possible values:

  • SRV

  • TXT

  • NS

  • MX

  • SOA

  • A

  • 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  
     
    •  
  •  
      5 NS 0003 
    •  
  •  
      MX  
     
    •  
  •  
      SOA  
     
    •  
  •  
      A  
     
    •  
  •  
      AAAA  
    •  
  •  
    . 
[&  Тип  
     Строка 
     
      Значение  
     
     Адрес электронной почты администратора домена. 
     
     Этот параметр требуется только для записей 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.

Parameters:

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

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

Parameter Type Value
Mandatory
domain Строка

Имя домена.

тип Строка

Тип записи DNS.

Possible values:

  • SRV

  • TXT

  • NS

  • MX

  • SOA

  • A

  • AAAA

  • CNAME

admin_mail String
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: 123456789abcdef000000000000000000000000000000000 '-d' Domain = Domain.com и Type = A & Subdomain = WWW & TTL = 14400 & Content = 127.0.0.1 '/Subdomain = WWW & TTL = 14400 & Content = 127.0.0.1.1.1. 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 'Authorization: OAuth 00123456789ABCDEF00000000000000000000000000000000000' -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   
      
    •    
  •   
       SOA   
      
    •    
  •   
       A   
      
    •    
  •   
       AAAA   
      
    •    
  •   
       CNAME   
     
    •  
 "}}">": "{тип записи}",
    "  Тип значения  
 Строка 
 
  Описание  
 
 Имя домена.  
 "}}">": "{имя домена}",
     Тип значения  
 Строка 
 
  Описание  
 
 Имя поддомена. Например, «my.domain.com» — это имя субдомена домена «domain.com». Вы можете использовать «мой» вместо «мой.домен.com». 
 "}}">": "{имя субдомена}",
    "  Тип значения  
 Строка 
 
  Описание  
 
 Абсолютное доменное имя (FQDN). 
 "}}">": "{абсолютное доменное имя}",
    "  Тип значения  
 Строка 
 
  Описание  
 
 Содержимое записи DNS. 
 "}}">": "{содержимое записи}",
    "  Тип значения  
 Целое число 
 
  Описание  
 
 Время жизни записи DNS, в секундах. 
 "}}">": "{срок жизни записи}",
    "  Тип значения  
 Целое число 
 
  Описание  
 
 Приоритет записи DNS. Существует для записей MX и SRV. Для всех остальных записей DNS возвращается пустая строка. 
 "}}">": "{ приоритет записи}"
  },
   Тип значения  
 Строка 
 
  Описание  
 
 Статус выполнения запроса.  
 
 Возможные значения: 
 "}}">": "{статус выполнения запроса}"
} 
 {
  "  Тип значения  
 Строка 
 
  Описание  
 
 Имя домена. 
 "}}">": "{имя домена}",
  "  Тип значения  
 Строка 
 
  Описание  
 
 Статус выполнения запроса. 
 
 Возможные значения: 
 "}}">": "{статус выполнения запроса}",
  " Тип значения  
 строка 
 
  Описание  
 
 Код ошибки. 
 
 Включен в ответ, если запрос привел к ошибке. 
 
 Возможные значения: 
 
     
  •  
      Неизвестный  - Временная отказ или AP произошла ошибка (повторите запрос позже). 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 редактируется. 
 "}}"> = <Время кэширования>]

Заголовки:

Наименование Описание
9.0215

Токен PDD.

Parameters:

Parameter Type Value
Mandatory
domain String

Name of the domain .

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.

Parameters:

Parameter Type Value
Mandatory
domain Строка

Имя домена.

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
...
domain=domain.com&record_id=1&subdomain=www&ttl=14400&content=127.0.0.1

cURL

 curl -H 'PddToken: 123456789ABCDEF0000000000000000000000000000000000000' -d 'domain=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
. ..
domain=domain.com&record_id=1&subdomain=www&ttl=14400&content=127.0.0.1

cURL

 curl -H 'PddToken: 123456789ABCDEF0000000000000000000000000000000000000' -H 'Authorization: OAuth 00123456789ABCDEF00000000000000000000000000000000000' -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 не будет опубликован. Обязательные поля помечены *