Dell VxRail: Ändern der DNS-Server-IP-Adresse auf VxRail 8.0.x- und 7.0.x-Versionen über die REST API

Öffentliche Dokumentation für Dell Entwickler

Eine vollständige Entwicklerdokumentation der VxRail REST Application Programming Interface (API) und anderer Dell Produkte finden Sie unter Dell Entwickler-APIs. Um die VxRail-spezifische API schnell zu finden, filtern Sie nach "Hyperconverged Infrastructure".
   
Spezifische Dokumentation zum Abfragen oder Aktualisieren von DNS finden Sie unter "Systeminformationen" - DNS abrufen und festlegen:  
Diese Dokumentation kann verwendet werden, um benutzerdefinierte curl-Befehle zu erstellen oder in eine Anwendung wie "postman" oder andere Anwendungen für erfahrenere Benutzer zu integrieren.
 

Integrierter VxRail-API-Client 

Die bevorzugte Methode (empfohlen für Personen, die mit der REST-API weniger vertraut sind) ist die Nutzung des nativen VxRail Manager-API-Clients.
Ab VxRail-Version 7.0.350 haben wir auf eine neue, auf Spotlight basierende Benutzeroberfläche mit größeren Funktionen migriert.
Greifen Sie auf den nativen API-Client zu, indem Sie die FQDN/IP von VxRail Manager in Ihren Browser eingeben.

< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
Beispiel: Die VxRail Manager-IP lautet 172.168.10.50, sodass die URL https://172.168.10.50/rest/vxm/api-doc.html wird:
     

Abfragen der aktuellen DNS-Konfiguration des VxRail-Clusters

Um die aktuelle DNS-Konfiguration abzufragen, verwenden Sie die v1_sytem_dns_get API, die Sie im Abschnitt "Systeminformationen" im linken Bereich finden:

• Die direkte URL wäre https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get diese kann sich jedoch von Version zu Version ändern. Navigieren Sie daher am besten in der Benutzeroberfläche.
• Geben Sie die Authentifizierungsdaten für VxRail vCenter Single Sign-On (SSO) ein. Diese sind häufig administrator@vsphere.local, können jedoch je nach Domainkonfiguration variieren.
• Klicken Sie auf die Schaltfläche Send Request, um die GET-Anforderung durchzuführen:

• Der API-Client führt die Authentifizierung durch und wenn wir die Antwort "200 OK" erhalten, geben wir die angeforderten Informationen zurück, wobei unsere aktuelle DNS-Serverlabor-IP 172.168.10.253 ist und VxRail Manager nicht als "internes DNS" konfiguriert ist, was bedeutet, dass wir einen externen, vom Kunden bereitgestellten DNS-Server verwenden:

Aktualisieren der DNS-IP-Serverinformationen des VxRail-Clusters

Um die aktuelle DNS-Konfiguration zu aktualisieren, verwenden Sie die v1_system_dns_post API, die im Abschnitt "Systeminformationen" im linken Bereich zu finden ist:

• Die direkte URL wäre https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post diese kann sich jedoch von Version zu Version ändern. Navigieren Sie daher am besten in der Benutzeroberfläche.
• Geben Sie im Abschnitt "Authentifizierung" die SSO-Authentifizierungsdaten für VxRail vCenter ein. Diese sind häufig administrator@vsphere.local, können jedoch je nach Ihrer Domainkonfiguration variieren.
• Bearbeiten Sie zum Aktualisieren des DNS-Servers den Abschnitt "Body" in drei Bereichen:
  • Der Abschnitt "components" ist optional und "ALL" ist die Standardeinstellung. Wenn ALL festgelegt ist, werden alle DNS-Server im Cluster ersetzt, einschließlich VxRail Manager, vCenter und ESXi. Wenn "VXM" festgelegt ist, wird nur der DNS-Server für VxRail Manager ersetzt. Dies wäre ein eingeschränktes Anwendungsbeispiel, da wir empfehlen, die Konfiguration aller Komponenten konsistent zu halten. Beachten Sie, dass der Wert "VXM" NUR in der VCF auf VxRail-Umgebung unterstützt wird. 
  • Im Abschnitt "vCenter" müssen wir einen SSO-Nutzernamen und ein Kennwort des Administrators übergeben. In der Regel sind dies die gleichen Informationen wie im Abschnitt "Authentifizierung", aber es kann ein anderes SSO-Konto auf Administratorebene bereitgestellt werden.
  • Im folgenden Beispiel legen wir den DNS auf IP 172.168.10.253 fest.  
    • Hinweis: Wenn Sie mehrere Server hinzufügen, müssen die IPs durch Kommas getrennt werden: "172.168.10.253,10.8.8.8".
• Klicken Sie auf die Schaltfläche Send Request, um die POST-Anforderung durchzuführen:

 

• Die Anforderung kann je nach Anzahl der ESXi-Hosts im Cluster eine Minute dauern. Wenn die Anforderung erfolgreich abgeschlossen wurde, wird jedoch der Antwortcode 200 OK zurückgegeben.

Wenn unerwartete Antwortcodes vorhanden sind.

In einem fehlerhaften System oder vielleicht kann ein neuer DNS-Server nicht von ESXi-Hosts usw. erreicht werden. Der API-Client bietet einige grundlegende Anleitungen zu Fehlermeldungen. Zusätzliche Antwortfehlercodes können online gefunden werden, z. B. https://restfulapi.net/http-status-codes/ ist ein guter Speicherort.
Wenn unerwartete Fehlercodes auftreten, wenden Sie sich für weitere Fehlerbehebungsmaßnahmen an den Dell Support.
 

In frühen VxRail 8.0-Versionen beziehen sich die Solve Online-Verfahren auf die Aktualisierung von VxRail-DNS-IP-Einstellungen über die REST API. Die Funktion wird dem VxRail-UI-Plug-in hinzugefügt.
Dieser Artikel enthält Anleitungen und Beispiele für diese Aktivität für Kunden, die weniger Erfahrungen mit der Nutzung der VxRail REST API haben.

Die IP-Informationen in diesem Artikel stammen aus einem temporären, virtuell isolierten Labor und enthalten keine kundenbezogenen/vertraulichen IP-Informationen.