Dell VxRail: DNS-palvelimen IP-osoitteen muuttaminen VxRail 8.0.x- ja 7.0.x-versioissa rest-ohjelmointirajapinnan avulla

Julkinen dokumentaatio Dell-kehittäjille

Kattava kehittäjädokumentaatio VxRail REST Application Programming Interfacesta (API) ja muista Dell-tuotteista on osoitteessa Dell Developer APIs. Voit etsiä VxRailille sopivan ohjelmointirajapinnan nopeasti suodattamalla kohdan Hyperconverged Infrastructure.
   
DNS:n kyselyä tai päivitystä koskevat ohjeet ovat kohdassa System Information - Get and Set DNS:  
Tämän dokumentaation avulla voidaan luoda mukautettuja kiharakomentoja tai integroida sovellukseen, kuten "postinkantaja" tai muihin sovelluksiin kokeneemmille käyttäjille.
 

Sulautetun VxRail-ohjelmointirajapinnan asiakas 

Suositeltava tapa (suositellaan henkilöille, jotka eivät tunne REST-ohjelmointirajapintaa) käyttää VxRail-ohjelmointirajapintoja on käyttää alkuperäistä VxRail Manager API -asiakasohjelmaa.
VxRail-julkaisuversiosta 7.0.350 lähtien olemme siirtyneet uuteen käyttöliittymään, joka perustuu Spotlightiin ja entistä parempiin ominaisuuksiin.
Avaa natiivi API-asiakas kirjoittamalla selaimeen VxRail Managerin FQDN/IP.

< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
Esimerkiksi VxRail Managerin IP-osoite on 172.168.10.50, joten URL-osoite muuttuu https://172.168.10.50/rest/vxm/api-doc.html:
     

Nykyisen VxRail-klusterin DNS-määritysten kysely

Voit tehdä kyselyn nykyisestä DNS-määrityksestä käyttämällä v1_sytem_dns_get API:ta, joka löytyy vasemman paneelin System Information -osiosta:

• Suora URL-osoite on https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get ne voivat kuitenkin muuttua eri versioissa, joten käyttöliittymässä kannattaa liikkua.
• Anna VxRail vCenter Single Sign-On (SSO) -todennustunnistetiedot, jotka ovat usein administrator@vsphere.local, mutta voivat vaihdella toimialueen määritysten mukaan.
• Napsauta Lähetä pyyntö -painiketta suorittaaksesi GET-pyynnön:

• API-asiakas todentaa ja jos saamme 200 OK -vastauksen, palauta pyydetyt tiedot, jos nykyinen DNS-palvelinlaboratoriomme IP on 172.168.10.253 ja VxRail Manageria ei ole määritetty "sisäiseksi DNS:ksi", mikä tarkoittaa, että käytämme ulkoista asiakkaan toimittamaa DNS-palvelinta:

VxRail-klusterin DNS-IP-palvelimen tietojen päivittäminen

Päivitä nykyinen DNS-määritys käyttämällä v1_system_dns_post APIa, joka löytyy vasemman paneelin System Information -osiosta:

• Suora URL-osoite on https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post ne voivat kuitenkin muuttua eri versioissa, joten käyttöliittymässä kannattaa liikkua.
• Anna Auth-kohdassa VxRail vCenterin kertakirjautumisen todennustunnistetiedot, jotka ovat usein administrator@vsphere.local, mutta voivat vaihdella toimialueen määrityksen mukaan.
• Jos haluat päivittää DNS-palvelimen, muokkaa "Body" -osaa kolmella alueella:
  • Components-osa on valinnainen, ja oletusarvo on ALL. Jos ALL on määritetty, kaikki klusterin DNS-palvelimet, kuten VxRail Manager, vCenter ja ESXi, korvataan. Jos VXM on määritetty, vain VxRail Managerin DNS-palvelin korvataan, mikä on rajoitettu käyttötapa, koska suosittelemme, että kaikki osat määritetään yhdenmukaisesti. Huomioi, että VXM-arvoa tuetaan VAIN VCF on VxRail -ympäristössä. 
  • vCenter-osiossa on välitettävä järjestelmänvalvojan kertakirjautumisen käyttäjänimi ja salasana. Yleensä nämä ovat samat tiedot kuin Auth-kohdassa, mutta eri järjestelmänvalvojatason kertakirjautumistili voidaan antaa.
  • "palvelimet" -osassa, alla olevassa esimerkissä asetamme DNS: ksi IP 172.168.10.253  
    • Huomautus : kun lisäät useita palvelimia, IP-osoitteet on erotettava pilkuilla: "172.168.10.253,10.8.8.8"
• Suorita POST-pyyntö napsauttamalla Lähetä pyyntö -painiketta:

 

• Pyyntö voi kestää jonkin verran klusterissa olevien ESXi-isäntien määrän mukaan. Kun pyyntö on valmis, se palauttaa 200 OK-vastauskoodin.

Jos saat odottamattomia vastauskoodeja.

Epäterveessä järjestelmässä tai ehkä uutta DNS-palvelinta ei saada ESXi-isänniltä jne. API-asiakas antaa joitain perusvirheilmoitusten ohjeita, ja lisää vastausvirhekoodeja löytyy esimerkiksi verkosta, https://restfulapi.net/http-status-codes/ on hyvä sijainti.
Jos odottamattomia virhekoodeja ilmenee, pyydä Dell-tukea lisävianmääritystä varten.
 

VxRail 8.0:n varhaisissa versioissa Solve Online -ohjeet viittaavat VxRailin DNS-IP-asetusten päivittämiseen REST-ohjelmointirajapinnan kautta. Toiminto lisätään VxRail-käyttöliittymälaajennukseen.
Tässä artikkelissa on ohjeita ja esimerkkejä tästä tehtävästä asiakkaille, joilla on vähemmän kokemusta VxRail REST API:n käytöstä.

Tämän artikkelin IP-tiedot ovat peräisin väliaikaisesta virtuaalisesta eristetystä laboratoriosta, eivätkä ne sisällä asiakas-/luottamuksellisia IP-tietoja.