Inhaltsverzeichnis dieser Seite

Funktion

Der Autragstyp ZoneCreate legt eine neue Zone auf den vom System verwalteten Nameservern an.

Beschreibung

Route: POST/zone

Request
{
   "origin": "example.com",
   "soa": {
      "refresh": 3600,
      "retry": 7200,
      "expire": 604800,
      "ttl": 600,
      "email": "customer@example.com"
   },
   "dnssec": false,
   "allowTransfer": false,
   "nameServers": [
      {
         "name": "ns1.example.com",
         "ttl": 600,
         "ipAddresses": [
            "1.2.3.4"
         ]
      },
      {
         "name": "ns2.example.com",
         "ttl": 600,
         "ipAddresses": [
            "4.3.2.1"
         ]
      }
   ],
   "main": {
      "address": "7.7.7.7",
      "ttl": 86000
   },
   "wwwInclude": true,
   "action": "COMPLETE",
   "resourceRecords": [
      {
         "name": "subdomainexample",
         "ttl": 600,
         "type": "A",
         "value": "1.3.5.7"
      }
   ]
}
Response
{
   "stid": "20190701-app2-dev-15785",
   "status": {
      "code": "S0205",
      "text": "Zonen-Informationen 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: 0201
Verwendet
Objekt Zone

Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0201</code>
		<zone>
			<name>example.com</name>
			<main>
				<value>172.16.100.1</value>
				<ttl>86400</ttl>
			</main>
			<ns_action>complete</ns_action>
			<www_include>1</www_include>
			<allow_transfer_from>198.51.100.0/24</allow_transfer_from>
			<soa>
				<level>1</level>
				<refresh>43200</refresh>
				<retry>7200</retry>
				<expire>1209600</expire>
				<ttl>86400</ttl>
				<email>zonec@example.com</email>
			</soa>
			<nserver>
				<name>ns1.example.com</name>
				<ttl>86400</ttl>
			</nserver>
			<nserver>
				<name>ns2.example.com</name>
				<ttl>86400</ttl>
			</nserver>
			<rr>
				<name>mail</name>
				<ttl>103600</ttl>
				<type>MX</type>
				<pref>10</pref>
				<value>mail.example.com</value>
			</rr>
			<rr>
				<name>www</name>
				<ttl>86400</ttl>
				<type>NS</type>
				<pref></pref>
				<value>ns1.example.com</value>
			</rr>
			<!-- Beispiel für ein Domainkey-Eintrag -->
			<rr>
				<name>default._domainkey</name>
				<type>TXT</type>
				<pref></pref>
				<ttl></ttl>
				<value>p=mVMdtsXfXxyakdNwK3CB/5nnV6dVSLTthZGMpKE9rLkfwIDAQAB</value>
			</rr>
			<!-- Beispiel freier Texteintrag für einen Record (Vorsicht) -->
			<free>internetconfiguration 1800 IN A 11.22.33.44</free>
			<free>mail 1800 IN A 22.33.44.55</free>
		</zone>
	</task>
</request>
Response
 <response>
     <result>
         <status>
             <code>S0201</code>
             <text>Die Zone wurde auf dem Nameserver eingetragen.</text>
             <text></text>
             <type>success</type>
             <object>
                 <type>zone</type>
                 <value>example.com</value>
             </object>
         </status>
     </result>
 </response>

Mögliche Fehlermeldungen

  • EF02010 - Ungueltiger primaerer Nameserver.
  • EF02011 - Der primaere Nameserver ist doppelt eingetragen.
  • EF02012 - Die IP-Adresse des primaeren Nameservers konnte nicht ermittelt werden.
  • EF02013 - Der sekundaere Nameserver ist ungueltig.
  • EF02014 - Der sekundaere Nameserver ist doppelt eingetragen.
  • EF02015 - Die IP-Adresse der sekundaeren Nameservers konnte nicht ermittelt werden.
  • EF02016 - Keiner der angegebenen primären Nameserver wird von uns verwaltet.
  • EF02017 - Benutzer ist fuer diesen Nameserver nicht berechtigt.
  • EF02018 - Keiner der angegebenen sekundären Nameserver wird von uns verwaltet.
  • EF02019 - Diese Zone ist bereits eingetragen.
  • E0202002 - Zone konnte auf dem Nameserver nicht aktualisiert werden.
  • EF02025 - Keiner der angegebenen Nameserver wird von uns verwaltet.