Offentlig dokumentation til Dell-udviklere
Du kan finde en komplet udviklerdokumentation til VxRail REST API (Application Programming Interface) og andre Dell-produkter ved at gå til
Dell Developer API'er. Du kan hurtigt finde den VxRail-specifikke API ved at filtrere efter "Hyperkonvergeret infrastruktur".
Specifik dokumentation til forespørgsel eller opdatering af DNS kan findes under "Systemoplysninger" - Hent og angiv DNS:
Denne dokumentation kan bruges til at oprette brugerdefinerede krøllekommandoer eller integrere i et program som "postbud" eller andre applikationer til mere erfarne brugere.
VxRail integreret API-klient
Den foretrukne måde (anbefales til personer, der er mindre fortrolige med REST API) at bruge VxRail API erne er at udnytte den oprindelige VxRail Manager API-klient.
Fra VxRail-version 7.0.350 er vi migreret til en ny grænseflade baseret på spotlight med flere funktioner.
Få adgang til den indbyggede API-klient ved at indtaste VxRail Manager FQDN/IP i din browser.
< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
F.eks. er IP-adressen til VxRail Manager 172.168.10.50, så URL-adressen bliver
https://172.168.10.50/rest/vxm/api-doc.html:
Forespørgslen om den aktuelle DNS-konfiguration for VxRail-klyngen
For at forespørge på den aktuelle DNS-konfiguration skal du bruge v1_sytem_dns_get API, som kan findes under afsnittet "Systemoplysninger" i venstre panel:
- Den direkte URL ville være https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get men disse kan ændre sig på tværs af versioner, så det er bedst at navigere i brugergrænsefladen.
- Indtast loginoplysningerne for VxRail vCenter Single Sign-On (SSO), som ofte er administrator@vsphere.local, men som kan variere afhængigt af din domænekonfiguration.
- Klik på knappen Send anmodning for at udføre GET-anmodningen:
- API-klienten godkender, og hvis vi får et 200 OK-svar, returnerer vi de ønskede oplysninger, hvor vores aktuelle DNS-serverlaboratorie-IP er 172.168.10.253, og VxRail Manager ikke er konfigureret som "Intern DNS", hvilket betyder, at vi bruger en ekstern DNS-server, der leveres af kunden:
Opdatering af VxRail-klyngens DNS IP-serveroplysninger
For at opdatere den aktuelle DNS-konfiguration skal du bruge v1_system_dns_post API, som findes under afsnittet "Systemoplysninger" i venstre panel:
- Den direkte URL ville være https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post, men disse kan ændre sig på tværs af versioner, så det er bedst at navigere i brugergrænsefladen.
- I afsnittet "Auth" skal du indtaste legitimationsoplysningerne for VxRail vCenter SSO-godkendelse, som ofte er de administrator@vsphere.local, men som kan variere afhængigt af din domænekonfiguration.
- For at opdatere DNS-serveren skal du redigere afsnittet "Krop" på tre områder:
- Afsnittet "komponenter" er valgfrit, og "ALLE" er standard. Hvis ALL er indstillet, udskiftes alle DNS-servere i klyngen, herunder VxRail Manager, vCenter og ESXi. Hvis "VXM" er indstillet, er det kun DNS-serveren til VxRail Manager, der udskiftes, hvilket ville være et begrænset brugstilfælde, da vi anbefaler at holde alle komponentkonfigurationer ensartede. Bemærk, at værdien "VXM" KUN understøttes i VCF på VxRail-miljøer.
- "vCenter" sektion skal vi videregive en administrator SSO brugernavn og adgangskode, normalt er dette de samme oplysninger som i "Auth" sektionen, men en anden admin niveau SSO konto kan leveres.
- "servere" sektion, i nedenstående eksempel indstiller vi DNS til IP 172.168.10.253
- Bemærk: Når du tilføjer flere servere, skal IP-adresserne være kommaseparerede: "172.168.10.253,10.8.8.8"
- Klik på knappen Send anmodning for at udføre POST-anmodningen:
- Anmodningen kan tage et min. afhængigt af antallet af ESXi-værter i klyngen, men når anmodningen er gennemført, returneres en 200 OK-svarkode.
Hvis der er uventede svarkoder.
I et usundt system eller måske kan en ny DNS-server ikke nås fra ESXi-værter osv. API-klienten giver nogle grundlæggende fejlmeddelelsesvejledning, og yderligere svarfejlkoder kan findes online, for eksempel
https://restfulapi.net/http-status-codes/ er en god placering.
Hvis der opstår uventede fejlkoder, skal du kontakte Dell Support for yderligere fejlfinding.
I tidlige VxRail 8.0-udgivelser henviser Solve Online-procedurer til opdatering af VxRail DNS IP-indstillinger via REST API. Muligheden føjes til VxRail UI-plug-in'en.
Denne artikel indeholder vejledning og eksempler på denne aktivitet til kunder, der har færre erfaringer med at udnytte VxRail REST API.
IP-oplysningerne i denne artikel stammer fra et midlertidigt, virtuelt, isoleret laboratorium og indeholder ingen kunde-/fortrolige IP-oplysninger.