VxRail: Як змінити IP DNS-сервера в релізах VxRail 8.0.x і 7.0.x за допомогою rest 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 однак вони можуть змінюватися в різних версіях, тому краще орієнтуватися в інтерфейсі користувача.
• У розділі "Auth" введіть облікові дані автентифікації 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.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-адресу клієнта/конфіденційної особи.