Zone:update

How to modify an existing zone’s records

Use the requests on this page to manage a zone’s records. You can add new records and remove/change existing ones. You may only manage zones and/or records for domains that are in your account.

XML Template for adding DNS records to domain zone
<?xml version="1.0" encoding="UTF-8"?>
    <request xmlns:zone="http://www.eurodns.com/zone">
        <zone:update>
            <zone:name>#DOMAIN.TLD#</zone:name>
            <zone:records>
                <zone:add>
                    <zone:record>
                        <record:type>#RECORD TYPE#</record:type>
                        <record:host>#RECORD HOST#</record:host>
                        <record:data>#RECORD DATA#</record:data>
                        <record:serial>#RECORD SERIAL#</record:serial>
                        <record:refresh>#RECORD REFRESH#</record:refresh>
                        <record:retry>#RECORD RETRY#</record:retry>
                        <record:expire>#RECORD EXPIRE#</record:expire>
                        <record:minimum>#RECORD MINIMUM#</record:minimum>
                        <record:mx_priority>#RECORD MX PRIORITY#</record:mx_priority>
                        <record:ttl>#RECORD TTL#</record:ttl>
                        <record:resp_person>#RECORD RESP PERSON#</record:resp_person>
                    </zone:record>
                </zone:add>
            </zone:records>
        </zone:update>
    </request>
XML Template for removing records from DNS domain zone
<?xml version="1.0" encoding="UTF-8"?>
    <request xmlns:zone="http://www.eurodns.com/zone">
        <zone:update>
            <zone:name>#DOMAIN.TLD#</zone:name>
            <zone:records>
                <zone:remove>
                    <zone:record id="#RECORD ID#"/>
                </zone:remove>
            </zone:records>
        </zone:update>
    </request>
XML Template for editing existing record of domain zone
<?xml version="1.0" encoding="UTF-8"?>
    <request xmlns:zone="http://www.eurodns.com/zone">
        <zone:update>
            <zone:name>#DOMAIN.TLD#</zone:name>
            <zone:records>
                <zone:change>
                    <zone:record id="#RECORD ID#">
                        <record:type>#RECORD TYPE#</record:type>
                        <record:host>#RECORD HOST#</record:host>
                        <record:data>#RECORD DATA#</record:data>
                        <record:serial>#RECORD SERIAL#</record:serial>
                        <record:refresh>#RECORD REFRESH#</record:refresh>
                        <record:retry>#RECORD RETRY#</record:retry>
                        <record:expire>#RECORD EXPIRE#</record:expire>
                        <record:minimum>#RECORD MINIMUM#</record:minimum>
                        <record:mx_priority>#RECORD MX PRIORITY#</record:mx_priority>
                        <record:ttl>#RECORD TTL#</record:ttl>
                        <record:resp_person>#RECORD RESP PERSON#</record:resp_person>
                    </zone:record>
                </zone:add>
            </zone:records>
        </zone:update>
    </request>

<resData> (Occurrences: 1)

R #DOMAIN.TLD# The name of the domain to create the zone for

<zone:records> (Occurrences: 1+)

Note: If the zone contact multiple records, this section will be repeated. Depending on the type, more or less elements will be returned.

R #RECORD ID# Identifier of the record (can be retrieve by performing zone:info request)
R #RECORD TYPE# Type of the record (SOA, NS, PTR, MX, A, CNAME, AAAA, TXT, APEX, CAA)
R #RECORD HOST# Host of the record
R #RECORD DATA# Data of the record
R/O #RECORD TTL# How long to cache records retrieved from the zone file (600, 900, 1800, 3600, 7200, 14400, 21600, 43200, 86400, 172800, 432000, 604800)
R/O #RECORD SERIAL# Used by secondary DNS servers to check if the zone has changed
R/O #RECORD REFRESH# How often secondary DNS servers should check if changes are made to the zone
R/O #RECORD EXPIRE# How long the zone will be valid after a refresh
R/O #RECORD RESP PERSON# ISpecifies the domain mailbox name for a responsible person
R/O #RECORD MINIMUM# Used as the default TTL for new records created within the zone
R/O #RECORD MX PRIORITY# If record type is MX, priority of the MX record (10, 20, 30, 40, 50, 60, 70, 80, 90, 100)
If the action was successful, the following code will be returned:
<?xml version="1.0" encoding="UTF-8"?>
    <response xmlns="http://www.eurodns.com/">
        <result code="1000">
            <msg><![CDATA[Command completed successfully]]></msg>
        </result>
    </response>

Legend

O The element is optional and does not have to be specified in the request and/or answer
R The element is mandatory and has to specifed in the request and/or answer