Inhaltsverzeichnis dieser Seite

Funktion

Der Auftragstyp ZoneUpdate aktualisiert eine Zone auf dem Nameserver.

  • Werte von Zoneneinträgen suchen und ersetzen:  Mit dem Schlüsselwort <search_and_replace> kannst du nach Werten suchen und diese mit einem anderen Wert ersetzen. Hierbei sind rr_add oder rr_rem Blöcke nicht erforderlich. Sie können aber zusätzlich verwendet werden, ohne die Funktionalität zu stören.
  • Bei diesem Auftrag kannst du dir optional eine Bestätigungsmail zukommen lassen. Dazu verwendest du für XML den Tag <email_confirmation>your@mailaddress.com</email_confirmation> und für JSON den URL-Parameter  "confirmation_email-your@mailaddress.com" 

Beschreibung

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

Request
{
    "origin": "example.com",
    "soa": {
        "email": "do-not-reply@example.com",
        "refresh": "43200",
        "retry": "7200",
        "expire": "1209600",
        "ttl": "86400"
    },
    "dnssec": "false",
    "allowTransfer": "true",
    "grants": [
        "5.5.5.5",
        "6.6.6.6"
    ],
    "domainsafe": "false",
    "action": "COMPLETE",
    "nameServers": [
        {
            "name": "ns1.example.com",
            "ttl": "86400",
            "ipAddresses": [
                "1.1.1.1"
            ]
        },
        {
            "name": "ns2.example.com",
            "ttl": "86400"
        }
    ],
    "wwwInclude": "true",
    "main": {
        "address": "2.2.2.2",
        "ttl": "86400"
    },
   "resourceRecords": [
      {
         "name": "subdomainexample",
         "ttl": 600,
         "type": "A",
         "value": "1.3.5.7"
      },
      {
         "name": "newsubdomain",
         "ttl": 1200,
         "type": "A",
         "value": "3.2.1.0"
      }
   ]
}
Response
{
   "stid": "20190701-app2-dev-21948",
   "status": {
      "code": "S0202",
      "text": "Zone wurde erfolgreich auf dem Nameserver aktualisiert.",
      "type": "SUCCESS"
   },
   "object": {
      "type": "Zone",
      "value": "example.com",
      "data": {
         "origin": "example.com",
         "virtualNameServer": "ns1.example.com"
      }
   }
}

Auftragstyp-Code: 0202
Verwendet Objekt Zone

Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context>4</context>
	</auth>
	<task>
		<code>0202</code>
		<zone>
			<name>example.com</name>
			<system_ns>ns1.example.com</system_ns>
			<main>
				<value>172.16.100.1</value>
				<ttl>86400</ttl>
			</main>
			<ns_action>complete</ns_action>
			<www_include>1</www_include>
			<soa_level>3</soa_level>
			<allow_transfer_from>198.51.100.0/24</allow_transfer_from>
			<soa>
				<refresh>43200</refresh>
				<retry>7200</retry>
				<expire>1209600</expire>
				<ttl>600</ttl>
				<ignore></ignore>
				<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>
		</zone>
	</task>
</request>
Response
<response>
	<result>
		<status>
			<code>S0202</code>
			<text>Die Zone wurde auf dem Nameserver aktualisiert.</text>
			<text></text>
			<type>success</type>
			<object>
				<type>zone</type>
				<value>example.com</value>
			</object>
		</status>
	</result>
</response>

Beispiel für "Search and Replace". Jeder TTL-Wert wird mit dem Wert "600" ersetzt.

Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context></context>
	</auth>
	<task>
		<code>0202</code>
		<zone>
			<name>example.com</name>
			<system_ns>ns1.example.com</system_ns>
			<main>
				<value>172.16.100.1</value>
				<ttl>86400</ttl>
			</main>
			<ns_action>complete</ns_action>
			<www_include>1</www_include>
			<search_and_replace>
				<search>*</search>
				<type>TTL</type>
				<replace>600</replace>
			</search_and_replace>
			<allow_transfer_from>198.51.100.0/24</allow_transfer_from>
			<soa>
				<refresh>43200</refresh>
				<retry>7200</retry>
				<expire>1209600</expire>
				<ttl>600</ttl>
				<ignore></ignore>
				<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>
		</zone>
		<email_confirmation>confirm@customer.com</email_confirmation>
	</task>

Beispiel für "Search and Replace". Jeder TTL-Wert wird mit dem Wert "600" ersetzt.

Request
<request>
	<auth>
		<user>customer</user>
		<password>password</password>
		<context></context>
	</auth>
	<task>
		<code>0202</code>
		<zone>
			<name>example.com</name>
			<system_ns>ns1.example.com</system_ns>
			<main>
				<value>172.16.100.1</value>
				<ttl>86400</ttl>
			</main>
			<ns_action>complete</ns_action>
			<www_include>1</www_include>
			<search_and_replace>
				<search>*</search>
				<type>TTL</type>
				<replace>600</replace>
			</search_and_replace>
			<allow_transfer_from>198.51.100.0/24</allow_transfer_from>
			<soa>
				<refresh>43200</refresh>
				<retry>7200</retry>
				<expire>1209600</expire>
				<ttl>600</ttl>
				<ignore></ignore>
				<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>
		</zone>
	</task>
Response
<response>
	<result>
		<status>
			<code>S0202</code>
			<text>Die Zone wurde auf dem Nameserver aktualisiert.</text>
			<text></text>
			<type>success</type>
			<object>
				<type>zone</type>
				<value>example.com</value>
			</object>
		</status>
	</result>
</response>

Mögliche Fehlermeldungen

  • E0202 - Zone konnte nicht auf dem Nameserver aktualisiert werden.
  • E0242 - Subzone konnte nicht aktualisiert werden.
  • EF02020 - Diese Zone ist bisher nicht eingetragen.
  • EF02034 - Eine Zone mit diesem Nameserver existiert nicht.
  • EF012003 - Die Aktion kann nicht durchgeführt werden. Es muss zuerst DNSSEC deaktiviert werden.
  • EF02013 - Der sekundaere Nameserver ist ungueltig.
  • E0202002 - Zone konnte auf dem Nameserver nicht aktualisiert werden.
  • EF02025 - Keiner der angegebenen Nameserver wird von uns verwaltet.