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

Documentazione pubblica per gli sviluppatori Dell

La documentazione per gli sviluppatori per l'API REST VxRail e altri prodotti Dell è disponibile sul sito del Supporto Dell per gli sviluppatori. Filtrare per Hyperconverged Infrastructure per trovare l'API specifica di VxRail.

La documentazione specifica per l'esecuzione di query o l'aggiornamento di NTP è disponibile in Informazioni di sistema, Get e Imposta NTP:

Questa documentazione può essere utilizzata per creare curl comandi o integrare 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.

A partire dalla versione 7.0.350 del codice VxRail, viene utilizzata una nuova interfaccia con funzionalità maggiori basate su Spotlight. Per accedere al client API nativo, andare al seguente URL sostituendo <VxM> con l'FQDN/IP di VxRail Manager con il browser preferito (non è necessario un client API speciale):

https://<VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html

In questo esempio, l'IP di VxRail Manager è 172.168.10.50 in modo che l'URL diventi https://172.168.10.50/rest/vxm/api-doc.html:

Interrogazione della configurazione NTP del cluster VxRail corrente

Utilizzare il comando v1_sytem_ntp_get API Sezione System Information nel pannello a sinistra per interrogare la configurazione NTP corrente:

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

• Il client API esegue l'autenticazione e, se ottiene una risposta OK di 200, restituisce le informazioni richieste in cui si trova l'IP corrente del laboratorio del server NTP 172.168.10.45:

Aggiornamento delle informazioni sul server IP NTP del cluster VxRail

Utilizzare l'API v1_system_ntp_post disponibile nella sezione System Information nel pannello a sinistra per aggiornare la configurazione NTP corrente:

• L'URL diretto sarebbe https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_post tuttavia, questi possono cambiare da una versione all'altra, quindi è meglio navigare nell'interfaccia utente.
• Nella sezione Auth inserire le credenziali di autenticazione SSO di VxRail vCenter, che spesso sono le credenziali di autenticazione SSO administrator@vsphere.local ma può variare a seconda della configurazione del dominio.
• Per aggiornare il server NTP, modificare anche la sezione Body in tre aree:
  • Components è facoltativa e ALL è l'impostazione predefinita. Se è impostato ALL, tutti i server NTP nel cluster vengono sostituiti. Se VXM è impostato, viene sostituito solo il server NTP per VxRail Manager. Si tratta di un caso d'uso limitato in quanto si consiglia di mantenere coerente la configurazione di tutti i componenti. 

• Nella sezione vCenter è necessario passare un nome utente e una password SSO amministratore; in genere si tratta delle stesse informazioni della sezione Aut, ma è possibile fornire un account SSO di livello amministratore diverso.
• Nella sezione server, l'esempio seguente mostra l'impostazione NTP su IP 172.168.10.45

 

Se i codici di risposta imprevisti

In caso di sistema non integro o forse un nuovo server NTP non può essere raggiunto dagli host ESXi e così via. Il client API fornisce alcune indicazioni di base per i messaggi di errore e, ad esempio, è possibile trovare ulteriori codici errore di risposta online. https://restfulapi.net/http-status-codes/ è una buona posizione.

In caso di codici 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 NTP di VxRail tramite l'API REST. Questa funzionalità è disponibile nella roadmap di VxRail (la versione esatta verrà confermata in seguito) nel plug-in dell'interfaccia utente di VxRail.

Questo articolo fornisce linee guida ed esempi per questa attività per i clienti con poca esperienza nell'utilizzo dell'API REST di VxRail.

Le informazioni sull'IP contenute in questo articolo provengono da un laboratorio virtuale isolato temporaneo e non contengono informazioni riservate o sui clienti.