VxRail: Het IP-adres van de DNS-server wijzigen op VxRail 8.0.x- en 7.0.x-releases met behulp van de rest-API

Openbare documentatie voor Dell ontwikkelaars

Voor een volledige documentatie voor ontwikkelaars van de VxRail REST Application Programming Interface (API) en andere Dell producten, gaat u naar Dell Developer API's. Om snel de VxRail specifieke API te vinden, filtert u op 'Hyperconverged Infrastructure'.
 

 
Specifieke documentatie voor het opvragen of bijwerken van DNS vindt u onder "System Information" - DNS ophalen en instellen:

 
Deze documentatie kan worden gebruikt om aangepaste curl-opdrachten te maken of te integreren in een applicatie zoals "postman" of andere applicaties voor meer ervaren gebruikers.
 

VxRail embedded API-client 

De VxRail API's kunnen bij voorkeur worden gebruikt (aanbevolen voor mensen die minder bekend zijn met REST API's) door gebruik te maken van de native VxRail Manager API-client.
Vanaf VxRail release 7.0.350 zijn we gemigreerd naar een nieuwe interface op basis van spotlight met meer mogelijkheden.
Open de native API-client door de VxRail Manager FQDN/IP in uw browser in te voeren.

< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
Het IP-adres van VxRail Manager is bijvoorbeeld 172.168.10.50, zodat de URL wordt https://172.168.10.50/rest/vxm/api-doc.html:
 

   

Query's uitvoeren op de huidige DNS-configuratie van het VxRail cluster

Om een query uit te voeren op de huidige DNS-configuratie, gebruikt u de v1_sytem_dns_get API die u kunt vinden onder het gedeelte "System Information" in het linkerdeelvenster:

• De directe URL zou https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get zijn, maar deze kunnen per versie verschillen, dus u kunt het beste in de gebruikersinterface navigeren.
• Voer de VxRail vCenter Single Sign-On (SSO)-authenticatiereferenties in, die vaak de administrator@vsphere.local zijn, maar kunnen variëren afhankelijk van uw domeinconfiguratie.
• Klik op de knop Aanvraag verzenden om de GET-aanvraag uit te voeren:

• De API-client verifieert en als we een antwoord van 200 OK krijgen, retourneert u de gevraagde informatie waarbij ons huidige DNS-serverlab-IP-adres 172.168.10.253 is en de VxRail Manager niet is geconfigureerd als "Internal DNS", wat betekent dat we een externe klant gebruiken die door DNS-servers is geleverd:

De DNS IP-servergegevens van het VxRail cluster bijwerken

Om de huidige DNS-configuratie bij te werken, gebruikt u de v1_system_dns_post API die u kunt vinden onder het gedeelte "System Information" in het linkerdeelvenster:

• De directe URL zou https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post zijn, maar deze kunnen per versie verschillen, dus u kunt het beste in de gebruikersinterface navigeren.
• Voer in het gedeelte "Auth" de referenties voor SSO-verificatie van VxRail vCenter in, die vaak de administrator@vsphere.local zijn, maar kunnen variëren afhankelijk van uw domeinconfiguratie.
• Als u de DNS-server wilt bijwerken, bewerkt u het gedeelte "Body" in drie gebieden:
  • Het gedeelte "componenten" is optioneel en "ALL" is de standaardinstelling. Als ALL is ingesteld, worden alle DNS-servers in het cluster vervangen, inclusief VxRail Manager, vCenter en ESXi. Als "VXM" is ingesteld, wordt alleen de DNS-server voor VxRail Manager vervangen. Dit is een beperkt gebruiksscenario, omdat we aanbevelen om alle componentconfiguraties consistent te houden. Opmerking: de waarde "VXM" wordt ALLEEN ondersteund in VCF op VxRail-omgeving. 
  • In de "vCenter"-sectie moeten we een SSO-gebruikersnaam en wachtwoord voor de beheerder doorgeven. Meestal is dit dezelfde informatie als in de "Auth"-sectie, maar er kan een ander SSO-account op beheerdersniveau worden opgegeven.
  • "servers", in het onderstaande voorbeeld stellen we de DNS in op IP 172.168.10.253  
    • Opmerking: bij het toevoegen van meerdere servers moeten de IP's door komma's worden gescheiden: "172.168.10.253,10.8.8.8"
• Klik op de knop Aanvraag verzenden om de POST-aanvraag uit te voeren:

 

• De aanvraag kan een minuut duren, afhankelijk van het aantal ESXi-hosts in het cluster, maar wanneer de aanvraag succesvol is voltooid, retourneert deze een 200 OK-antwoordcode.

Als er onverwachte responscodes zijn.

In een ongezond systeem of misschien een nieuwe DNS-server kan niet worden bereikt vanaf ESXi-hosts, enz. De API-client biedt enkele basisrichtlijnen voor foutmeldingen en aanvullende responsfoutcodes zijn online te vinden, bijvoorbeeld https://restfulapi.net/http-status-codes/ een goede locatie is.
Neem bij onverwachte foutcodes contact op met Dell Support voor aanvullende probleemoplossing.
 

In vroege VxRail 8.0-releases verwijzen Solve Online-procedures naar het bijwerken van VxRail DNS IP-instellingen via REST API. De mogelijkheid wordt toegevoegd aan de VxRail UI-plug-in.
Dit artikel bevat richtlijnen en voorbeelden voor deze activiteit voor klanten met minder ervaring bij het gebruik van de VxRail REST API.

De IP-informatie in dit artikel is afkomstig uit een tijdelijk virtueel geïsoleerd lab en bevat geen klant-/vertrouwelijke IP-informatie.