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

Documentación pública para desarrolladores de Dell

Para obtener documentación completa para desarrolladores de la interfaz de programación de aplicaciones (API) REST de VxRail y otros productos Dell, vaya a API para desarrolladores de Dell. Para encontrar rápidamente la API específica de VxRail, filtre por "Hyperconverged Infrastructure".
   
La documentación específica para consultar o actualizar DNS se puede encontrar en "Información del sistema": obtener y configurar DNS:  
Esta documentación se puede utilizar para crear comandos curl personalizados 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 7.0.350 de VxRail, migramos a una nueva interfaz basada en Spotlight con mayores funcionalidades.
Ingrese el FQDN/IP de VxRail Manager en el navegador para acceder al cliente de la API nativa.

< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
Por ejemplo, la IP de VxRail Manager es 172.168.10.50, por lo que la URL pasa a ser https://172.168.10.50/rest/vxm/api-doc.html:
     

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

Para consultar la configuración actual de DNS, utilice la API de v1_sytem_dns_get que se puede encontrar en la sección "System Information" en el panel izquierdo:

• La dirección URL directa sería https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get sin embargo, 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 administrator@vsphere.local, pero pueden variar según la configuración de su dominio.
• Haga clic en el botón Enviar solicitud para realizar la solicitud GET:

• El cliente de la API se autentica y, si obtenemos una respuesta 200 OK, devuelve la información solicitada donde la IP actual del laboratorio del servidor DNS es 172.168.10.253 y VxRail Manager no está configurado como "DNS interno", lo que significa que estamos utilizando servidores DNS proporcionados por un cliente externo:

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

Para actualizar la configuración actual de DNS, utilice la API de v1_system_dns_post que se puede encontrar en la sección "System Information" en el panel izquierdo:

• La dirección URL directa sería https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post sin embargo, 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 administrator@vsphere.local, pero pueden variar según la configuración de su dominio.
• Para actualizar el servidor DNS, edite la sección "Body" en tres áreas:
  • La sección "components" es opcional y "ALL" es la opción predeterminada. Si se configura ALL, se reemplazan todos los servidores DNS del clúster, incluidos VxRail Manager, vCenter y ESXi. Si se configura "VXM", solo se reemplaza el servidor DNS para VxRail Manager, lo que sería un caso de uso limitado, ya que se recomienda mantener la coherencia en la configuración de todos los componentes. Tenga en cuenta que el valor "VXM" SOLO se admite en el entorno de VCF on VxRail. 
  • En la sección "vCenter", debemos pasar un nombre de usuario y una contraseña de SSO de administrador. 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.
  • "servers", en el siguiente ejemplo, configuramos el DNS en la dirección IP 172.168.10.253  
    • Nota: cuando se agregan varios servidores, las direcciones IP deben estar separadas por comas: "172.168.10.253,10.8.8.8"
• Haga clic en el botón Enviar solicitud para realizar la solicitud POST:

 

• La solicitud puede tardar un mínimo según la cantidad de hosts ESXi en el clúster, aunque cuando la solicitud se completa correctamente, devuelve un código de respuesta 200 OK.

Si hay códigos de respuesta inesperados.

En un sistema en mal estado o tal vez no se puede acceder a un nuevo servidor DNS desde hosts ESXi, etcétera. 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 hay códigos de error inesperados, comuníquese con el soporte de Dell según corresponda para solucionar más problemas.
 

En las primeras versiones de VxRail 8.0, los procedimientos en línea de SolVe hacen referencia a la actualización de la configuración de IP de DNS de VxRail a través de la API REST. La capacidad se agregará al plug-in de la interfaz de usuario de VxRail.
En este artículo, se proporciona orientación y ejemplos para esta actividad para los clientes con menos experiencias en el aprovechamiento de la API REST de VxRail.

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