- Start
- API-Referenz
- API-Dokumentation (XML/ JSON)
- Auftragstypen
- Zone-Auftragstypen
Zone Create
Funktion
Der Autragstyp ZoneCreate legt eine neue Zone auf den vom System verwalteten Nameservern an.
Beschreibung
Route: POST/zone
{
"origin": "example.com",
"soa": {
"refresh": 3600,
"retry": 7200,
"expire": 604800,
"ttl": 600,
"email": "customer@example.com"
},
"dnssec": false,
"allowTransfer": false,
"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": "COMPLETE",
"resourceRecords": [
{
"name": "subdomainexample",
"ttl": 600,
"type": "A",
"value": "1.3.5.7"
}
]
}{
"stid": "20190701-app2-dev-15785",
"status": {
"code": "S0205",
"text": "Zonen-Informationen wurden erfolgreich ermittelt.",
"type": "SUCCESS"
},
"object": {
"type": "Zone",
"summary": 3
},
"data": [
{
"created": "2014-10-24T09:42:57.000+0200",
"updated": "2017-11-17T17:35:40.000+0100",
"origin": "example.com",
"owner": {
"context": 4,
"user": "customer"
},
"updater": {
"context": 1,
"user": "customer"
},
"virtualNameServer": "ns1.nameserver.com"
},
{
"created": "2019-05-13T11:26:36.000+0200",
"updated": "2019-05-13T13:51:20.000+0200",
"origin": "example2.org",
"dnssec": false,
"owner": {
"context": 4,
"user": "customer"
},
"updater": {
"context": 4,
"user": "customer"
},
"virtualNameServer": "ns2.nameserver.com"
},
{
"created": "2019-05-13T11:26:36.000+0200",
"updated": "2019-05-17T13:33:02.000+0200",
"origin": "example3.com",
"dnssec": false,
"owner": {
"context": 4,
"user": "customer"
},
"updater": {
"context": 4,
"user": "customer"
},
"virtualNameServer": "ns3.nameserver.com"
}
]
}
Auftragstyp-Code: 0201
Verwendet Objekt Zone
<request>
<auth>
<user>customer</user>
<password>password</password>
<context>4</context>
</auth>
<task>
<code>0201</code>
<zone>
<name>example.com</name>
<main>
<value>172.16.100.1</value>
<ttl>86400</ttl>
</main>
<ns_action>complete</ns_action>
<www_include>1</www_include>
<allow_transfer_from>198.51.100.0/24</allow_transfer_from>
<soa>
<level>1</level>
<refresh>43200</refresh>
<retry>7200</retry>
<expire>1209600</expire>
<ttl>86400</ttl>
<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>
<!-- Beispiel für ein Domainkey-Eintrag -->
<rr>
<name>default._domainkey</name>
<type>TXT</type>
<pref></pref>
<ttl></ttl>
<value>p=mVMdtsXfXxyakdNwK3CB/5nnV6dVSLTthZGMpKE9rLkfwIDAQAB</value>
</rr>
<!-- Beispiel freier Texteintrag für einen Record (Vorsicht) -->
<free>internetconfiguration 1800 IN A 11.22.33.44</free>
<free>mail 1800 IN A 22.33.44.55</free>
</zone>
</task>
</request> <response>
<result>
<status>
<code>S0201</code>
<text>Die Zone wurde auf dem Nameserver eingetragen.</text>
<text></text>
<type>success</type>
<object>
<type>zone</type>
<value>example.com</value>
</object>
</status>
</result>
</response>