Zoneprofile:update
Modify the records and the name of an existing zone profile
Use the requests on this page to manage the records and the attributes of a zone profile. You can add new records and remove/change existing ones.
XML Template for adding DNS records to zone profile
<?xml version="1.0" encoding="UTF-8"?>
<request xmlns:zoneprofile="http://www.eurodns.com/zoneprofile">
<zoneprofile:update>
<zoneprofile:id>#PROFILE ID#</zoneprofile:id>
<zoneprofile:name>#PROFILE NAME#</zoneprofile:name>
<zoneprofile:records>
<zoneprofile:add>
<zoneprofile:record>
<record:type>#RECORD TYPE#</record:type>
<record:redirection_type>#RECORD REDIRECTION TYPE#</record:redirection_type>
<record:newurl>#RECORD NEWURL#</record:newurl>
<record:source>#RECORD SOURCE#</record:source>
<record:destination>#RECORD DESTINATION#</record:destination>
<record:host>#RECORD HOST#</record:host>
<record:data>#RECORD DATA#</record:data>
<record:ttl>#RECORD TTL#</record:ttl>
<record:mx_priority>#RECORD MX PRIORITY#</record:mx_priority>
<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:serial>#RECORD SERIAL#</record:serial>
<record:resp_person>#RECORD RESP PERSON#</record:resp_person>
<record:weight>#RECORD WEIGHT#</record:weight>
<record:port>#RECORD PORT#</record:port>
<record:flag>#RECORD FLAG#</record:flag>
<record:tag>#RECORD TAG#</record:tag>
</zoneprofile:record>
</zoneprofile:add>
</zoneprofile:records>
</zoneprofile:update>
</request>
XML Template for removing records from zone profile
<?xml version="1.0" encoding="UTF-8"?>
<request xmlns:zoneprofile="http://www.eurodns.com/zoneprofile">
<zoneprofile:update>
<zoneprofile:id>#PROFILE ID#</zoneprofile:id>
<zoneprofile:name>#PROFILE NAME#</zoneprofile:name>
<zoneprofile:records>
<zoneprofile:remove>
<zoneprofile:record>
<record:id>#RECORD ID#</record:id>
</zoneprofile:record>
</zoneprofile:remove>
</zoneprofile:records>
</zoneprofile:update>
</request>
XML Template for editing existing record of zone profile
<?xml version="1.0" encoding="UTF-8"?>
<request xmlns:zoneprofile="http://www.eurodns.com/zoneprofile">
<zoneprofile:update>
<zoneprofile:id>#PROFILE ID#</zoneprofile:id>
<zoneprofile:name>#PROFILE NAME#</zoneprofile:name>
<zoneprofile:records>
<zoneprofile:change>
<zoneprofile:record>
<record:id>#RECORD ID#</record:id>
<record:type>#RECORD TYPE#</record:type>
<record:redirection_type>#RECORD REDIRECTION TYPE#</record:redirection_type>
<record:newurl>#RECORD NEWURL#</record:newurl>
<record:source>#RECORD SOURCE#</record:source>
<record:destination>#RECORD DESTINATION#</record:destination>
<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>
</zoneprofile:record>
</zoneprofile:change>
</zoneprofile:records>
</zoneprofile:update>
</request>
<resData> (Occurrences: 1)
R | #PROFILE ID# | Identifier of the profile (can be retrieved by performing zoneprofile:list request) |
R/0 | #PROFILE NAME# | Name of the zone profile. (required if you wish to update the profile name) |
<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 retrieved by performing zoneprofile:info request ; required in case of record update or deletion) |
R | #RECORD TYPE# | Type of the record (SOA, NS, PTR, MX, A, CNAME, AAAA, TXT, APEX, CAA, UrlForward, MailForward) |
R/O | #RECORD REDIRECTION TYPE# | http301, http302, frame (urlForward) |
R/O | #RECORD NEWURL# | New url of the record (urlForward) |
R/O | #RECORD SOURCE# | Source of the record (mailForward) |
R/O | #RECORD DESTINATION# | Destination of the record (mailForward) |
R/O | #RECORD HOST# | Host of the record |
R/O | #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 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 REFRESH# | If record type is SOA, how often secondary DNS servers should check if changes are made to the zone |
R/O | #RECORD RETRY# | If record type is SOA. |
R/O | #RECORD EXPIRE# | If record type is SOA, how long the zone will be valid after a refresh. |
R/O | #RECORD MINIMUM# | If record type is SOA, used as the default TTL for new records created within the zone. |
R/O | #RECORD SERIAL# | If record type is SOA, used by secondary DNS servers to check if the zone has changed |
R/O | #RECORD RESP PERSON# | If record type is SOA, specifies the domain mailbox name for a responsible person |
R/O | #RECORD WEIGHT# | If record type is SRV |
R/O | #RECORD PORT# | If record type is SRV |
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 |