Update nsgroup

Purpose

to update the contents of a name server group.

Note

a nsgroup update updates the whole object at once (there are no <add>, <chg> or <rem> sections as with others EPP objects).

The command structure is identical to the one for the <create> nsgroup and has the same remarks.

Please refer to the examples to see a complete request.

Examples

An update nsgroup command looks like:

<epp xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd http://www.dns.be/xml/epp/nsgroup-1.0 nsgroup-1.0.xsd" xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:nsgroup="http://www.dns.be/xml/epp/nsgroup-1.0">
  <command>
    <update>
      <nsgroup:update>
        <nsgroup:name>mynsgroup1</nsgroup:name>
        <nsgroup:ns>ns1.nameserver.be</nsgroup:ns>
        <nsgroup:ns>ns2.nameserver.be</nsgroup:ns>
        <nsgroup:ns>ns3.nameserver.be</nsgroup:ns>
      </nsgroup:update>
    </update>
    <clTRID>clientref-00013</clTRID>
  </command>
</epp>

In case of successful update, the EPP server responds with a standard EPP response message:

<epp xmlns="urn:ietf:params:xml:ns:epp-1.0">
  <response>
    <result code="1000">
      <msg>Command completed successfully</msg>
    </result>
    <trID>
      <clTRID>clientref-00013</clTRID>
      <svTRID>dnsbe-25</svTRID>
    </trID>
  </response>
</epp>

If we receive an update which doesn’t change the object, we won’t log the update. You will receive a success response, but the response will indicate no changes have been made, and the update will not be shown in the history.

<?xml version="1.0" encoding="UTF-8"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:dnsbe="http://www.dns.be/xml/epp/dnsbe-1.0">
  <response>
    <result code="1000">
      <msg>Command completed successfully</msg>
    </result>
    <extension>
      <dnsbe:ext>
        <dnsbe:result>
          <dnsbe:msg>Nsgroup xxxx updated without change, no history created</dnsbe:msg>
        </dnsbe:result>
      </dnsbe:ext>
    </extension>
    <trID>
      <clTRID>clientref-00004</clTRID>
      <svTRID>dnsbe-103</svTRID>
    </trID>
  </response>
</epp>

Note

When updating a name server group, you are replacing all existing name servers by the set provided in the update command. So if you want to keep the existing name servers and just add another one, you need to respecify the old ones and add the new one.