Inhaltsverzeichnis dieser Seite

Funktion

Der Auftragstyp ZoneImport importiert Zonen auf Nameserver, die vom System verwaltet werden.

Der Auftragstyp  ZoneImport kann für externen- und internen Zonen-Import verwendet werden

Bei einem internen Import muss der Key sourceVirtualHostname (für Json) und source_system_ns (für XML) verwendet werden, bei einem externen Import der Key source.

Beschreibung

Route: POST /zone/{name}/{systemNameServer}/_import

Beispiel für internen Import

Request
{  
  "origin": "example.com",
  "soa": {     
    "refresh": 3600,
    "retry": 7200,
    "expire": 604800,
    "ttl": 600,
    "email": "customer@example.com"
  },
  "dnssec": true,
  "allowTransfer": true,
  "sourceVirtualHostname": "myexample.de",
  "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": "PRIMARY",
  "resourceRecords": [
    {
      "name": "subdomainexample",
      "ttl": 600,
      "type": "A",
      "value": "1.3.5.7"
    }
  ]
}
Response
{
   "stid": "20190701-app-11942",
   "status": {
      "code": "S0204",
      "text": "Import der Zone wurde erfolgreich durchgefuehrt.",
      "type": "SUCCESS"
   },
   "object": {
      "type": "Zone",
      "value": "example.com"
   }
}

Beispiel für externen Import

Request
{  
  "origin": "example.com",
  "soa": {     
    "refresh": 3600,
    "retry": 7200,
    "expire": 604800,
    "ttl": 600,
    "email": "customer@example.com"
  },
  "dnssec": true,
  "allowTransfer": true,
  "source": "9.8.7.6",
  "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": "PRIMARY",
  "resourceRecords": [
    {
      "name": "subdomainexample",
      "ttl": 600,
      "type": "A",
      "value": "1.3.5.7"
    }
  ]
}
Response
{
   "stid": "20190701-app-12345",
   "status": {
      "code": "S0204",
      "text": "Import der Zone wurde erfolgreich durchgefuehrt.",
      "type": "SUCCESS"
   },
   "object": {
      "type": "Zone",
      "value": "example.com"
   }
}

Auftragstyp-Code: 0204
Verwendet Objekt
Zone

Beispiel für internen Import

Request
<request>
    <auth>
        <user>customer</user>
        <password>password</password>
        <context>4</context>
    </auth>
    <task>
        <code>0204</code>
        <default>
            <source_system_ns>myexample.de</source_system_ns>
            <ns_action>primary</ns_action>
            <soa>
                <email>email@example.de</email>
            </soa>
            <nserver>
                <name>ns1.example.com</name>
            </nserver>
            <nserver>
                <name>ns2.example.com</name>
            </nserver>
        </default>
        <zone>
            <name>example.com</name>
        </zone>
        <zone>
            <name>example.com</name>
        </zone>
        <reply_to>mail@example.com</reply_to>
    </task>
</request>
Response
<response>
	<result>
		<status>
			<code>S0204</code>
			<text>Import der Zone wurde erfolgreich durchgefuehrt.</text>
			<type>success</type>
			<object>
				<type>zone</type>
				<value>example.com</value>
			</object>
		</status>
	</result>
</response>

Beispiel für externen Import

Request
<request>
    <auth>
        <user>customer</user>
        <password>password</password>
        <context>4</context>
    </auth>
    <task>
        <code>0204</code>
        <default>
            <source>9.8.7.6</source>
            <ns_action>primary</ns_action>
            <soa>
                <email>email@example.de</email>
            </soa>
            <nserver>
                <name>ns1.example.com</name>
            </nserver>
            <nserver>
                <name>ns2.example.com</name>
            </nserver>
        </default>
        <zone>
            <name>example.com</name>
        </zone>
        <zone>
            <name>example.com</name>
        </zone>
        <reply_to>mail@example.com</reply_to>
    </task>
</request>
Response
<response>
	<result>
		<status>
			<code>S0204</code>
			<text>Import der Zone wurde erfolgreich durchgefuehrt.</text>
			<type>success</type>
			<object>
				<type>zone</type>
				<value>example.com</value>
			</object>
		</status>
	</result>
</response>

Mögliche Fehlermeldungen

  • EF02001 - Der Zonen-Name ist ungueltig.
  • 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 primaeren Nameserver wird von uns verwaltet.
  • EF02017 - Benutzer ist für diesen Nameserver nicht berechtigt.
  • EF02018 - Keiner der angegebenen sekundaeren Nameserver wird von uns verwaltet.
  • EF02019 - Diese Zone ist bereits eingetragen.
  • EF02037 - Zonen-Transfer (AXFR) konnte nicht vollstaendig durchgefuehrt werden.