Tato stránka používá „cookies“. Soubory cookie nám pomáhají poskytovat, chránit a zlepšovat naše služby. Více informací zde. Přijmout cookies
Tato stránka používá „cookies“. Soubory cookie nám pomáhají poskytovat, chránit a zlepšovat naše služby. Více informací zde. Přijmout cookies

WAPI - příkaz domain-update-ns

Příkaz pro změnu DNS serverů u domény

Datum: 15.11.2010


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:

  1. 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ý!
  2. 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 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>

Diskuze k článku

K tomuto článku nebyl dosud vložen žádný diskuzní příspěvek, ale můžete tak učinit jako první.

Přihlášení zákazníka

Nemáte ještě zákaznický účet? Registrace

Copyright © WEDOS, 2018

Facebook RSS