VxRail: Cómo cambiar la IP del servidor NTP en las versiones 8.0.x y 7.0.x de VxRail mediante la API REST

Documentación pública para desarrolladores de Dell

La documentación para desarrolladores de la API REST de VxRail y de otros productos Dell se encuentra en el sitio del desarrollador de soporte de Dell; filtre por Infraestructura hiperconvergente para encontrar la API específica de VxRail.

La documentación específica para consultar o actualizar NTP se puede encontrar en Información del sistema, Obtener y Configurar NTP:

Esta documentación se puede utilizar para crear curl comandos o integrarse en una aplicación como postman u otras aplicaciones para usuarios más experimentados.

Cliente de API integrada de VxRail 

La forma preferida (recomendada para personas menos familiarizadas con la API REST) de utilizar las API de VxRail es aprovechar el cliente de API nativa de VxRail Manager.

A partir de la versión de código 7.0.350 de VxRail, se utiliza una nueva interfaz con mayores funcionalidades basada en Spotlight. Para acceder al cliente de API nativa, vaya a la siguiente URL que reemplaza <VxM> por el FQDN/IP de VxRail Manager con su navegador preferido (no se necesita un cliente de API especial):

https://<VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html

En este ejemplo, la IP de VxRail Manager es 172.168.10.50 por lo que la URL se convierte en https://172.168.10.50/rest/vxm/api-doc.html:

Consulta de la configuración actual de NTP del clúster de VxRail

Use el comando v1_sytem_ntp_get API Sección System Information en el panel izquierdo para consultar la configuración actual de NTP:

• La URL directa sería https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_get sin embargo, estos pueden cambiar entre versiones, por lo que es mejor navegar en la interfaz de usuario.
• Ingrese las credenciales de autenticación de Single Sign On (SSO) de VxRail vCenter, que a menudo son las administrator@vsphere.local pero puede variar según la configuración de su dominio.
• Haga clic en el botón Enviar solicitud para realizar el GET pedir:

• El cliente de la API se autentica y, si obtiene una respuesta de 200 OK, devuelve la información solicitada donde se encuentra la IP actual del laboratorio del servidor NTP 172.168.10.45:

Actualización de la información del servidor IP NTP del clúster de VxRail

Utilice la API de v1_system_ntp_post que se puede encontrar en la sección Información del sistema en el panel izquierdo para actualizar la configuración actual de NTP:

• La URL directa sería https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_post sin embargo, estos pueden cambiar entre versiones, por lo que es mejor navegar en la interfaz de usuario.
• En la sección Auth , ingrese las credenciales de autenticación de SSO de VxRail vCenter, que a menudo son las administrator@vsphere.local pero puede variar según la configuración de su dominio.
• Para actualizar el servidor NTP, edite también la sección Cuerpo en tres áreas:
  • La sección Components es opcional y ALL es el valor predeterminado. Si se configura ALL, se reemplazan todos los servidores NTP del clúster. Si se configura VXM, solo se reemplaza el servidor NTP para VxRail Manager, lo que sería un caso de uso limitado, ya que se recomienda mantener la coherencia de todas las configuraciones de componentes. 

• En la sección vCenter, debe pasar un nombre de usuario y una contraseña de administrador de SSO. Por lo general, esta es la misma información que en la sección Auth, pero se puede proporcionar una cuenta de SSO de nivel de administrador diferente.
• En la sección servers, el siguiente ejemplo muestra la configuración de NTP en IP 172.168.10.45

 

Si los códigos de respuesta inesperados

En un sistema en mal estado o tal vez no se puede acceder a un nuevo servidor NTP desde hosts ESXi, y así sucesivamente. El cliente de API proporciona orientación básica sobre mensajes de error y se pueden encontrar códigos de error de respuesta adicionales en línea, por ejemplo https://restfulapi.net/http-status-codes/ es una buena ubicación.

Si se presentan códigos de error inesperados, comuníquese con el soporte de Dell según corresponda para la solución de problemas adicional.

En las primeras versiones de VxRail 8.0, los procedimientos de SolVe Online hacen referencia a la actualización de la configuración de IP de NTP de VxRail a través de la API REST. Está en el plan de trabajo de VxRail (la versión exacta se confirmará más adelante) tener esta capacidad disponible en el plug-in de la interfaz de usuario de VxRail.

En este artículo, se proporciona orientación y ejemplos para esta actividad para clientes con menos experiencia en el aprovechamiento de la API REST de VxRail.

La información de IP en este artículo proviene de un laboratorio aislado virtual temporal y no contiene información de IP confidencial o del cliente.