Create nsgroup[Link]

Purpose

create a list of name servers that can be linked to several domain registrations.

Note

This is a DNS Belgium specific extension, documented in the schema nsgroup-1.0.xsd.

The nsgroup mapping is a DNS Belgium specific object-extension to the EPP norm, coherent with the EPP object extension framework. The nsgroup object allows a registrar to group several name servers in one object, to facilitate the mapping between a domain and a list of name servers.

Some components of the command need further explanation:

  • <nsgroup:name> is required. Contains the (chosen) name for the name server group. A name can consist of letters, digits, hyphens and dot(.).

  • <nsgroup:ns> contains the name of the name server. There can be up to 9 name servers in a name server group.

Please refer to the examples to see a complete request.

Examples[Link]

A create 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 creation, 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>

Note

It is your responsibility to ensure that the content makes sense. It is perfectly possible to create a name server group with all the same name servers. The result will be that only 1 name server will be linked to the name server group!