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>
                        <record:flag>#RECORD FLAG#</record:flag>
                        <record:tag>#RECORD TAG#</record:tag>
                    </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>
                        <record:flag>#RECORD FLAG#</record:flag>
                        <record:tag>#RECORD TAG#</record:tag>
                    </zone:record>
                </zone:change>
            </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)
R/O	#RECORD FLAG#	The issuer critical flag (in case of CAA record)
R/O	#RECORD TAG#	The tag (issue/issuewild/iodef, in case of CAA record)

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 specified in the request and/or answer