Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.
Panel
titleColor#FFFFFF
titleBGColor#E44313
titleTable of Contents

Table of Contents
outlinetrue
stylenone

Function

The ZoneList task displays the zone data of multiple zones on the name servers managed by the system.

Note

You can find more information about list queries here

Description

SP Tabs group
dispositionhorizontal
SP Tab pane
anchor2286824
nameJSON


Route: GET /zone/{name}/{nameserver}

            or  : GET /zone/{name}

No body has to be sent with the request.

Code Block
languagejs
titleRequest
linenumberstrue
collapsetrue
GET/zone/{example.com}/{ns1.example.com}
or GET/zone/{example.com}
Code Block
languagejs
titleResponse
linenumberstrue
collapsetrue
{
  "status" : {
    "code" : "S0205",
    "text" : "Zoneninformationen wurden erfolgreich ermittelt.",
    "type" : "SUCCESS"
  },
  "object" : {
    "type" : "Zone",
    "value" : "jsonthilo.test"
  },
  "data" : [ {
    "created" : "2017-11-07T12:55:38.000+0100",
    "updated" : "2022-04-19T11:28:20.000+0200",
    "origin" : "jsonthilo.test",
    "soa" : {
      "refresh" : 39940,
      "retry" : 7200,
      "expire" : 604800,
      "ttl" : 86400,
      "email" : "thilo.schwarz@internetx.de"
    },
    "owner" : {
      "context" : 1,
      "user" : "autodns_admin_9"
    },
    "updater" : {
      "context" : 1,
      "user" : "root"
    },
    "purgeDate" : "2022-04-19T00:00:00.000+0200",
    "purgeType" : "DISABLED",
    "nameServers" : [ {
      "name" : "ns1.noop.de",
      "ttl" : 8600
    }, {
      "name" : "ns2.noop.de",
      "ttl" : 8600
    } ],
    "main" : {
      "address" : "62.116.161.124",
      "ttl" : 8600
    },
    "wwwInclude" : false,
    "virtualNameServer" : "ns1.noop.de",
    "action" : "COMPLETE",
    "grants" : [ "192.168.100.64" ],
    "resourceRecords" : [ {
      "name" : "",
      "ttl" : 200,
      "type" : "MX",
      "value" : "mx.mueller.de.",
      "pref" : 10
    } ],
    "roid" : 3172243
  } ]
}
SP Tab pane
anchor87031
nameXML

Task code: 0205
Uses Zone object

Code Block
languagexml
titleRequest
linenumberstrue
collapsetrue
<?xml version="1.0" encoding="utf-8"?>
<request>
	<auth>
		<user>autodns_admin_8</user>
		<password>test</password>
		<context>1</context>
	</auth>
	<task>
		<code>0205</code>
		<zone>
			<name>thomasproll.test</name>
			<system_ns>pdns1.testsys.autodns2.de</system_ns>
		</zone>

	</task>
</request>
Code Block
languagexml
titleResponse
linenumberstrue
collapsetrue
<response>
    <result><data>
            <zone>
                <changed>2010-06-24 12:17:25</changed>
                <created>2010-04-19 12:40:33</created>
                <name>thomasproll.test</name>
                <main>
                    <value>62.116.161.124</value>
                    <ttl>8600</ttl>
                </main>
                <ns_action>complete</ns_action>
                <www_include>0</www_include>
                <allow_transfer_from>192.168.100.64</allow_transfer_from>
                <soa>
                    <refresh>1000</refresh>
                    <retry>2000</retry>
                    <expire>3000</expire>
                    <ttl>4000</ttl>
                    <email>thomas.proll@internetx.de</email>
                    <default>4000</default>
                </soa>
                <nserver>
                    <name>pdns1.testsys.autodns2.de</name>
                    <ttl>8600</ttl>
                </nserver>
                <nserver>
                    <name>pdns2.testsys.autodns2.de</name>
                    <ttl>8600</ttl>
                </nserver>
                <rr>
                    <name />
                    <ttl>200</ttl>
                    <type>MX</type>
                    <pref>10</pref>
                    <value>mx.mueller.de.</value>
                </rr>
                <system_ns>pdns1.testsys.autodns2.de</system_ns>
                <domainsafe>0</domainsafe>
                <owner>
                    <user>autodns_admin_8</user>
                    <context>1</context>
                </owner>
                <updated_by>
                    <user>root</user>
                    <context>1</context>
                </updated_by>
                <purge_date>2023-05-25 00:00:00</purge_date>
                <purge_type>AUTO</purge_type>
            </zone>
        </data>
        <status><code>S0205</code>
            <type>success</type><object>
                <type>zone</type>
                <value>thomasproll.test</value>
            </object>
        </status>
    </result>
</response>