Dell VxRail: Como alterar o IP do servidor DNS nas versões 8.0.x e 7.0.x do VxRail usando a API REST

Documentação pública para desenvolvedores da Dell

Para obter uma documentação completa do desenvolvedor sobre a API (Application Programming Interface) REST do VxRail e outros produtos Dell, acesse APIs para desenvolvedores da Dell. Para localizar rapidamente a API específica do VxRail, filtre por "Hyperconverged Infrastructure".
   
A documentação específica para consultar ou atualizar o DNS pode ser encontrada em "Informações do sistema" - Obter e definir DNS:  
Esta documentação pode ser usada para criar comandos curl personalizados ou integrar em um aplicativo como "carteiro" ou outros aplicativos para usuários mais experientes.
 

Client de API incorporado do VxRail 

A maneira preferencial (recomendada para pessoas menos familiarizadas com a API REST) de usar as APIs do VxRail é utilizar o client de API nativo do VxRail Manager.
A partir da versão 7.0.350 do VxRail, migramos para uma nova interface baseada no Spotlight com mais recursos.
Acesse o client de API nativo digitando o FQDN/IP do VxRail Manager em seu navegador.

< https://VxRail_Manager_IP_or_FQDN>/rest/vxm/api-doc.html
Por exemplo, o IP do VxRail Manager é 172.168.10.50, portanto, o URL torna-se https://172.168.10.50/rest/vxm/api-doc.html:
     

Consultando a configuração atual de DNS do VxRail Cluster

Para consultar a configuração atual do DNS, use a API v1_sytem_dns_get, que pode ser encontrada na seção "System Information" no painel esquerdo:

• A URL direta seria https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get no entanto, elas podem mudar entre as versões, portanto, é melhor navegar na interface do usuário.
• Digite as credenciais de autenticação de logon único (SSO) do VxRail vCenter, que geralmente são as administrator@vsphere.local, mas podem variar dependendo da configuração do domínio.
• Clique no botão Send Request para executar a solicitação GET:

• O client de API é autenticado e, se obtivermos uma resposta 200 OK, retornaremos as informações solicitadas em que nosso IP atual de laboratório do servidor DNS é 172.168.10.253 e o VxRail Manager não está configurado como "DNS interno", o que significa que estamos usando servidores DNS externos fornecidos pelo cliente:

Atualizando as informações do servidor IP DNS do VxRail Cluster

Para atualizar a configuração atual do DNS, use a API v1_system_dns_post, que pode ser encontrada na seção "System Information" no painel esquerdo:

• A URL direta seria https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post no entanto, elas podem mudar entre as versões, portanto, é melhor navegar na interface do usuário.
• Na seção "Auth", digite as credenciais de autenticação SSO do VxRail vCenter, que geralmente são as administrator@vsphere.local, mas podem variar dependendo da configuração do domínio.
• Para atualizar o servidor DNS, edite a seção "Corpo" em três áreas:
  • A seção "components" é opcional e "ALL" é o padrão. Se a opção TUDO estiver definida, todos os servidores DNS do cluster serão substituídos, inclusive o VxRail Manager, o vCenter e o ESXi. Se "VXM" estiver definido, somente o servidor DNS do VxRail Manager será substituído, o que seria um caso de uso limitado, pois recomendamos manter todas as configurações de componentes consistentes. Observe que o valor "VXM" é compatível SOMENTE com o ambiente VCF on VxRail. 
  • Na seção "vCenter", devemos aprovar um nome de usuário e senha de SSO de administrador. Normalmente, são as mesmas informações da seção "Auth", mas é possível fornecer uma conta de SSO diferente de nível de administrador.
  • seção "servidores", no exemplo abaixo, estamos configurando o DNS como IP 172.168.10.253  
    • Nota : ao adicionar vários servidores, os IPs devem ser separados por vírgulas "172.168.10.253,10.8.8.8".
• Clique no botão Send Request para executar a solicitação POST:

 

• A solicitação pode demorar um minuto, dependendo do número de hosts do ESXi no cluster, embora quando a solicitação for concluída com sucesso, ela retornará um código de resposta de 200 OK.

Se houver códigos de resposta inesperados.

Em um sistema não íntegro ou talvez um novo servidor DNS não possa ser acessado a partir de hosts ESXi, etc. O cliente de API fornece algumas orientações básicas sobre a mensagem de erro, e códigos de erro de resposta adicionais podem ser encontrados on-line, por exemplo, https://restfulapi.net/http-status-codes/ é um bom local.
Se algum código de erro inesperado for acionado, entre em contato com o Suporte Dell apropriadamente para obter solução de problemas adicionais.
 

Nas primeiras versões do VxRail 8.0, os procedimentos do Solve Online fazem referência à atualização das configurações de IP do DNS do VxRail por meio da API REST. A capacidade será adicionada ao plug-in da interface do usuário do VxRail.
Este artigo fornece orientações e exemplos dessa atividade para clientes com menos experiência utilizando a API REST do VxRail.

As informações de IP neste artigo de um laboratório virtual isolado temporário e não contêm informações confidenciais/de IP do cliente.