VxRail: Zmiana adresu IP serwera NTP w wersjach VxRail 8.0.x i 7.0.x za pomocą interfejsu API REST

Summary: Jak wykorzystać interfejs programowania aplikacji (API) VxRail do sprawdzania i aktualizowania co najmniej jednego skonfigurowanego adresu IP serwera NTP (VxRail Network Time Protocol). ...

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.

Instructions

Publiczna dokumentacja deweloperska firmy Dell

Dokumentacja dla programistów dotycząca interfejsu API REST VxRail i innych produktów firmy Dell znajduje się w witrynie Dell Support dla deweloperów. Filtruj infrastrukturę hiperkonwergentną , aby znaleźć specjalny interfejs API VxRail.

Strona domowa https://developer.dell.com/apis

Szczegółową dokumentację dotyczącą wykonywania zapytań lub aktualizowania NTP można znaleźć w sekcjach Informacje o systemie, Pobieranie i ustawianie NTP:

Dokumentacja NTP

Dokumentacja ta może służyć do tworzenia niestandardowych curl poleceń lub zintegrować z aplikacją, taką jak postman lub inne aplikacje 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.

Od kodu VxRail w wersji 7.0.350 używany jest nowy interfejs z większymi możliwościami opartymi na reflektorze. Aby uzyskać dostęp do natywnego klienta API, przejdź do następującego adresu URL, zastępując <VxM> nazwą FQDN/IP VxRail Manager przy użyciu preferowanej przeglądarki (nie ma potrzeby korzystania ze specjalnego klienta API):

https://<VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
W tym przykładzie 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:
VxRail Manager REST API


Odpytywanie bieżącej konfiguracji NTP klastra VxRail

Użyj polecenia v1_sytem_ntp_get API Informacje o systemie w lewym panelu, aby sprawdzić bieżącą konfigurację NTP:
  • Bezpośredni adres URL to https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_get mogą się one jednak zmieniać 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 może się różnić w zależności od konfiguracji domeny.
  • Kliknij przycisk Wyślij zgłoszenie , aby wykonać GET prosić:
Odpytywanie NTP z interfejsu API REST
  • Klient interfejsu API uwierzytelnia się i jeśli otrzyma odpowiedź 200 OK, zwraca żądane informacje, gdzie znajduje się nasz bieżący adres IP laboratorium serwera NTP 172.168.10.45:
Wyniki zapytania interfejsu API REST


Aktualizowanie informacji o serwerze IP NTP klastra VxRail

Aby zaktualizować bieżącą konfigurację NTP, użyj interfejsu API v1_system_ntp_post, który znajduje się w sekcji Informacje o systemie w lewym panelu:
  • Bezpośredni adres URL to https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_post mogą się one jednak zmieniać w zależności od wersji, więc najlepiej poruszać się po interfejsie użytkownika.
  • W sekcji Auth wprowadź poświadczenia uwierzytelniania SSO VxRail vCenter, które często są administrator@vsphere.local , ale może się różnić w zależności od konfiguracji domeny.
  • Aby zaktualizować serwer NTP, edytuj również sekcję Treść w trzech obszarach:
    • Sekcja Components jest opcjonalna, a domyślną wartością ALL jest kolumna ALL. Jeśli opcja ALL jest ustawiona, wszystkie serwery NTP w klastrze są zastępowane. Jeśli VXM jest ustawiony, wymieniany jest tylko serwer NTP dla VxRail Manager, co byłoby ograniczonym przypadkiem użycia, ponieważ zaleca się zachowanie spójności konfiguracji wszystkich komponentów. 

Uwaga: Wartość VXM jest obsługiwana TYLKO w środowisku VCF na VxRail.
 
  • W sekcji vCenter należy 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 na poziomie administratora.
  • W sekcji serwerów poniższy przykład pokazuje ustawienie NTP na IP 172.168.10.45
 
Uwaga: Podczas dodawania wielu serwerów adresy IP muszą być na przykład oddzielone przecinkami 172.168.10.45, 172.168.10.46
 
  • Kliknij przycisk Send Request , aby wykonać żądanie POST:
Korzystanie z polecenia REST API SET
Wyniki zestawu interfejsu REST API SET


Jeśli nieoczekiwane kody odpowiedzi

W systemie w złej kondycji lub nie można nawiązać połączenia z nowym serwerem NTP z hostów ESXi itd. Klient interfejsu API zapewnia podstawowe wskazówki dotyczące komunikatów o błędach, a dodatkowe kody błędów odpowiedzi można znaleźć w Internecie, na przykład https://restfulapi.net/http-status-codes/ 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.
Błąd interfejsu API REST

Additional Information

We wczesnych wersjach VxRail 8.0 procedury Solve Online odnoszą się do aktualizacji ustawień IP VxRail NTP za pośrednictwem interfejsu API REST. Na mapie drogowej VxRail (dokładna wersja zostanie potwierdzona później), aby ta możliwość była dostępna we wtyczce VxRail UI.

Ten artykuł zawiera wskazówki i przykłady dotyczące tego działania dla klienta z mniejszym doświadczeniem w korzystaniu z interfejsu API REST VxRail.

Informacje o adresie IP zawarte w tym artykule pochodzą z tymczasowego wirtualnego izolowanego laboratorium i nie zawierają żadnych informacji o kliencie ani poufnych informacji o adresie IP.

Affected Products

VxRail Appliance Family
Article Properties
Article Number: 000215966
Article Type: How To
Last Modified: 28 Mar 2025
Version:  8
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.