Metaregistrar EPP documentation

All host commands: (check) (create) (delete) (info) (modify)

Host update

Updating a host involves adding or removing the information that currently set within the host. That is why the host:update command only allows <host:add> and <host:rem> elements. To change an IP address associated with a nameserver, you can remove and add it in the same command.

The host:update command only works for nameservers that you are allowed to change, this means that also the domain name associated with these nameservers must be in your account. Otherwise, you will not be able to alter nameserver information.

Example host:update request

To update a host you use the update->host:update command. The example below removes address 1.2.3.4 and adds two new addresses.

<?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:host="urn:ietf:params:xml:ns:host-1.0"> <command> <update> <host:update> <host:name>ns1.docu-test-case.com</host:name> <host:add> <host:addr ip="v6">2001:828:12ed:3:a:7580:cd86:e234</host:addr> <host:addr ip="v4">1.2.3.5</host:addr> </host:add> <host:rem> <host:addr ip="v4">1.2.3.4</host:addr> </host:rem> </host:update> </update> <clTRID>57d1535f296a9</clTRID> </command> </epp>

Example Response

<?xml version="1.0" encoding="UTF-8"?> <epp xmlns="urn:ietf:params:xml:ns:epp-1.0" xmlns:domain="urn:ietf:params:xml:ns:domain-1.0" xmlns:contact="urn:ietf:params:xml:ns:contact-1.0" xmlns:host="urn:ietf:params:xml:ns:host-1.0" xmlns:ext="http://www.metaregistrar.com/epp/ext-1.0" xmlns:command-ext="http://www.metaregistrar.com/epp/command-ext-1.0" xmlns:command-ext-domain="http://www.metaregistrar.com/epp/command-ext-domain-1.0" xmlns:secDNS="urn:ietf:params:xml:ns:secDNS-1.1" xmlns:rgp="urn:ietf:params:xml:ns:rgp-1.0"> <response> <result code="1000"> <msg>Command completed successfully</msg> </result> <trID> <svTRID>MTR_b81d0e0e797e7f81561a788258475c9b195700d2</svTRID> <clTRID>57d1535f296a9</clTRID> </trID> </response> </epp>