Dell VxRail: Come modificare l'IP del server DNS sulle release di VxRail 8.0.x e 7.0.x utilizzando l'API REST

Documentazione pubblica per sviluppatori Dell

Per una documentazione completa per gli sviluppatori dell'API (Application Programming Interface) REST di VxRail e di altri prodotti Dell, consultare API per sviluppatori Dell. Per trovare rapidamente l'API specifica di VxRail, filtrare per "Hyperconverged Infrastructure".
   
La documentazione specifica per l'esecuzione di query o l'aggiornamento del DNS è disponibile in "System Information" - Get and Set DNS:  
Questa documentazione può essere utilizzata per creare comandi curl personalizzati o integrarli in un'applicazione come "postman" o altre applicazioni per utenti più esperti.
 

Client API integrato VxRail 

Il modo migliore (consigliato per gli utenti che hanno meno familiarità con le API REST) per utilizzare le API di VxRail consiste nell'utilizzare il client API nativo di VxRail Manager.
Dalla release 7.0.350 di VxRail siamo passati a una nuova interfaccia basata su Spotlight con funzionalità maggiori.
Accedere al client API nativo immettendo l'FQDN/IP di VxRail Manager nel browser.

< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
Ad esempio, l'IP di VxRail Manager è 172.168.10.50, quindi l'URL diventa https://172.168.10.50/rest/vxm/api-doc.html:
     

Interrogazione della configurazione DNS del cluster VxRail corrente

Per eseguire una query sulla configurazione DNS corrente, utilizzare l'API v1_sytem_dns_get disponibile nella sezione "System Information" nel pannello a sinistra:

• L'URL diretto viene https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get tuttavia può cambiare da una versione all'altra, pertanto è preferibile navigare nell'interfaccia utente.
• Inserire le credenziali di autenticazione Single Sign-On (SSO) di VxRail vCenter, che spesso sono le administrator@vsphere.local, ma possono variare a seconda della configurazione del dominio.
• Cliccare sul pulsante Send Request per eseguire la richiesta GET:

• Il client API esegue l'autenticazione e, se riceviamo una risposta di 200 OK, restituisce le informazioni richieste: l'IP corrente del laboratorio del server DNS è 172.168.10.253 e VxRail Manager non è configurato come "DNS interno", il che significa che stiamo utilizzando server DNS esterni forniti dal cliente:

Aggiornamento delle informazioni sul server IP DNS del cluster VxRail

Per aggiornare la configurazione DNS corrente, utilizzare l'API v1_system_dns_post disponibile nella sezione "System Information" nel pannello a sinistra:

• L'URL diretto viene https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post tuttavia può cambiare da una versione all'altra, quindi è preferibile navigare nell'interfaccia utente.
• Nella sezione "Auth", inserire le credenziali di autenticazione SSO di VxRail vCenter, che spesso sono administrator@vsphere.local, ma possono variare a seconda della configurazione del dominio.
• Per aggiornare il server DNS, modificare la sezione "Body" in tre aree:
  • La sezione "components" è facoltativa e "ALL" è l'impostazione predefinita. Se ALL è impostato, vengono sostituiti tutti i server DNS nel cluster, inclusi VxRail Manager, vCenter ed ESXi. Se "VXM" è impostato, viene sostituito solo il server DNS per VxRail Manager. Si tratta di un caso d'uso limitato in quanto si consiglia di mantenere coerente la configurazione di tutti i componenti. Il valore "VXM" è supportato SOLO in ambiente VCF su VxRail. 
  • Nella sezione "vCenter" è necessario fornire un nome utente e una password SSO dell'amministratore, in genere si tratta delle stesse informazioni della sezione "Auth", ma è possibile fornire un account SSO di livello amministratore diverso.
  • "servers", nell'esempio seguente impostiamo il DNS su IP 172.168.10.253  
    • Nota: quando si aggiungono più server, gli IP devono essere separati da virgole "172.168.10.253,10.8.8.8"
• Cliccare sul pulsante Send Request per eseguire la richiesta POST:

 

• La richiesta può richiedere un minimo a seconda del numero di host ESXi nel cluster, anche se quando la richiesta viene completata correttamente, restituisce un codice di risposta 200 OK.

Se sono presenti codici di risposta imprevisti.

In caso di sistema non integro o forse non è possibile raggiungere un nuovo server DNS dagli host ESXi, ecc. Il client API fornisce alcune indicazioni di base per i messaggi di errore e ulteriori codici di errore di risposta sono reperibili online, ad esempio https://restfulapi.net/http-status-codes/ è una buona posizione.
In caso di codici di errore imprevisti, contattare il supporto Dell per ulteriori procedure di risoluzione dei problemi.
 

Nelle prime release di VxRail 8.0, le procedure SolVe Online fanno riferimento all'aggiornamento delle impostazioni IP DNS di VxRail tramite l'API REST. L'abilità verrà aggiunta al plug-in dell'interfaccia utente di VxRail.
Questo articolo fornisce indicazioni ed esempi per questa attività per i clienti con meno esperienza di utilizzo dell'API REST di VxRail.

Le informazioni sull'IP in questo articolo provengono da un laboratorio virtuale isolato temporaneo e non contengono informazioni sull'IP riservate/del cliente.