---
title: "Objekt Zone"
url: "https://help.internetx.com/de/api/core-objekt-zone/"
lang: "de"
section: "API-Referenz — API-Referenz (XML/JSON)"
breadcrumb: "API-Dokumentation (XML/ JSON) > Objekte"
updated: "2023-09-11"
---

# Objekt Zone

## 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](/de/api/core-nameserveractionconstants/) | Zusätzliche Nameserverprüfung wird durchgeführt. |
| allowTransfer | allow\_transfer | 0 - 1 | boolean |  | AXFR erlauben<br>• false = AXFR nicht erlauben<br>• true = AXFR erlauben<br>Vorgabewert = false<br>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.<br>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](/de/api/core-objekt-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](/de/api/core-objekt-name-server-nserver/) | 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](/de/api/core-objekt-basic-user/) | Besitzer des Objektes. |
| records | rr | 0 - n | object | [ResourceRecord](/de/api/core-objekt-resource-record/) | Resource-Record |
| soa | soa | 1 | object | [SOA](/de/api/core-objekt-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](/de/api/core-objekt-basic-user/) | Benutzer, der  die Zone zuletzt aktualisiert hat. |
| wwwInclude | www\_include | 0 - 1 | boolean |  | Automatisch „www“-Resource-Records erzeugen.<br>• false = „www“-Resource-Records nicht erzeugen<br>• true 0 = „www“-Resource-Records erzeugen<br>Vorgabewert = false<br>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.<br>• false = Zonen nicht erhalten<br>• true = Zonen erhalten<br>Vorgabewerte = false<br>Ohne default-Block: Vorgabewert = 1 Mit default-block: Vorgabewert = 0<br>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](/de/api/core-purgetype-enum/) | Einstellung zur automatischen Zonen-Löschung |

\*) Ist abhängig von der jeweiligen Registry.