Start
/
API-Referenz
/
API-Dokumentation (XML/ JSON)
/
Objekte

Objekt Zone

API-Referenz (XML/JSON) · Aktualisiert 2023-09-11

Beschreibung

Das Objekt Zone definiert die DNS-Information, die für eine Domain auf Nameservern gespeichert ist.

Aufbau

JSON Keyword	XML Keyword	Häufigkeit	Typ	Format	Beschreibung
action	ns_action	0 - 1	enum	NameServerActionConstants	Zusätzliche Nameserverprüfung wird durchgeführt.
allowTransfer	allow_transfer	0 - 1	boolean		AXFR erlauben false = AXFR nicht erlauben true = AXFR erlauben Vorgabewert = false Für XML können auch 0 (false) und 1 (true) verwendet werden.
comment	comment	0 - 1	string		Benutzerdefiniertes Feld. JSON: Aktualisierung nur mit PUT /zone/{name}/{nameserver}/_comment. Es sind entsprechende ACLs erforderlich.
created	created	0 - 1	string	date-time	Datum, an dem die Zone angelegt wurde.
dnssec	dnssec	0 - 1	boolean		Aktiviert DNSSEC.
domainsafe	domainsafe	0 - 1	boolean		Zone liegt im Domainsafe.
freeText	free	0 - n	string		Freie Einträge für die Zone. Verwende diese Möglichkeit nur, wenn du mit dem Domain Name System vertraut bist. Andernfalls kann dies zur Nicht-Erreichbarkeit deiner Domain führen.
grants	allow_transfer_from	0 - 1	string	ip	IP-Adressen oder Netze, mit „;“ trennen. Immer mit „;“ abschließen.
idn	idn	0 - 1	string		IDN-Version des Origins
main	main	0 - 1	object	MainIp	Haupt-IP-Adresse der Zone. Bei ns_action "primary" und "complete" erforderlich.
nameServerGroup	ns_group	0 - 1	string		Name der Nameservergruppe
nameServers	nserver	1 - 7^*)	object	NameServer	Liste der Nameserver
origin	name	1	string	domain	Name der Zone
	nscheck	0 - 1	enum	DNSCheckConstants	Zusätzliche Nameserver-Checks werden ausgeführt.
owner	owner	0 - 1	object	BasicUser	Besitzer des Objektes.
records	rr	0 - n	object	ResourceRecord	Resource-Record
soa	soa	1	object	SOA	Angaben zur Verwaltung der Zone
source	source	1	string	hostname	Nameserver, von dem eine Zone per AXFR kopiert wird (bei zone_import).
virtualNameServer	system_ns	0 - 1	string	hostname	Der erste vom System verwaltete Nameserver
updater	updater	0 - 1	object	BasicUser	Benutzer, der die Zone zuletzt aktualisiert hat.
wwwInclude	www_include	0 - 1	boolean		Automatisch „www“-Resource-Records erzeugen. false = „www“-Resource-Records nicht erzeugen true 0 = „www“-Resource-Records erzeugen Vorgabewert = false Für XML können auch 0 (false) und 1 (true) verwendet werden.
	force_unused	0 - 1	boolean		Beim ZoneDelete Zonen, die noch in Benutzung sind, erhalten. false = Zonen nicht erhalten true = Zonen erhalten Vorgabewerte = false Ohne default-Block: Vorgabewert = 1 Mit default-block: Vorgabewert = 0 Für XML können auch 0 (false) und 1 (true) verwendet werden.
purgeDate	purge_date	0 - 1	string	Date	Frühestmögliche Löschung der Zone
purgeType	purge_type	0 - 1	enum	PurgeType	Einstellung zur automatischen Zonen-Löschung

^{*) Ist abhängig von der jeweiligen Registry.}