Panel

titleColor	#FFFFFF
titleBGColor	#E44313
title	Inhaltsverzeichnis dieser Seite

Table of Contents

outline	true
style	none

Funktion

Der Auftragstyp ZoneUpdate aktualisiert eine Zone auf dem Nameserver.

Tip

Werte von Zoneneinträgen suchen und ersetzen

:

Mit dem Keyword <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

SP Tabs group

disposition	horizontal

SP Tab pane

anchor	2286824
name	JSON

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

Code Block

language	js
title	Request
linenumbers	true
collapse	true

{
    "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"
      }
   ]
}

Code Block

language	js
title	Response
linenumbers	true
collapse	true

{
   "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"
      }
   }
}

SP Tab pane

anchor	87031
name	XML

Auftragstyp-Code: 0202
Verwendet Objekt Zone

Code Block

language	xml
title	Request
linenumbers	true
collapse	true

<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>

Code Block

language	xml
title	Response
linenumbers	true
collapse	true

<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.

Code Block

language	xml
title	Request
linenumbers	true
collapse	true

<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.

Code Block

language	xml
title	Request
linenumbers	true
collapse	true

<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>

Code Block

language	xml
title	Response
linenumbers	true
collapse	true

<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>

Versions Compared

Old Version 27

New Version Current

Key

Funktion

Beschreibung

Page History

Versions Compared

Old Version 27

New Version Current

Key

Funktion

Beschreibung