WAPI – příkaz dns-domain-axfr-run

  WAPI (API rozhraní), WDNS

Tento příkaz způsobí, že v nejbližší možné době (během několika minut) dojde k aktualizace DNS záznamů z primárního serveru přes AXFR. Používá se u sekundárních domén, kde si obsah zóny do naše systému stahujeme z jiného serveru.

Bez používání tohoto příkazu se AXFR řídí údaji REFRESH a RETRY v SOA záznamu.

Parametry

  • name = název domény – povinný parametr

Návratové hodnoty

  • 1000 = ok
  • 2201 = nepodporované TLD
  • 2202 = neplatný, nebo nepodporovaný název domény
  • 2319 = lze provést pouze u sekundární domény
  • 3222 = otevírání domény selhalo
  • 3223 = přístup zamítnut
  • 3305 = doména je uzamčena pro editaci
  • 3306 = doména je smazaná

Návratová data

  • next_run – čas, kdy dojde k atualizaci záznamu

Příklad použití

XML dotaz:

<request>
 <user>tester</user>
 <auth>ae58a4590c1f5b1ace8edbb0c4fd1cdb1e724dec</auth>
 <command>dns-domain-axfr-run</command>
 <data>
  <name>example.com</name>
 </data>
</request>

XML odpověď:

<response>
 <code>1000</code>
 <result>OK</result>
 <timestamp>1291191730</timestamp>
 <svTRID>1291191730.3995.4529.1</svTRID>
 <command>dns-domain-axfr-run</command>
 <data>
  <next_run>2010-12-01 09:22:10</next_run>
 </data>
</response>