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="urn:ietf:params:xml:ns:host-1.0">
         <host:name>ns5.example.epp.uz</host:name>
           <host:addr ip='v4'>193.29.220.26</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="urn:ietf:params:xml:ns:host-1.0">
         <host:name>ns5.example.epp.uz</host:name>
         <host:crDate>2010-06-22T17:37:57+03:00</host:crDate>
       </host:creData>
     </resData>
     <trID>
       <clTRID>USER-1277217477</clTRID>
       <svTRID>hst-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="urn:ietf:params:xml:ns:host-1.0">ns5.e.epp.uz</host:name></value>
         <reason lang="en">Parent domain not exists</reason>
       </extValue>
     </result>
     <trID>
       <clTRID>USER-1277217477</clTRID>
       <svTRID>hst-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-адрес.