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


DOMAIN:UPDATE

Команда EPP <update> domain предназначена для изменения объекта Домен. Только регистратор-спонсор объекта может изменять его.

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

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

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

Элементы <domain:add> и <domain:rem> содержат один или несколько элементов:

  • <domain:ns> - список добавляемых или удаляемых name-серверов.
  • <domain:contact> - список добавляемых или удаляемых административных, технических контактов домена. Добавляемые контакты должны быть уже зарегистрированы в реестре. (объекты "Контакт")
  • <domain:status> - список добавляемых или удаляемых статусов объекта Домен. Возможные статусы объекта:
    • clientUpdateProhibited
    • clientDeleteProhibited
    • clientTransferProhibited
    • clientRenewProhibited
    • clientHold

Для задания элемента <domain:ns> можно использовать один из двух способов:

  • как ссылка на уже имеющиеся в реестре объекты "Хост":
       <domain:ns>
          <domain:hostObj>ns1.example.epp.ua</domain:hostObj>
          <domain:hostObj>ns2.example.epp.ua</domain:hostObj>
       </domain:ns>
    
  • как описание для создания новых объектов "Хост".
       <domain:ns>
         <domain:hostAttr>
           <domain:hostName>ns1.example1.epp.ua</domain:hostName>
           <domain:hostAddr ip="v4">192.0.2.2</domain:hostAddr>
           <domain:hostAddr ip="v6">1080:0:0:0:8:800:200C:417A</domain:hostAddr>
         </domain:hostAttr>
         <domain:hostAttr>
           <domain:hostName>ns2.example.net</domain:hostName>
         </domain:hostAttr>
       </domain:ns>
    

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

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

Элемент <domain:chg> может содержать элементы:

  • <domain:registrant> - элемент, определяющий регистранта домена. Это должна быть ссылка на объект контакт, уже имеющийся (предварительно зарегистрированный) в реестре.
  • <domain:authInfo> - элемент, устанавливающий authInfo (пароль к объекту). Может содержать элемент <domain:pw>, в котором указывается новый пароль, либо элемент <domain:null/>, означающий обнуление пароля.

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

Пример изменения списка контактов и серверов:

  <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <command>
      <update>
        <domain:update
         xmlns:domain="http://eunic.net.ua/epp/domain-1.1">
          <domain:name>example1.epp.ua</domain:name>
          <domain:add>
            <domain:ns>
              <domain:hostObj>ns3.example.epp.ua</domain:hostObj>
            </domain:ns>
            <domain:contact type="tech">ex21</domain:contact>
          </domain:add>
          <domain:rem>
            <domain:ns>
              <domain:hostObj>ns1.example.epp.ua</domain:hostObj>
            </domain:ns>
            <domain:contact type="tech">ex11</domain:contact>
          </domain:rem>
          <domain:chg>
            <domain:registrant>ex22</domain:registrant>
          </domain:chg>
        </domain:update>
      </update>
      <clTRID>USER-1276251625</clTRID>
    </command>
  </epp>

Пример установки статуса clientTransferProhibited и обнуления authInfo

  <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <command>
      <update>
        <domain:update
         xmlns:domain="http://eunic.net.ua/epp/domain-1.1">
          <domain:name>example1.epp.ua</domain:name>
          <domain:add>
            <domain:status s="clientTransferProhibited"/>
          </domain:add>
          <domain:chg>
            <domain:authInfo>
              <domain:null/>
            </domain:authInfo>
          </domain:chg>
        </domain:update>
      </update>
      <clTRID>USER-1276251625</clTRID>
    </command>
  </epp>

Пример сброса статуса clientTransferProhibited и установки authInfo

  <?xml version="1.0" encoding="UTF-8" standalone="no"?>
  <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <command>
      <update>
        <domain:update
         xmlns:domain="http://eunic.net.ua/epp/domain-1.1">
          <domain:name>example1.epp.ua</domain:name>
          <domain:rem>
            <domain:status s="clientTransferProhibited"/>
          </domain:rem>
          <domain:chg>
            <domain:authInfo>
              <domain:pw>2BARfoo</domain:pw>
            </domain:authInfo>
          </domain:chg>
        </domain:update>
      </update>
      <clTRID>USER-1276251625</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-1276251625</clTRID>
      <svTRID>CO-20100611132026-197131-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 либо статусы pendingDelete, pendingTransfer.

2309    "Application rejected"
        "Заявка відхилена"
        "Заявка отклонена"
         Ошибка выдается в случае, если заявка не соответствует правилам
         публичного домена