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

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

Щоб отримати повну документацію для розробників інтерфейсу прикладного програмування (API) VxRail REST та інших продуктів Dell, перейдіть до API розробників Dell. Щоб швидко знайти API для VxRail, відфільтруйте «Гіперконвергентна інфраструктура».
   
Конкретну документацію для запиту або оновлення DNS можна знайти в розділі "Інформація про систему" - Отримати та встановити DNS:  
Ця документація може бути використана для створення власних команд curl або інтеграції в програму, таку як "postman", або інші програми для більш досвідчених користувачів.
 

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

Кращим способом (рекомендованим для людей, менш знайомих з REST API) для використання VxRail API є використання рідного клієнта VxRail Manager API.
Починаючи з релізу VxRail 7.0.350, ми перейшли на новий інтерфейс на основі Spotlight з більшими можливостями.
Щоб отримати доступ до рідного API-клієнта, введіть VxRail Manager FQDN/IP у своєму браузері.

< 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:
     

Запит поточної конфігурації DNS кластера VxRail

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

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

• Клієнт API автентифікується, і якщо ми отримуємо відповідь 200 OK, повертаємо запитувану інформацію, де наш поточний IP DNS-сервера 172.168.10.253, а VxRail Manager не налаштований як «Внутрішній DNS», що означає, що ми використовуємо DNS-сервери, надані зовнішнім клієнтом:

Оновлення інформації про DNS-IP-сервер кластера VxRail

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

• Пряма URL-адреса буде https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post однак вони можуть змінюватися в різних версіях, тому краще орієнтуватися в інтерфейсі користувача.
• У розділі «Автентифікація» введіть облікові дані автентифікації VxRail vCenter SSO, які часто є administrator@vsphere.local, але можуть відрізнятися залежно від конфігурації вашого домену.
• Для оновлення DNS-сервера відредагуйте розділ «Тіло» в трьох областях:
  • Розділ "components" є необов'язковим, а "ALL" є типовим. Якщо встановлено ALL, замінюються всі DNS-сервери в кластері, включаючи менеджер VxRail, vCenter і ESXi. Якщо встановлено "VXM", буде замінено лише DNS-сервер для VxRail Manager, що буде обмеженим випадком використання, оскільки ми рекомендуємо підтримувати узгодженість усіх конфігурацій компонентів. Зверніть увагу, що значення "VXM" підтримується ЛИШЕ у VCF у середовищі VxRail. 
  • У розділі "vCenter" ми повинні передати ім'я користувача та пароль SSO адміністратора, зазвичай це та сама інформація, що й у розділі "Auth", але може бути наданий інший обліковий запис SSO рівня адміністратора.
  • "сервери", у наведеному нижче прикладі ми встановлюємо DNS на IP 172.168.10.253  
    • Зверніть увагу, що при додаванні декількох серверів IP-адреси повинні бути розділені комами: "172.168.10.253,10.8.8."
• Натисніть кнопку «Надіслати запит», щоб виконати запит POST:

 

• Запит може зайняти мінімум залежно від кількості хостів ESXi у кластері, хоча коли запит завершується успішно, він повертає код відповіді 200 OK.

Якщо є неочікувані коди відповідей.

У нездоровій системі або, можливо, до нового DNS-сервера неможливо дістатися з хостів ESXi тощо. Клієнт API надає деякі основні вказівки щодо повідомлень про помилки, а додаткові коди помилок відповіді можна знайти в Інтернеті, наприклад, https://restfulapi.net/http-status-codes/ є хорошим місцем.
У разі виникнення будь-яких неочікуваних кодів помилок зверніться до служби підтримки Dell для додаткового усунення несправностей.
 

У ранніх випусках VxRail 8.0 процедури Solve Online стосуються оновлення налаштувань IP VxRail DNS через REST API. Можливість буде додана до плагіна VxRail UI.
У цій статті наведено вказівки та приклади цієї активності для клієнтів, які мають менший досвід використання VxRail REST API.

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