VxRail. Изменение IP-адреса сервера NTP в выпусках VxRail 8.0.x и 7.0.x с помощью REST API

Общедоступная документация разработчиков Dell

Документацию для разработчиков для VxRail REST API и других продуктов Dell можно найти на сайте поддержки Dell для разработчиков, отфильтруйте гиперконвергентную инфраструктуру , чтобы найти API для VxRail.

Конкретную документацию по запросу или обновлению NTP можно найти в разделах «Сведения о системе», «Get» и «Set NTP»:

Эта документация может быть использована для создания curl команды или интегрировать в приложение, например, postman или другие приложения для более опытных пользователей.

Клиент встроенного API VxRail 

Предпочтительный способ (рекомендуется для людей, менее знакомых с REST API) для использования API VxRail — использовать собственный клиент API VxRail Manager.

Начиная с версии 7.0.350 кода VxRail используется новый интерфейс с расширенными возможностями на основе Spotlight. Чтобы получить доступ к собственному клиенту API, перейдите по следующему URL-адресу, заменив <VxM> на полное доменное имя/IP-адрес VxRail Manager в предпочитаемом браузере (специальный клиент API не требуется):

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

В данном примере IP-адрес VxRail Manager выглядит следующим образом: 172.168.10.50 таким образом, URL-адрес становится https://172.168.10.50/rest/vxm/api-doc.html:

Запрос текущей конфигурации NTP кластера VxRail

Используйте v1_sytem_ntp_get API Раздел «System Information» на левой панели для запроса текущей конфигурации NTP:

• Прямой URL-адрес будет выглядеть следующим образом: https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_get однако они могут отличаться в разных версиях, поэтому лучше всего перемещаться в пользовательском интерфейсе.
• Введите учетные данные аутентификации VxRail vCenter Single Sign-On (SSO), которые часто являются administrator@vsphere.local но может отличаться в зависимости от конфигурации домена.
• Нажмите кнопку Отправить запрос , чтобы выполнить GET просьба:

• Клиент API выполняет аутентификацию и, если получает ответ 200 OK, возвращает запрошенную информацию, где указан текущий IP-адрес лаборатории NTP-сервера. 172.168.10.45:

Обновление информации об IP-сервере NTP кластера VxRail

Для обновления текущей конфигурации NTP используйте v1_system_ntp_post API, который можно найти в разделе «System Information » на левой панели:

• Прямой URL-адрес будет выглядеть следующим образом: https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_post однако они могут отличаться в разных версиях, поэтому лучше всего перемещаться в пользовательском интерфейсе.
• В разделе « Auth » введите учетные данные аутентификации единого входа VxRail vCenter, которые часто представляют собой administrator@vsphere.local но может отличаться в зависимости от конфигурации домена.
• Для обновления сервера NTP также отредактируйте раздел «Текст » в трех областях:
  • Раздел «Components» является необязательным, и по умолчанию используется значение ALL. Если задан параметр ALL, заменяются все NTP-серверы в кластере. Если установлен VXM, заменяется только сервер NTP для VxRail Manager, что является ограниченным вариантом использования, поскольку рекомендуется поддерживать согласованность всех конфигураций компонентов. 

• В разделе vCenter необходимо передать имя пользователя и пароль единого входа администратора. Обычно это те же сведения, что и в разделе Auth, но можно указать другую учетную запись единого входа с уровнем администратора.
• В разделе «Серверы» в приведенном ниже примере показана установка для NTP значения IP 172.168.10.45

 

В случае непредвиденных кодов ответа

В неисправной системе или, возможно, новый сервер NTP недоступен с хостов ESXi и т. д. Клиент API предоставляет некоторые базовые инструкции по сообщениям об ошибках, а дополнительные коды ошибок можно найти, например, в Интернете https://restfulapi.net/http-status-codes/ хорошее месторасположение.

При наличии каких-либо непредвиденных кодов ошибок обратитесь в службу поддержки Dell для получения дополнительных инструкций по поиску и устранению неисправностей.

В ранних выпусках VxRail 8.0 процедуры Solve Online ссылаются на обновление IP-параметров VxRail NTP с помощью REST API. Эта возможность предусмотрена в плане развития VxRail (точный выпуск будет подтвержден позже) в подключаемом модуле пользовательского интерфейса VxRail.

В этой статье приведены рекомендации и примеры этого действия для заказчиков с меньшим опытом использования REST API VxRail.

Информация об IP-адресе, представленная в этой статье, получена из временной виртуальной изолированной лаборатории и не содержит конфиденциальных IP-адресов или сведений о заказчиках.