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

Documentação pública do desenvolvedor da Dell

A documentação do desenvolvedor para a API REST do VxRail e outros produtos Dell pode ser encontrada no site do desenvolvedor de suporte da Dell, filtre por infraestrutura hiperconvergente para encontrar a API específica do VxRail.

A documentação específica para consultar ou atualizar o NTP pode ser encontrada em Informações do sistema, Obter e Definir NTP:

Esta documentação pode ser usada para criar curl comandos ou integrar em um aplicativo como postman 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 do código do VxRail versão 7.0.350, uma nova interface é usada com recursos maiores baseados no Spotlight. Para acessar o client de API nativo, acesse a seguinte URL substituindo <o VxM pelo VxRail> Manager FQDN/IP com seu navegador preferido (não há necessidade de um client de API especial):

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

Neste exemplo, o IP do VxRail Manager é 172.168.10.50 para que a URL se torne https://172.168.10.50/rest/vxm/api-doc.html:

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

Use o comando v1_sytem_ntp_get API Seção System Information no painel esquerdo para consultar a configuração atual do NTP:

• A URL direta seria https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_get no entanto, eles 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 pode variar dependendo da configuração do domínio.
• Clique no botão Send Request para executar o GET pedir:

• O client de API é autenticado e, se receber uma resposta de 200 OK, retorne as informações solicitadas onde está nosso IP atual de laboratório do servidor NTP 172.168.10.45:

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

Use a API v1_system_ntp_post, que pode ser encontrada na seção System Information do painel esquerdo, para atualizar a configuração atual do NTP:

• A URL direta seria https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_post no entanto, eles 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 pode variar dependendo da configuração do domínio.
• Para atualizar o servidor NTP, edite também a seção Body em três áreas:
  • A seção Components é opcional e ALL é o padrão. Se TUDO estiver definido, todos os servidores NTP no cluster serão substituídos. Se o VXM estiver definido, somente o servidor NTP do VxRail Manager será substituído, o que seria um caso de uso limitado, pois é recomendável manter a consistência de todas as configurações de componentes. 

• Na seção vCenter, você deve passar um nome de usuário e senha de SSO de administrador, geralmente são as mesmas informações que na seção Auth, mas uma conta SSO de nível de administrador diferente pode ser fornecida.
• Na seção servidores, o exemplo abaixo mostra como configurar o NTP como IP 172.168.10.45

 

Se códigos de resposta inesperados

Em um sistema não íntegro ou talvez um novo servidor NTP, não seja possível acessar os hosts do ESXi e assim por diante. O cliente de API fornece algumas orientações básicas de mensagem de erro, e códigos de erro de resposta adicionais podem ser encontrados on-line, por exemplo https://restfulapi.net/http-status-codes/ é uma boa localização.

Se houver um código de erro inesperado, entre em contato com o Suporte Dell apropriadamente para 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 NTP do VxRail por meio da API REST. Essa capacidade está disponível no roteiro do VxRail (versão exata a ser confirmada posteriormente) no plug-in da interface do usuário do VxRail.

Este artigo fornece orientações e exemplos dessa atividade para clientes com menos experiência no aproveitamento da API REST do VxRail.

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