VxRail: Як змінити IP NTP сервера в релізах VxRail 8.0.x і 7.0.x за допомогою REST API

Публічна документація розробника Dell

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

Спеціальну документацію щодо запиту або оновлення NTP можна знайти в розділах «Відомості про систему», «Отримати» та «Встановити NTP»:

Ця документація може бути використана для створення користувацьких curl або інтегрувати в таку програму, як postman або інші додатки для більш досвідчених користувачів.

Вбудований API клієнт VxRail 

Кращим способом (рекомендованим для людей, менш знайомих з REST API) для використання VxRail API є використання рідного клієнта VxRail Manager API.

Починаючи з версії коду VxRail 7.0.350, використовується новий інтерфейс з більшими можливостями на основі прожектора. Щоб отримати доступ до рідного API-клієнта, перейдіть за наступною URL-адресою, замінивши <VxM> на VxRail Manager FQDN/IP з обраним браузером (не потрібен спеціальний клієнт 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 Розділ Інформація про систему на лівій панелі для запиту поточної конфігурації 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

Використовуйте API v1_system_ntp_post, який можна знайти в розділі «Інформація про систему » на лівій панелі, щоб оновити поточну конфігурацію NTP:

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

• У розділі vCenter ви повинні передати ім'я користувача та пароль SSO адміністратора, зазвичай це та сама інформація, що й у розділі Auth, але може бути наданий інший обліковий запис SSO рівня адміністратора.
• У розділі серверів у наведеному нижче прикладі показано налаштування 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 UI.

Ця стаття містить вказівки та приклади цієї діяльності для клієнтів із меншим досвідом використання VxRail REST API.

Інформація про інтелектуальну власність, наведена в цій статті, отримана в тимчасовій віртуальній ізольованій лабораторії, не містить жодної інформації про клієнтів або конфіденційну IP-адресу.