.UA - наш дом. Сделаем его лучшим!
Тестовый Сервер


HOST:CREATE

Команда EPP <create> host предназначена для создания объекта Хост.

Команда содержит следующие элементы:

  • <host:name> - Полностью определенное имя хоста.
  • <host:addr> - элемент содержит ip-адреса, которые необходимо присвоить данному хосту. Указываются только для "внутренних" хостов, являющиеся дочерними хостами доменов, находящихся на обслуживании в Реестре. Формат ip-адреса (IPv4, IPv6) указывается в атрибуте "ip". Если атрибут не задан, формат определяется автоматически.

При приеме команды <create> host производятся следующие проверки:

  • Имя хоста соответствует [RFC1034]. Если нет - ошибка 2005 "Parameter value syntax error"
  • Информации о хосте нет в Реестре. Если нет - ошибка 2302 "Object exists"
  • Определяется тип хоста (внутренний или внешний).
    если внутренний, то:
    • В Реестре зарегистрирован родительский домен для данного хоста. Если нет - ошибка 2303 "Object does not exist"
    • ip-адреса заданы. Если нет - ошибка 2003 "Required parameter missing"
    • ip-адреса заданы корректно [RFC0791] [RFC4291]. Если нет - ошибка 2005 "Parameter value syntax error"
    • ip-адреса принадлежат приватным или зарезервированным сетям [RFC5735] [RFC5156]. Если да - ошибка 2004 "Parameter value range error"
    • Количество ip-адресов не превышает максимального (13). Если нет - ошибка 2001 "Command syntax error"
    • Является ли регистратор, приславший заявку, спонсором родительского домена. Если нет - ошибка 2201 "Authorization error"
    если внешний, то:
    • Имеется в системе DNS данный хост (производится попытка определить его ip-адрес). Если нет - ошибка 2306 "Parameter value policy error"

Пример команды <create>

 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <command>
     <create>
       <host:create xmlns:host="http://eunic.net.ua/epp/host-1.1">
         <host:name>ns5.example.epp.ua</host:name>
           <host:addr ip='v4'>192.0.2.2</host:addr>
           <host:addr ip='v6'>0:0:0:0:0:FFFF:192.0.2.2</host:addr>
       </host:create>
     </create>
     <clTRID>USER-1277217477</clTRID>
   </command>
 </epp>

Пример ответа сервера на команду <create>

Если команда <create> выполнена успешно, ответ сервера содержит элемент <resData> с подэлементом <creData>.

Элемент <creData> содержит подэлементы:

  • <host:name> - уникальное полностью определенное имя хоста.
  • <host:crDate> - дата и время создания объекта (локальное).
 <?xml version="1.0" encoding="UTF-8"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <response>
     <result code="1000">
       <msg lang="en">Command completed successfully</msg>
     </result>
     <resData>
       <host:creData xmlns:host="http://eunic.net.ua/epp/host-1.1">
         <host:name>ns5.example.epp.ua</host:name>
         <host:crDate>2010-06-22T17:37:57+03:00</host:crDate>
       </host:creData>
     </resData>
     <trID>
       <clTRID>USER-1277217477</clTRID>
       <svTRID>CO-20100622173757-736942-00002</svTRID>
     </trID>
   </response>
 </epp>

Пример ответа сервера с ошибкой выполнения команды

 <?xml version="1.0" encoding="UTF-8"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <response>
     <result code="2303">
       <msg lang="en">Object does not exist</msg>
       <extValue>
         <value><host:name 
         xmlns:host="http://eunic.net.ua/epp/host-1.1">ns5.e.epp.ua</host:name></value>
         <reason lang="en">Parent domain not exists</reason>
       </extValue>
     </result>
     <trID>
       <clTRID>USER-1277217477</clTRID>
       <svTRID>CO-20100622173757-736942-00002</svTRID>
     </trID>
   </response>
 </epp>

Коды ответов сервера на команду <create>

1000    "Command completed successfully"
        "Команду виконано успішно"
        "Команда выполнена успешно"

2001    "Command syntax error"
        "Синтаксична помилка команди"
        "Синтаксическая ошибка команды"

2003    "Required parameter missing"
        "Відсутній обов'язковий параметр"
        "Отсутствует обязательный параметр"

2004    "Parameter value range error"
        "Помилка в значенні параметра"
        "Ошибка в значении параметра"

2005    "Parameter value syntax error"
        "Синтаксична помилка параметра"
        "Синтаксическая ошибка параметра"

2302    "Object exists"
        "Об'єкт вже існує"
        "Объект уже существует"

2303    "Object does not exist"
        "Об'єкт не існує"
        "Объект не существует"
         Ошибка выдается при попытке зарегистрировать 
         хост при отсутствуещем родительском домене.

2306    "Parameter value policy error"
        "Значення параметра не відповідає правилам"
        "Значение параметра не соответствует правилам"
         Ошибка выдается при попытке зарегистрировать 
         внешний хост, у которого не определяется его ip-адрес.