Dell VxRail: Jak zmienić adres IP serwera DNS w wersjach VxRail 8.0.x i 7.0.x przy użyciu pozostałego interfejsu API

Publiczna dokumentacja dla programistów firmy Dell

Aby uzyskać pełną dokumentację deweloperską dotyczącą interfejsu programowania aplikacji (API) VxRail REST i innych produktów firmy Dell, przejdź do interfejsów API deweloperów firmy Dell. Aby szybko znaleźć specyficzny interfejs API VxRail, przefiltruj hasło "Infrastruktura hiperkonwergentna".
   
Szczegółową dokumentację dotyczącą wykonywania zapytań lub aktualizowania DNS można znaleźć w sekcji "System Information" — pobieranie i ustawianie DNS:  
Ta dokumentacja może być używana do tworzenia niestandardowych poleceń curl lub integracji z aplikacją, taką jak "postman" lub innymi aplikacjami dla bardziej doświadczonych użytkowników.
 

Klient wbudowanego interfejsu API VxRail 

Preferowanym sposobem (zalecanym dla osób mniej zaznajomionych z interfejsem API REST) korzystania z interfejsów API VxRail jest wykorzystanie natywnego klienta API VxRail Manager.
Z VxRail w wersji 7.0.350 przeprowadziliśmy migrację do nowego interfejsu opartego na spotlight z większymi możliwościami.
Uzyskaj dostęp do klienta natywnego interfejsu API, wprowadzając w przeglądarce nazwę FQDN/IP VxRail Manager.

< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
Na przykład adres IP VxRail Manager to 172.168.10.50, więc adres URL staje się https://172.168.10.50/rest/vxm/api-doc.html:
     

Odpytywanie bieżącej konfiguracji DNS klastra VxRail

Aby sprawdzić bieżącą konfigurację DNS, użyj interfejsu API v1_sytem_dns_get, który można znaleźć w sekcji "System Information" w lewym panelu:

• Bezpośredni adres URL to https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get jednak mogą one ulec zmianie w zależności od wersji, więc najlepiej poruszać się po interfejsie użytkownika.
• Wprowadź poświadczenia uwierzytelniania jednokrotnego logowania (SSO) VxRail vCenter, które często są administrator@vsphere.local, ale mogą się różnić w zależności od konfiguracji domeny.
• Kliknij przycisk Wyślij żądanie, aby wykonać żądanie GET:

• Klient interfejsu API uwierzytelnia się i jeśli otrzymamy odpowiedź 200 OK, zwróć żądane informacje, w których nasz bieżący adres IP laboratorium serwera DNS to 172.168.10.253, a VxRail Manager nie jest skonfigurowany jako "Wewnętrzny DNS", co oznacza, że korzystamy z serwerów DNS dostarczonych przez klienta zewnętrznego:

Aktualizowanie informacji o serwerze IP DNS klastra VxRail

Aby zaktualizować bieżącą konfigurację DNS, użyj interfejsu API v1_system_dns_post, który można znaleźć w sekcji "System Information" w lewym panelu:

• Bezpośredni adres URL będzie https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post jednak mogą się one zmieniać w zależności od wersji, więc najlepiej nawigować w interfejsie użytkownika.
• W sekcji "Auth" wprowadź poświadczenia uwierzytelniania SSO VxRail vCenter, które często są administrator@vsphere.local, ale mogą się różnić w zależności od konfiguracji domeny.
• Aby zaktualizować serwer DNS, edytuj sekcję "Body" w trzech obszarach:
  • Sekcja "components" jest opcjonalna, a sekcja "ALL" jest opcjonalna. Jeśli opcja ALL jest ustawiona, wszystkie serwery DNS w klastrze, w tym VxRail Manager, vCenter i ESXi, są zastępowane. Jeśli ustawiono "VXM", wymieniany jest tylko serwer DNS dla VxRail Manager, co byłoby ograniczonym przypadkiem użycia, ponieważ zalecamy zachowanie spójności konfiguracji wszystkich komponentów. Należy pamiętać, że wartość "VXM" jest obsługiwana TYLKO w środowisku VCF na VxRail. 
  • Sekcja "vCenter" musi przekazać nazwę użytkownika i hasło SSO administratora, zwykle są to te same informacje, co w sekcji "Auth", ale można podać inne konto SSO poziomu administratora.
  • "serwery", w poniższym przykładzie ustawiamy DNS na IP 172.168.10.253  
    • Uwaga : podczas dodawania wielu serwerów adresy IP muszą być oddzielone przecinkami "172.168.10.253,10.8.8.8"
• Kliknij przycisk Send Request, aby wykonać żądanie POST:

 

• Żądanie może potrwać minutę w zależności od liczby hostów ESXi w klastrze, ale po pomyślnym zakończeniu żądania zwraca kod odpowiedzi 200 OK.

Jeśli wystąpią nieoczekiwane kody odpowiedzi.

W złym stanie systemu lub nie można uzyskać dostępu do nowego serwera DNS z hostów ESXi itp. Klient interfejsu API udostępnia podstawowe wskazówki dotyczące komunikatów o błędach, a dodatkowe kody błędów odpowiedzi można znaleźć w trybie online, na przykład https://restfulapi.net/http-status-codes/ jest to dobra lokalizacja.
Jeśli wystąpią jakiekolwiek nieoczekiwane kody błędów, skontaktuj się z działem pomocy technicznej firmy Dell w celu uzyskania dodatkowego rozwiązania problemu.
 

We wczesnych wersjach VxRail 8.0 procedury Solve Online odnoszą się do aktualizacji ustawień IP DNS VxRail za pośrednictwem interfejsu REST API. Możliwość zostanie dodana do wtyczki VxRail UI.
Ten artykuł zawiera wskazówki i przykłady dotyczące tego działania dla klientów z mniejszym doświadczeniem w korzystaniu z interfejsu API REST VxRail.

Informacje o adresie IP opisane w tym artykule pochodzą z tymczasowego wirtualnego odizolowanego laboratorium i nie zawierają żadnych poufnych informacji o adresie IP klienta.