API: update_domain_sub
Příkaz pro změnu nastavení existující zahraniční domény (vše kromě .CZ – pro české domény slouží příkaz update_domain). Přehled požadovaných změn bude zaslán na e-mail držitele domény ke schválení; teprve po potvrzení se změna provede u registrátora.
Uvádějte pouze to, co chcete změnit. Vynechaný prvek zůstane beze změny. Na pořadí prvků nezáleží.
Parametry:
- domain - doménové jméno
- ns - nameserver. Uveďte všechny nameservery domény, každý ve vlastním prvku (počet podle pravidel dané koncovky, obvykle 2 až 10). Nameserver musí být předem založen ve vašem účtu (viz create_ns)
- admin - administrativní kontakt. Jen u koncovek, které jej podporují
- tech - technický kontakt. Jen u koncovek, které jej podporují
- dnssec - 0 = DNSSEC vypnout a odebrat DS záznamy, 1 = použít DS záznamy DNS serverů TELE3, 2 = vlastní DS záznamy (uveďte je v prvcích ds)
- ds - vlastní DS záznam pro dnssec = 2, obsahuje tag, alg, digest_type a digest. Lze uvést až 10 záznamů
Atribut test="true" u prvku update_domain_sub provede pouze kontrolu vstupu a vypíše, co by se změnilo. Žádost se v tomto režimu nezaloží.
Upozornění k DNSSEC: pokud změníte nameservery na jiné než servery TELE3 a nezadáte současně nové DS záznamy, budou stávající DS záznamy automaticky odebrány. Zabraňuje to situaci, kdy by doména zůstala podepsaná klíčem původních DNS serverů a přestala by být dostupná.
Návratové kódy:
- 1000 OK – žádost byla založena a odeslána ke schválení
- 2008 Nothing to change – zaslané hodnoty odpovídají současnému stavu
- 2013 Invalid nameservers section – nevyhovující počet nameserverů nebo duplicity
- 2014 No such nameserver – nameserver není k dispozici na vašem účtu
- 8000 Not supported TLD – pro tuto koncovku použijte příkaz update_domain
- 8001 Object does not belong to your account – doména není na vašem účtu
- 8002 This object is not allowed to be edited by this user – koncovka daný údaj nepodporuje
- 8006 This domain is not under TELE3
- 8009 Contact is not available on your account
- 8800 Malformed input – chybná hodnota dnssec nebo DS záznamu
Návratové hodnoty:
- request_id - identifikátor založené žádosti
Příklad – změna technického kontaktu a nameserverů:
<?xml version="1.0" encoding="UTF-8"?> <api> <ssid>p156VcVgXzziW0wRHuFciSstsve1Fe</ssid> <update_domain_sub> <domain>hubero.net</domain> <ns>ns1.tele3.cz</ns> <ns>ns2.tele3.cz</ns> <tech>G-001131</tech> </update_domain_sub> </api>
<?xml version="1.0" encoding="UTF-8"?> <api> <credit currency="CZK">100.00</credit> <status code="1000">OK</status> <update_domain_sub> <request_id>21943</request_id> <note>Change awaits e-mail confirmation by the authorized contact.</note> </update_domain_sub> </api>
Příklad – odebrání DNSSEC:
<?xml version="1.0" encoding="UTF-8"?> <api> <ssid>p156VcVgXzziW0wRHuFciSstsve1Fe</ssid> <update_domain_sub> <domain>hubero.net</domain> <dnssec>0</dnssec> </update_domain_sub> </api>
Příklad – vlastní DS záznam:
<?xml version="1.0" encoding="UTF-8"?> <api> <ssid>p156VcVgXzziW0wRHuFciSstsve1Fe</ssid> <update_domain_sub> <domain>hubero.net</domain> <dnssec>2</dnssec> <ds> <tag>21203</tag> <alg>13</alg> <digest_type>2</digest_type> <digest>D4A0CD09EAB05AB1F5655EF041FD512A1EF4AC6E5578EA68F5EECF61234ED0EA</digest> </ds> </update_domain_sub> </api>
