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


HOST:UPDATE

Команда EPP <update> host предназначена для изменения информации об объекте Хост. Данная команда доступна только для спонсора объекта.

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

  • <host:name> - полностью определенное имя хоста.
  • <host:add> - необязательный элемент, содержащий значения атрибутов, которые необходимо добавить к объекту
  • <host:rem> - необязательный элемент, содержащий значения атрибутов, которые требуется удалить

В команде <update> должен присутствовать хотя бы один из элементов <host:add>, <host:rem>

Элементы <host:add> и <host:rem> содержат следующие необязательные элементы:

  • <host:addr> - элемент содержит ip-адреса, которые необходимо присвоить данному хосту. Указываются только для "внутренних" хостов, являющиеся дочерними хостами доменов, находящихся на обслуживании в Реестре.
  • <host:status> - один или два элемента для установки или снятия статуса объекта хост. Возможные статусы объекта Хост:
    • clientUpdateProhibited
    • clientDeleteProhibited

Если объект находится в статусе clientUpdateProhibited, то все изменения, кроме снятия статуса clientUpdateProhibited, будут заблокированы.

При попытке добавить статус, который уже был установлен, либо удалить статус, которого не было, изменения не происходят, запрос проигнорируется.

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

 <?xml version="1.0" encoding="UTF-8" standalone="no"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <command>
     <update>
       <host:update xmlns:host="http://eunic.net.ua/epp/host-1.1">
         <host:name>ns5.example.epp.ua</host:name>
         <host:add>
           <host:status s="clientDeleteProhibited"></host:status>
           <host:status s="clientUpdateProhibited"></host:status>
         </host:add>
       </host:update>
     </update>
     <clTRID>USER-1275850648</clTRID>
   </command>
 </epp>

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

При успешном выполнении команды <update> в ответе сервера секции <resData> отсутствует.

 <?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>
     <trID>
       <clTRID>USER-1275850648</clTRID>
       <svTRID>CO-20100606215846-157155-00002</svTRID>
     </trID>
   </response>
 </epp>

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

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

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

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

2201    "Authorization error"
        "Помилка авторізаії"
        "Ошибка авторизации"
         Ошибка выдается при попытке изменить чужой объект.

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

2304    "Object status prohibits operation"
        "Статус об'єкта не дозволяє здійснення операції"
        "Статус объекта не позволяет совершение операции"
         Ошибка выдается при попытке изменить объект, имеющий
         статус UpdateProhibited.