Dell VxRail: Jak změnit IP adresu serveru DNS ve verzích VxRail 8.0.x a 7.0.x pomocí rozhraní REST API.

Veřejná dokumentace pro vývojáře společnosti Dell

Kompletní dokumentaci pro vývojáře rozhraní VxRail REST Application Programming Interface (API) a dalších produktů Dell naleznete na stránce Rozhraní API pro vývojáře Dell. Chcete-li rychle najít specifické rozhraní API pro VxRail, vyfiltrujte "Hyperconverged Infrastructure".
   
Konkrétní dokumentaci k dotazování nebo aktualizaci DNS najdete v části "System Information" – Get and Set DNS:  
Tuto dokumentaci lze použít k vytvoření vlastních příkazů curl nebo integraci do aplikace, jako je "postman" nebo jiné aplikace pro zkušenější uživatele.
 

Klient integrovaného rozhraní API VxRail 

Preferovaným způsobem (doporučeno uživatelům, kteří nejsou tak obeznámeni s rozhraním REST API) pro použití rozhraní API VxRail je využít nativního klienta rozhraní API VxRail Manager.
Od verze VxRail 7.0.350 jsme přešli na nové rozhraní založené na technologii Spotlight s vyššími možnostmi.
Otevřete klienta nativního rozhraní API zadáním názvu FQDN/IP adresy VxRail Manager v prohlížeči.

< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
Například IP adresa nástroje VxRail Manager je 172.168.10.50, takže adresa URL bude https://172.168.10.50/rest/vxm/api-doc.html:
     

Dotazování na aktuální konfiguraci DNS clusteru VxRail

K dotazování na aktuální konfiguraci DNS použijte rozhraní v1_sytem_dns_get API, které najdete v části "System Information" na levém panelu:

• Přímá adresa URL by byla https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get ale může se u různých verzí měnit, takže je nejlepší procházet v uživatelském rozhraní.
• Zadejte přihlašovací údaje pro jednotné přihlášení (SSO) VxRail vCenter, což jsou často administrator@vsphere.local, ale mohou se lišit v závislosti na konfiguraci vaší domény.
• Kliknutím na tlačítko Send Request (Odeslat požadavek) spusťte požadavek GET:

• Klient API se ověří, a pokud dostaneme odpověď 200 OK, vrátíme požadované informace, kde aktuální IP adresa laboratoře našeho serveru DNS je 172.168.10.253 a nástroj VxRail Manager není nakonfigurován jako "Internal DNS", což znamená, že používáme servery DNS poskytnuté externím zákazníkem:

Aktualizace informací o serveru DNS IP clusteru VxRail

Chcete-li aktualizovat aktuální konfiguraci DNS, použijte rozhraní v1_system_dns_post API, které naleznete v části "System Information" na levém panelu:

• Přímá adresa URL by byla https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post ale může se u různých verzí měnit, takže je nejlepší se pohybovat v uživatelském rozhraní.
• V části "Auth" zadejte přihlašovací údaje pro ověřování VxRail vCenter SSO, což je často administrator@vsphere.local, ale mohou se lišit v závislosti na konfiguraci vaší domény.
• Chcete-li aktualizovat server DNS, upravte část "Body" ve třech oblastech:
  • Sekce "components" je volitelná a výchozí je část "ALL". Pokud je nastavena možnost ALL, nahradí se všechny servery DNS v clusteru, včetně nástrojů VxRail Manager, vCenter a ESXi. Pokud je nastavena možnost "VXM", vymění se pouze server DNS pro nástroj VxRail Manager, což by byl omezený případ použití, protože doporučujeme zachovat konzistenci všech komponent. Poznámka: Hodnota "VXM" je podporována POUZE v prostředí VCF v systémech VxRail. 
  • V části "vCenter" musíme předat uživatelské jméno a heslo SSO správce. Obvykle se jedná o stejné informace jako v části "Auth", ale je možné zadat jiný účet SSO na úrovni správce.
  • "servers", v níže uvedeném příkladu nastavujeme DNS na IP 172.168.10.253  
    • Upozorňujeme , že při přidávání více serverů musí být IP adresy odděleny čárkami: "172.168.10.253,10.8.8.8"
• Kliknutím na tlačítko Send Request (Odeslat požadavek) proveďte test POST:

 

• Požadavek může trvat minutu v závislosti na počtu hostitelů ESXi v clusteru, ale po úspěšném dokončení požadavku se zobrazí kód odpovědi 200 OK.

Pokud se zobrazí neočekávané kódy odpovědí.

V systému, který není v pořádku, nebo možná na nový server DNS nelze získat přístup z hostitelů ESXi atd. Klient rozhraní API poskytuje základní pokyny k chybovým zprávám a další kódy chyb odpovědí najdete online, například https://restfulapi.net/http-status-codes/ je dobré umístění.
Pokud se vyskytne nějaký neočekávaný chybový kód, obraťte se na podporu společnosti Dell a požádejte o další odstraňování problémů.
 

V dřívějších verzích systému VxRail 8.0 naleznete v postupech řešení Solve Online informace o aktualizaci nastavení IP adresy DNS zařízení VxRail prostřednictvím rozhraní REST API. Tato možnost bude přidána do doplňku uživatelského rozhraní VxRail.
Tento článek obsahuje pokyny a příklady této činnosti pro zákazníky, kteří mají s používáním rozhraní VxRail REST API menší zkušenosti.

Informace o IP adrese v tomto článku pocházejí z dočasného virtuálního izolovaného testovacího prostředí a neobsahují žádné informace o IP adrese zákazníka nebo důvěrné IP adresy.