.UA ccTLD Domain Network Information Centre

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://hostmaster.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>

top


Приклад встановлення статусу 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://hostmaster.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>

top


Приклад скидання статусу 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://hostmaster.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>

top


Приклад відповіді сервера на команду <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>UA-20100611132026-197131-00002</svTRID>
     </trID>
   </response>
 </epp>

top


 Обробка заявки, що вимагає додаткової автономної перевірки
(зміна номера свідоцтва на знак для товарів і послуг в приватних доменах UA другого рівня)

зміна 2014-04-01

Для зміни номера свідоцтва на знак для товарів і послуг в приватних доменах UA другого рівня необхідно вказати нове значення номеру свідоцтва в полі license у додатковому розширенні до команди <update> із EPP Extension uaepp:

<uaepp:update
  xmlns:uaepp="http://hostmaster.ua/epp/uaepp-1.1">
  <uaepp:license>12345</uaepp:license>
</uaepp:update>

top


Приклад команди EPP <update> domain для зміни номера свідоцтва на знак для товарів і послуг в приватному домені UA другого рівня:

  <?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://hostmaster.ua/epp/domain-1.1">
          <domain:name>example1.ua</domain:name>
        </domain:update>
      </update>
      <extension>
        <uaepp:update
          xmlns:uaepp="http://hostmaster.ua/epp/uaepp-1.1">
          <uaepp:license>12345</uaepp:license>
        </uaepp:update>
      </extension>
      <clTRID>USER-1393686181</clTRID>
    </command>
  </epp>

Під час отримання заявки, що вимагає додаткової автономної перевірки та підтвердження, клієнтові направляється відповідь, що заявка прийнята і поставлена в чергу на обробку. Запит знаходиться на розгляді, після закінчення якого клієнт буде повідомлений за допомогою <poll> повідомлень і по email.
Код відповіді на запит: 1001

1001    "Command completed successfully; action pending"
        "Команду виконано успішно, дію відкладено"
        "Команда выполнена успешно, действие отложено"

Якщо в команді <update>, окрім номера ліцензії, вказані і інші зміни (блоки <domain:add>, <domain:rem> або <domain:chg>), то ВСІ запитані зміни будуть відкладені до моменту розгляду заявки службою підтримки. Для оперативної обробки змін контактів, ns-серверів необхідно виділити запит на зміну номера свідетельсва в окремий, як вказано в прикладі

top


 Приклад відповіді сервера на команду <update>, вимагаючої додаткової перевірки та підтвердження

 <?xml version="1.0" encoding="UTF-8"?>
 <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
   <response>
     <result code="1001">
       <msg lang="en">Command completed successfully; action pending</msg>
     </result>
    <trID>
      <clTRID>USER-1393686180</clTRID>
      <svTRID>UA-20140301150312-588777-00002</svTRID>
    </trID>
   </response>
 </epp>

Доменний об'єкт отримує статус "pendingUpdate". Жодні інші запити на зміну об'єкту до кінця обробки заявки прийняті не будуть. Після перевірки заявки Оператором Реєстру і її обробки клієнтові будуть відправлені <poll> і email-повідомлення про результати.

<poll>-повідомлення, сформовані як результат обробки відкладеної заявки <update>, в елементі <resData> містять наступні елементи:

  • <domain:name> - повністю певне ім'я доменного об'єкту. Елемент містить атрибут "paResult", який може мати значення:
    • "1" - заявка підтверджена і виконана
    • "0" - заявка відхилена
  • <domain:paTRID> - містить ідентифікатори транзакцій клієнта (clTRID) і відповіді сервера (svTRID) по відкладеній заявці.
  • <domain:paDate> - дата та час обробки заявки (локальні).

top


Приклад <poll> повідомлення з інформацією про успішне завершення обробки заявки <update> domain

  <?xml version="1.0" encoding="UTF-8"?>
  <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <response>
      <result code="1301">
        <msg lang="en">Command completed successfully; ack to dequeue</msg>
      </result>
      <msgQ count="5" id="12345">
        <qDate>2014-03-01T16:37:35+03:00</qDate>
        <msg>Pending action completed successfully</msg>
      </msgQ>
      <resData>
        <domain:panData 
          xmlns:domain="http://hostmaster.ua/epp/domain-1.1">
          <domain:name paResult="1">example1.ua</domain:name>
             <domain:paTRID>
               <clTRID>USER-1393686180</clTRID>
               <svTRID>UA-20140301150312-588777-00002</svTRID>
             </domain:paTRID>
          <domain:paDate>2014-03-01T16:00:00.0Z</domain:paDate>
        </domain:panData>
      </resData>
      <trID>
        <clTRID>USER2-1393688234</clTRID>
        <svTRID>UA-20140301163736-665862-00002</svTRID>
      </trID>
    </response>
  </epp>

Елемент <msg> містить повідомлення про успішне завершення операції:

Pending action completed successfully
Відкладену операцію завершено
Отложенная операция завершена

Атрибут paResult елемента domain:name має значення "1"

top


 Приклад <poll> повідомлення з інформацією про відмову в обробці заявки <update> domain

  <?xml version="1.0" encoding="UTF-8"?>
  <epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
    <response>
      <result code="1301">
        <msg lang="en">Command completed successfully; ack to dequeue</msg>
      </result>
      <msgQ count="5" id="12345">
        <qDate>2014-03-01T16:37:35+03:00</qDate>
        <msg>Pending action rejected. Information about TM is absent</msg>
      </msgQ>
      <resData>
        <domain:panData 
          xmlns:domain="http://hostmaster.ua/epp/domain-1.1">
          <domain:name paResult="0">example1.ua</domain:name>
             <domain:paTRID>
               <clTRID>USER-1393686180</clTRID>
               <svTRID>UA-20140301150312-588777-00002</svTRID>
             </domain:paTRID>
          <domain:paDate>2014-03-01T16:00:00.0Z</domain:paDate>
        </domain:panData>
      </resData>
      <trID>
        <clTRID>USER2-1393688234</clTRID>
        <svTRID>UA-20140301163736-665862-00002</svTRID>
      </trID>
    </response>
  </epp>

Атрибут paResult елементу domain:name має значення "0"

Елемент <msg> містить повідомлення про відмову в обробці операції:

Pending action rejected
Відкладена операція відхилена
Отложенная операция отклонена

Додатково приводиться причина відмови:

1. Відсутні відомості про ТМ
   Отсутствуют сведения о ТМ
   Information about TM is absent

2. Домен не відповідає ТМ
   Домен не соответствует ТМ
   Domain does not match TM

3. Регістрант не відповідає власнику ТМ
   Регистрант не соответствует собственнику ТМ
   Registrant does not math TM owner

4. Закінчився термін дії ТМ
   Закончился срок действия ТМ
   The TM is expired

Після підтвердження заявки <update> з домена знімається статус "pendingUpdate".

В разі відхилення заявки <update> доменний об'єкт не змінюється.

top



Коди відповідей сервера на команду <update>

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

1001    "Command completed successfully; action pending"
        "Команду виконано успішно, дію відкладено"
        "Команда выполнена успешно, действие отложено"
        Відповідь на запит зміни номера свідоцтва на знак         
для товарів і послуг в приватному домені UA другого рівня

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

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

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

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

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

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