API: update_domain_sub
\nPří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.
\nUvádějte pouze to, co chcete změnit. Vynechaný prvek zůstane beze změny. Na pořadí prvků nezáleží.
\nParametry:
\n- \n
- domain - doménové jméno \n
- 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) \n
- admin - administrativní kontakt. Jen u koncovek, které jej podporují \n
- tech - technický kontakt. Jen u koncovek, které jej podporují \n
- 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) \n
- ds - vlastní DS záznam pro dnssec = 2, obsahuje tag, alg, digest_type a digest. Lze uvést až 10 záznamů \n
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ží.
\nUpozorně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á.
\nNávratové kódy:
\n- \n
- 1000 OK – žádost byla založena a odeslána ke schválení \n
- 2008 Nothing to change – zaslané hodnoty odpovídají současnému stavu \n
- 2013 Invalid nameservers section – nevyhovující počet nameserverů nebo duplicity \n
- 2014 No such nameserver – nameserver není k dispozici na vašem účtu \n
- 8000 Not supported TLD – pro tuto koncovku použijte příkaz update_domain \n
- 8001 Object does not belong to your account – doména není na vašem účtu \n
- 8002 This object is not allowed to be edited by this user – koncovka daný údaj nepodporuje \n
- 8006 This domain is not under TELE3 \n
- 8009 Contact is not available on your account \n
- 8800 Malformed input – chybná hodnota dnssec nebo DS záznamu \n
- 2017 Cannot sign a zone hosted elsewhere – dnssec=1 (podpis od TELE3) lze použít jen u domény na nameserverech TELE3; dnssec=2 (vlastní DS) naopak jen tam, kde DNS provozuje někdo jiný. Jinak by u domény zůstal DS záznam, ke kterému neexistuje odpovídající klíč, a doména by přestala fungovat. \n
Návratové hodnoty:
\n- \n
- request_id - identifikátor založené žádosti \n
Příklad – změna technického kontaktu a nameserverů:
\n\n<?xml version="1.0" encoding="UTF-8"?>\n<api>\n<ssid>p156VcVgXzziW0wRHuFciSstsve1Fe</ssid>\n<update_domain_sub>\n<domain>hubero.net</domain>\n<ns>ns1.tele3.cz</ns>\n<ns>ns2.tele3.cz</ns>\n<tech>G-001131</tech>\n</update_domain_sub>\n</api>\n\n
\n<?xml version="1.0" encoding="UTF-8"?>\n<api>\n<credit currency="CZK">100.00</credit>\n<status code="1000">OK</status>\n<update_domain_sub>\n<request_id>21943</request_id>\n<note>Change awaits e-mail confirmation by the authorized contact.</note>\n</update_domain_sub>\n</api>\n\n
Příklad – odebrání DNSSEC:
\n\n<?xml version="1.0" encoding="UTF-8"?>\n<api>\n<ssid>p156VcVgXzziW0wRHuFciSstsve1Fe</ssid>\n<update_domain_sub>\n<domain>hubero.net</domain>\n<dnssec>0</dnssec>\n</update_domain_sub>\n</api>\n\n
Příklad – vlastní DS záznam:
\n\n<?xml version="1.0" encoding="UTF-8"?>\n<api>\n<ssid>p156VcVgXzziW0wRHuFciSstsve1Fe</ssid>\n<update_domain_sub>\n<domain>hubero.net</domain>\n<dnssec>2</dnssec>\n<ds>\n<tag>21203</tag>\n<alg>13</alg>\n<digest_type>2</digest_type>\n<digest>D4A0CD09EAB05AB1F5655EF041FD512A1EF4AC6E5578EA68F5EECF61234ED0EA</digest>\n</ds>\n</update_domain_sub>\n</api>\n
