- Home
- API reference
- API documentation (JSON/XML)
- Tasks
- Zone tasks
Zone create
Function
The ZoneCreate task creates a new zone on the name servers managed by the system.
Description
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": "Zone information was inquired successfully.",
"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"
}
]
}
Task code: 0201
Uses Zone object
<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>
<!-- Example for a domainkey entry -->
<rr>
<name>default._domainkey</name>
<type>TXT</type>
<pref></pref>
<ttl></ttl>
<value>p=mVMdtsXfXxyakdNwK3CB/5nnV6dVSLTthZGMpKE9rLkfwIDAQAB</value>
</rr>
<!-- Example free text entry for a record (Caution)-->
<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>Zone has been stored successfully on the name server.</text>
<text></text>
<type>success</type>
<object>
<type>zone</type>
<value>example.com</value>
</object>
</status>
</result>
</response>