Inhaltsverzeichnis dieser Seite

Funktion

Der Auftragstyp ZoneInfo zeigt die Zonen-Daten mehrerer Zonen auf den vom System verwalteten Nameservern an.

Weitere Informationen zum Thema Listenabfragen findest du hier.

Beschreibung

Route: POST/zone/_search?keys=<key>

Query-Parameter

Die Daten folgender Schlüsselwörter können mit dem Query-Parameter ?keys[]= abgefragt werden:

  • action
  • changed
  • comment
  • created
  • domainsafe
  • mainip
  • name
  • primary
  • secondary1
  • secondary2
  • secondary3
  • secondary4
  • secondary5
  • secondary6
  • secondary7
  • updated
  • virtualNameServer
  • dnssec
Request
{
   "filters": [
      {
         "key": "name",
         "value": "example",
         "operator": "LIKE",
         "link": "AND",
         "filters": []
      }
   ],
   "view": {
      "limit": 10,
      "offset": 0,
      "children": true,
      "from": "2019-01-13T12:31:33.6306444Z",
      "to": "2019-05-13T12:31:33.6306444Z"
   }
}

Response
{
   "stid": "20190701-app2-dev-15785",
   "status": {
      "code": "S0205",
      "text": "Zoneninformationen wurden erfolgreich ermittelt.",
      "type": "SUCCESS"
   },
   "object": {
      "type": "Zone",
      "summary": 3
   },
   "data": [
      {
         "created": "2014-10-24T09:42:57.000+0200",
         "updated": "2017-11-17T17:35:40.000+0100",
         "origin": "example.com",
         "owner": {
            "context": 4,
            "user": "customer"
         },
         "updater": {
            "context": 1,
            "user": "customer"
         },
         "virtualNameServer": "ns1.nameserver.com"
      },
      {
         "created": "2019-05-13T11:26:36.000+0200",
         "updated": "2019-05-13T13:51:20.000+0200",
         "origin": "example2.org",
         "dnssec": false,
         "owner": {
            "context": 4,
            "user": "customer"
         },
         "updater": {
            "context": 4,
            "user": "customer"
         },
         "virtualNameServer": "ns2.nameserver.com"
      },
      {
         "created": "2019-05-13T11:26:36.000+0200",
         "updated": "2019-05-17T13:33:02.000+0200",
         "origin": "example3.com",
         "dnssec": false,
         "owner": {
            "context": 4,
            "user": "customer"
         },
         "updater": {
            "context": 4,
            "user": "customer"
         },
         "virtualNameServer": "ns3.nameserver.com"
      }
   ]
}

Auftragstyp-Code: 0205
Verwendet Objekt Zone

Schlüsselwörter

Folgende Schlüsselwörter werden standardmäßig zurückgegeben:

  • domainsafe
  • name
  • system_ns

Die Daten folgender Schlüsselwörter können mit dem Schlüsselwort "key" zusätzlich abgefragt werden: 

  • primary
  • secondary1
  • secondary2
  • secondary3
  • secondary4
  • secondary5
  • secondary6
  • secondary7
  • main
  • dnssec
  • updated_by
  • comment
Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context></context>
	</auth>
	<task>
		<code>0205</code>
		<view>
			<offset>0</offset>
			<limit>4</limit>
			<children>1</children>
		</view>
		<key>created</key>
		<key>primary</key>
		<key>system_ns</key>
		<key>secondary2</key>
		<key>mainip</key>
		<key>changed</key>
		<where>
			<key>name</key>
			<operator>like</operator>
			<value>origin</value>
		</where>
		<order>
			<key>changed</key>
			<mode>DESC</mode>
		</order>
		<order>
			<key>changed</key>
			<mode>DESC</mode>
		</order>
	</task>
</request>
Response
<response>
	<result>
		<data>
			<summary>1</summary>
			<zone>
				<changed>2014-12-02 09:49:20</changed>
				<created>2013-11-12 13:37:04</created>
				<name>example.com</name>
				<primary>ns1.example.com</primary>
				<domainsafe>0</domainsafe>
				<owner>
					<user>customer</user>
					<context></context>
				</owner>
				<updated_by>
					<user>customer</user>
					<context>1018945</context>
				</updated_by>
				<system_ns>ns1.example.com</system_ns>
			</zone>
		</data>
		<status>
			<code>S0205</code>
			<text>Zoneninformationen wurden erfolgreich ermittelt.</text>
			<type>success</type>
		</status>
	</result>
	<stid>20160218-app2-dev-2603</stid>
</response>