Pro změnu DNS serverů domény nabízí WAPI rozhraní příkaz domain-update-ns.
Parametry
- name – název domény včetně koncovky – povinné
- nsset – NSSET u cz domén – povinné (dns nebo nsset)
- dns – nastavení DNS – povinné (dns nebo nsset)Je třeba zadat buď nsset nebo dns.
Parametr „dns“ – konfigurace DNS serverů
Pouze pokud není uveden parametr nsset.
Možné hodnoty parametru dns:
- parametr dns je prázdný = použít výchozí nastavení (nastaví se DNS servery WEDOS). Pozor, element dns je vyžadován, pouze je prázdný!
- parametr dns obsahuje konfiguraci DNS serverů = nelze použít u .cz domén (každý záznam musí obsahovat pole name, volitelně pak addr_ip4 a addr_ip6, jednotlivé servery jsou vnořeny v elementu server )
Příklad konfigurace DNS serverů v parametru dns:
- XML
<dns> <server> <name>ns1.dns-server-host.tld</name> </server> <server> <name>ns2.dns-server-host.tld</name> </server> <server> <name>ns.transfering-domain-name.tld</name> <addr_ipv4>9.8.7.6</addr_ipv4> <addr_ipv6>ff01::101</addr_ipv6> </server> </dns> - JSON – servery musejí být očíslované!
„dns“: { „array“: { „server1“: { „name“: „ns1.dns-server-host.tld“ // adresa 1. DNS serveru }, „server2“: { „name“: „ns2.dns-server-host.tld“ // adresa 2. DNS serveru }, „server3“: { „name“: „ns.transfering-domain-name.tld“, // adresa 3. DNS serveru „addr_ipv4“: „9.8.7.6“, // IPv4 GLUE „addr_ipv6“: „ff01::101“ // IPv6 GLUE } } }
Návratové hodnoty
- 1000 – DNS servery úspěšně nastaveny
- 2209 – neplatný formát NSSETu (u cz domén)
- 2210 – neplatný formát nastavení DNS serverů
Návratová data
Příkaz nevrací kromě návratového kódu žádná data.
Příklad 1: nastavení výchozích DNS (WEDOS)
XML dotaz:
<request> <user>tester</user> <auth>e18739291ee62396f1a6e9975577db5bbf2ad29e</auth> <command>domain-update-ns</command> <clTRID>sGECbNbVjv8c</clTRID> <data> <name>example.cz</name> <dns></dns> </data> </request>
XML odpověď:
<response> <code>1000</code> <result>OK</result> <timestamp>1286893068</timestamp> <clTRID>sGECbNbVjv8c</clTRID> <svTRID>1286893068.1274.1636</svTRID> <command>domain-update-ns</command> </response>
Příklad 2: nastavení NSSETu
XML dotaz:
<request> <user>tester</user> <auth>e18739291ee62396f1a6e9975577db5bbf2ad29e</auth> <command>domain-update-ns</command> <clTRID>sGECbNbVjv8c</clTRID> <data> <name>example.cz</name> <nsset>WEDOS</nsset> </data> </request>
XML odpověď:
<response> <code>1000</code> <result>OK</result> <timestamp>1286893068</timestamp> <clTRID>sGECbNbVjv8c</clTRID> <svTRID>1286893068.1274.1636</svTRID> <command>domain-update-ns</command> </response>
Příklad 3: uvedení DNS serverů
XML dotaz:
<request> <user>tester</user> <auth>e18739291ee62396f1a6e9975577db5bbf2ad29e</auth> <command>domain-update-ns</command> <clTRID>sGECbNbVjv8c</clTRID> <data> <name>example.cz</name> <dns> <server> <name>ns.wedos.net</name> </server> <server> <name>ns.wedos.cz</name> </server> </dns> </data> </request>
XML odpověď:
<response> <code>1000</code> <result>OK</result> <timestamp>1286893068</timestamp> <clTRID>sGECbNbVjv8c</clTRID> <svTRID>1286893068.1274.1636</svTRID> <command>domain-update-ns</command> </response>
Byl pro Vás tento návod užitečný?
Dejte nám vědět, pokud se vám návod líbil či nikoliv. Je to jediný způsob, jak se můžeme zlepšit.