Your browser don't permit web-fonts to be installed. Our websites use web-fonts based icons. For a better experience please allow your browser to use web-fonts.
We are hiring!
Deutsch | English | Español

2.15. Nameserver

The nameserver object provides methods to manage the nameserver domains and their records.

2.15.1. nameserver.check

Checks if the given nameservers are responding accordingly.

2.15.1.1. Input

Table 2.181. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
nsList of nameserver nsList true 

2.15.1.2. Output

Table 2.182. Parameters

ParameterDescriptionTypeOptional
details   
... nsGiven nameserver token255  
... messageListCheck messages array_text255  
... statusStauts of the nameserver check text64  

2.15.2. nameserver.create

Creates a domain in the nameserver.

2.15.2.1. Input

Table 2.183. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 
typeType of nameserver entry nsType true 
nsList of nameserver nsList false 
masterIpMaster IP address ip false 
webWeb nameserver entry token0255 false 
mailMail nameserver entry text0255 false 
soaEmailEmail address for SOA record email false 
urlRedirectTypeType of the url redirection urlRedirectType false 
urlRedirectTitleTitle of the frame redirection token0255 false 
urlRedirectDescriptionDescription of the frame redirection token0255 false 
urlRedirectFavIconFavIcon of the frame redirection token0255 false 
urlRedirectKeywordsKeywords of the frame redirection token0255 false 
testingExecute command in testing mode boolean falsefalse
ignoreExistingIgnore existing boolean falsefalse

2.15.2.2. Output

Table 2.184. Parameters

ParameterDescriptionTypeOptional
roIdCreated DNS domain id int  

2.15.3. nameserver.createRecord

Creates a new nameserver record.

2.15.3.1. Input

Table 2.185. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 false 
roIdDNS domain id int false 
typeType of the nameserver record recordType true 
contentContent of the nameserver record text true 
nameName of the nameserver record token0255 false 
ttlTTL (time to live) of the nameserver record int false3600
prioPriority of the nameserver record int false0
urlRedirectTypeType of the url redirection urlRedirectType false 
urlRedirectTitleTitle of the frame redirection token0255 false 
urlRedirectDescriptionDescription of the frame redirection token0255 false 
urlRedirectFavIconFavIcon of the frame redirection token0255 false 
urlRedirectKeywordsKeywords of the frame redirection token0255 false 
urlAppendAppend the path for redirection boolean falsefalse
testingExecute command in testing mode boolean falsefalse

2.15.3.2. Output

Table 2.186. Parameters

ParameterDescriptionTypeOptional
idCreated record id int  

2.15.4. nameserver.delete

Deletes a nameserver domain

2.15.4.1. Input

Table 2.187. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 false 
roIdId (Repository Object Identifier) of the DNS domain int false 
testingExecute command in testing mode boolean falsefalse

2.15.4.2. Output

No additional return parameters

2.15.5. nameserver.deleteRecord

Deletes a nameserver record.

2.15.5.1. Input

Table 2.188. Parameters

ParameterDescriptionTypeRequiredDefault
idId of the nameserver record int true 
testingExecute command in testing mode boolean falsefalse

2.15.5.2. Output

No additional return parameters

2.15.6. nameserver.export

Creates a nameserver.export TXT Datei

2.15.6.1. Input

Table 2.189. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 true 

2.15.6.2. Output

Table 2.190. Parameters

ParameterDescriptionTypeOptional
exportexport result text  

2.15.7. nameserver.exportlist

Nameserver List export as file

2.15.7.1. Input

Table 2.191. Parameters

ParameterDescriptionTypeRequiredDefault
formatFormat of the requested document documentformat falseraw
domainSearch by domain name token0255 false*
wideMore detailed output int false1
pagePage number for paging int false1
pagelimitMax number of results per page int false20

2.15.7.2. Output

Table 2.192. Parameters

ParameterDescriptionTypeOptional
countLog timestamp int  
domainsDomains Log list array  

2.15.8. nameserver.exportrecords

Export nameserver records as file

2.15.8.1. Input

Table 2.193. Parameters

ParameterDescriptionTypeRequiredDefault
formatRequest output of given format. Defaults to csv. documentformat falsecsv
nameFilter results by given record name. You can, for example, set domain names here. Wildcard * is allowed. token255 false 
pageIf limit is set, show entries from {page - 1}*{limit}. Defaults to 1. int false1
limitOnly return {limit} entries at once. Set to 0 for no limit. Defaults to 0. int false0

2.15.8.2. Output

Table 2.194. Parameters

ParameterDescriptionTypeOptional
countAmount of entries returned. int  
data Result file data in cleartext or base64 coded, depending on the selected format. CSV returns as clear text. Other formats are currently not supported. base64  

2.15.9. nameserver.info

Get nameserver record details.

2.15.9.1. Input

Table 2.195. Parameters

ParameterDescriptionTypeRequiredDefault
domainSearch by domain name token255 false 
roIdId (Repository Object Identifier) of the DNS domain int false 
recordIdSearch by record id int false 
typeSearch by record type text64 false 
nameSearch by record name text0255 false 
contentSearch by record content text1024 false 
ttlSearch by record ttl int false 
prioSearch by record priority int false 

2.15.9.2. Output

Table 2.196. Parameters

ParameterDescriptionTypeOptional
roIdId (Repository Object Identifier) of the DNS domain int Yes
domainDomain name token255 Yes
typeType of nameserver domain nsType Yes
masterIpMaster IP address ip Yes
lastZoneCheckTime of last zone check dateTime Yes
slaveDns  Yes
... nameHostname of the nameserver hostname  
... ipIp address of the nameserver ip  
SOAserialSOA-RR serial text064 Yes
countTotal number of domain records int Yes
record  Yes
... idId of the nameserver record int  
... nameName of the nameserver record token255  
... typeType of the nameserver record recordType  
... contentContent of the nameserver record text1024  
... ttlTTL (time to live) of the nameserver record int  
... prioPriority of the nameserver record int  
... urlRedirectTypeType of the url redirection urlRedirectType Yes
... urlRedirectTitleTitle of the frame redirection token255 Yes
... urlRedirectDescriptionDescription of the frame redirection token255 Yes
... urlRedirectKeywordsKeywords of the frame redirection token255 Yes
... urlRedirectFavIconFavIcon of the frame redirection token255 Yes
... urlAppendAppend the path to redirection boolean Yes

2.15.10. nameserver.list

List all nameserver domains.

2.15.10.1. Input

Table 2.197. Parameters

ParameterDescriptionTypeRequiredDefault
domainSearch by domain name token0255 false*
wideMore detailed output int false1
pagePage number for paging int false1
pagelimitMax number of results per page int false20

2.15.10.2. Output

Table 2.198. Parameters

ParameterDescriptionTypeOptional
countTotal number of nameserver domains int  
domains   
... roIdId (Repository Object Identifier) of the DNS domain int  
... domainDomain name array_domain  
... typeType of nameserver domain nsType  
... masterIpMaster ip address ip Yes
... mailMail nameserver entry ip_url Yes
... webWeb nameserver entry ip_url Yes
... urlWeb forwarding url ip_url Yes
... urlTypeThe redirect type of the forwarding url (only if `url` is set) urlRedirectType Yes
... ipv4Web IPv4 address ip Yes
... ipv6Web IPv6 address ip Yes

2.15.11. nameserver.update

Updates a nameserver domain.

2.15.11.1. Input

Table 2.199. Parameters

ParameterDescriptionTypeRequiredDefault
domainDomain name token255 false 
roIdId (Repository Object Identifier) of the DNS domain int false 
typeType of nameserver entry nsType false 
masterIpMaster ip address ip false 
nsList of nameserver nsList false 
webWeb nameserver entry token255 false 
mailMail nameserver entry token255 false 
urlRedirectTypeType of the url redirection urlRedirectType false 
urlRedirectTitleTitle of the frame redirection token0255 false 
urlRedirectDescriptionDescription of the frame redirection token0255 false 
urlRedirectFavIconFavIcon of the frame redirection token0255 false 
urlRedirectKeywordsKeywords of the frame redirection token0255 false 
testingExecute command in testing mode boolean falsefalse

2.15.11.2. Output

No additional return parameters

2.15.12. nameserver.updateRecord

Updates a nameserver record.

2.15.12.1. Input

Table 2.200. Parameters

ParameterDescriptionTypeRequiredDefault
idId of the record array_int true 
nameName of the nameserver record token0255 false 
typeType of the nameserver record recordType false 
contentContent of the nameserver record text false 
prioPriority of the nameserver record int false 
ttlTTL (time to live) of the nameserver record int false 
urlRedirectTypeType of the url redirection urlRedirectType false 
urlRedirectTitleTitle of the frame redirection token0255 false 
urlRedirectDescriptionDescription of the frame redirection token0255 false 
urlRedirectFavIconFavIcon of the frame redirection token0255 false 
urlRedirectKeywordsKeywords of the frame redirection token0255 false 
urlAppendAppend the path for redirection boolean falsefalse
testingExecute command in testing mode boolean falsefalse

2.15.12.2. Output

No additional return parameters