Dell VxRail: Så här ändrar du IP-adressen för DNS-servern på VxRail 8.0.x- och 7.0.x-versioner med hjälp av rest-API:et

Offentlig dokumentation för Dell-utvecklare

En fullständig utvecklardokumentation för VxRail REST Application Programming Interface (API) och andra Dell-produkter finns i Dell Developer API:er. Om du snabbt vill hitta det VxRail-specifika API:t filtrerar du efter "Hyperconverged Infrastructure".
   
Specifik dokumentation för att fråga eller uppdatera DNS finns under "Systeminformation" – Hämta och ange DNS:  
Den här dokumentationen kan användas för att skapa anpassade curl-kommandon eller integreras i ett program som "postman" eller andra program för mer erfarna användare.
 

Inbäddad VxRail-API-klient 

Det bästa sättet (rekommenderas för personer som är mindre bekanta med REST API) att använda VxRail-API:erna är att använda den inbyggda VxRail Manager API-klienten.
Från och med VxRail-version 7.0.350 har vi migrerat till ett nytt gränssnitt baserat på spotlight med större funktioner.
Öppna den inbyggda API-klienten genom att ange FQDN/IP för VxRail Manager i webbläsaren.

< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
IP-adressen för VxRail Manager är till exempel 172.168.10.50, så URL-adressen blir https://172.168.10.50/rest/vxm/api-doc.html:
     

Fråga efter det aktuella VxRail-klustrets DNS-konfiguration

För att fråga efter den aktuella DNS-konfigurationen, använd v1_sytem_dns_get API som finns under avsnittet "System Information" i den vänstra panelen:

• Den direkta URL:en skulle vara https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get men dessa kan ändras i olika versioner, så det är bäst att navigera i användargränssnittet.
• Ange autentiseringsuppgifterna för VxRail vCenter Single Sign-On (SSO), som ofta är administrator@vsphere.local men kan variera beroende på din domänkonfiguration.
• Klicka på knappen Skicka begäran för att utföra GET-begäran:

• API-klienten autentiserar och om vi får ett 200 OK-svar returneras den begärda informationen där vår aktuella DNS-serverlabb-IP är 172.168.10.253 och VxRail Manager inte är konfigurerad som "Intern DNS", vilket innebär att vi använder DNS-servrar som tillhandahålls av en extern kund:

Uppdatera informationen om VxRail-klustrets DNS IP-server

För att uppdatera den aktuella DNS-konfigurationen, använd v1_system_dns_post API som finns under avsnittet "System Information" i den vänstra panelen:

• Den direkta URL:en skulle vara https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post men dessa kan ändras i olika versioner, så det är bäst att navigera i användargränssnittet.
• I avsnittet "Auth" anger du autentiseringsuppgifterna för VxRail vCenter SSO, som ofta är administrator@vsphere.local men kan variera beroende på domänkonfigurationen.
• Om du vill uppdatera DNS-servern redigerar du avsnittet "Body" i tre områden:
  • Avsnittet "components" är valfritt och "ALL" är standard. Om ALL är inställt ersätts alla DNS-servrar i klustret, inklusive VxRail Manager, vCenter och ESXi. Om VXM är inställt ersätts endast DNS-servern för VxRail Manager, vilket skulle vara ett begränsat användningsfall eftersom vi rekommenderar att alla komponentkonfigurationer är konsekventa. Observera att värdet "VXM" ENDAST stöds i VCF i VxRail-miljö. 
  • I "vCenter"-avsnittet måste vi skicka ett administratörsanvändarnamn och lösenord för SSO, vanligtvis är det samma information som i avsnittet "Auth" men ett SSO-konto på annan administratörsnivå kan tillhandahållas.
  • "servers", i exemplet nedan ställer vi in DNS på IP 172.168.10.253  
    • Observera att när du lägger till flera servrar måste IP-adresserna vara kommaseparerade "172.168.10.253,10.8.8.8"
• Klicka på knappen Skicka begäran för att utföra POST-begäran:

 

• Begäran kan ta en minut, beroende på antalet ESXi-värdar i klustret, men när begäran har slutförts returneras svarskoden 200 OK.

Om det finns oväntade svarskoder.

I ett sjukt system eller kanske en ny DNS-server inte kan nås från ESXi-värdar etc. API-klienten ger viss grundläggande vägledning för felmeddelanden, och ytterligare svarsfelkoder finns online, till exempel https://restfulapi.net/http-status-codes/ är en bra plats.
Om oväntade felkoder inträffar kontaktar du Dells support för ytterligare felsökning.
 

I tidiga versioner av VxRail 8.0 hänvisar Solve Online-procedurer till uppdatering av VxRail DNS IP-inställningar via REST API. Möjligheten läggs till i VxRail-UI-insticksprogrammet.
Den här artikeln innehåller vägledning och exempel för den här aktiviteten för kunder med färre erfarenheter av att använda VxRail REST API.

IP-informationen i den här artikeln kommer från ett tillfälligt virtuellt isolerat labb och innehåller ingen kund/konfidentiell IP-information.