The <update> operation allows the attributes of an object to be updated.
Domains
The <domain:update> operation is described in
RFC 5731 and allows the following modifications to a domain name:
- The <domain:registrant> field allows the domain name to be assigned to a different registrant account. This is only allowed if the new account has the same organisation name as the first.
- Nameservers can be added and removed to the domain name
Modification of the first-bill, recur-bill, auto-bill, next-bill, notes and reseller fields are done using the domain-nom-ext-1.1 extension.
Example of a <domain:update> operation with extensions
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
epp-1.0.xsd">
<command>
<update>
<domain:update
xmlns:domain="urn:ietf:params:xml:ns:domain-1.0"
xsi:schemaLocation="urn:ietf:params:xml:ns:domain-1.0
domain-1.0.xsd">
<domain:name>epp-example2.co.uk</domain:name>
<domain:add>
<domain:ns>
<domain:hostObj>ns0.epp-example3.co.uk</domain:hostObj>
<domain:hostObj>ns0.epp-example4.co.uk</domain:hostObj>
</domain:ns>
</domain:add>
<domain:rem>
<domain:ns>
<domain:hostObj>ns0.epp-example1.co.uk</domain:hostObj>
<domain:hostObj>ns0.epp-example2.co.uk</domain:hostObj>
</domain:ns>
</domain:rem>
<domain:chg>
<domain:registrant>5689658965</domain:registrant>
</domain:chg>
</domain:update>
</update>
<extension>
<domain-ext:update
xmlns:domain-ext="http://www.nominet.org.uk/epp/xml/domain-nom-ext-1.1"
xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/domain-nom-ext-1.1
domain-nom-ext-1.1.xsd">
<domain-ext:first-bill>bc</domain-ext:first-bill>
<domain-ext:recur-bill>bc</domain-ext:recur-bill>
<domain-ext:auto-bill>143</domain-ext:auto-bill>
<domain-ext:next-bill>10</domain-ext:next-bill>
<domain-ext:notes>notes</domain-ext:notes>
<domain-ext:notes>notes2</domain-ext:notes>
</domain-ext:update>
</extension>
<clTRID>ABC-12345</clTRID>
</command>
</epp>
Registrant contacts
The <contact:update> is described in
RFC 5733 and allows the following fields in a registrant contact to be modified:
- address
- contact name
- email address
- contact name
Modifications to the trading name, organisation type, company number, whois opt-out field can done using the contact-nom-1.0 extension.
Example of a <contact:update> operation with extensions
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0
epp-1.0.xsd">
<command>
<update>
<contact:update
xmlns:contact="urn:ietf:params:xml:ns:contact-1.0"
xsi:schemaLocation="urn:ietf:params:xml:ns:contact-1.0
contact-1.0.xsd">
<contact:id>my_contact</contact:id>
<contact:chg>
<contact:postalInfo type="loc">
<contact:name>Changed main contact name</contact:name>
<contact:addr>
<contact:street>10 Modified Street</contact:street>
<contact:city>Oxford</contact:city>
<contact:sp>Oxon</contact:sp>
<contact:pc>OX5 5ZZ</contact:pc>
<contact:cc>GB</contact:cc>
</contact:addr>
</contact:postalInfo>
</contact:chg>
</contact:update>
</update>
<extension>
<contact-ext:update
xmlns:contact-ext="http://www.nominet.org.uk/epp/xml/contact-nom-ext-1.0"
xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/contact-nom-ext-1.0
contact-nom-ext-1.0.xsd">
<contact-ext:trad-name>Example trading name</contact-ext:trad-name>
<contact-ext:type>LTD</contact-ext:type>
<contact-ext:co-no>NI65786</contact-ext:co-no>
<contact-ext:opt-out>N</contact-ext:opt-out>
</contact-ext:update>
</extension>
<clTRID>ABC-12345</clTRID>
</command>
</epp>
Notes:
- The <contact:org> field cannot be provided as part of a <contact:update> operation.
- If the <contact:name> field is provided as part of a <contact:update>, the registrant name is not modified only the main admin contact name.
Nameservers
The <host:update> operation is described in
RFC 5732 and allows the following modifications to a nameserver object with a given name:
- Modify the name field.
- Modify the ipv4 field
- Modify the ipv6 field.
Contact-id
The <contact-id:update> operation allows the contact-id associated with a Nominet account to be amended. The new value must be unique across the registry.
Example of a <contact-id:update> operation
<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<epp xmlns="urn:ietf:params:xml:ns:epp-1.0"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="urn:ietf:params:xml:ns:epp-1.0 epp-1.0.xsd">
<command>
<update>
<contact-id:update
xmlns:contact-id="http://www.nominet.org.uk/epp/xml/std-contact-id-1.0"
xsi:schemaLocation="http://www.nominet.org.uk/epp/xml/std-contact-id-1.0
std-contact-id-1.0.xsd">
<contact-id:id>S79TA01</contact-id:id>
<contact-id:chg>
<contact-id:id>S79TA01NEW</contact-id:id>
</contact-id:chg>
</contact-id:update>
</update>
<clTRID>ABC-12345</clTRID>
</command>
</epp>