VxRail：如何使用 REST API 在 VxRail 8.0.x 和 7.0.x 版本變更 NTP 伺服器 IP

Summary: 如何運用 VxRail 應用程式發展介面 （API） 檢查和更新一個或多個已設定的 VxRail 網路時間通訊協定 （NTP） 伺服器 IP。

This article applies to This article does not apply to This article is not tied to any specific product. Not all product versions are identified in this article.
Check out other resources

Instructions

Dell 開發人員公開說明文件

VxRail REST API 和其他 Dell 產品的開發人員說明文件位於 Dell 支援開發人員網站， 超融合基礎架構 的篩選器可尋找 VxRail 的特定 API。

https://developer.dell.com/apis 主頁

如需查詢或更新 NTP 的特定說明文件，請參閱 系統資訊、取得和設定 NTP：

NTP 文件

本文件可用於建立自訂 curl 命令或整合到應用程式中，例如 postman 或其他適合更有經驗的使用者的應用程式。


VxRail 內嵌 API 用戶端 

使用 VxRail API 的偏好方式 （建議適用於不熟悉 REST 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
在此範例中，VxRail Manager IP 為 172.168.10.50 所以 URL 變成了 https://172.168.10.50/rest/vxm/api-doc.html:
VxRail Manager REST API


查詢目前的 VxRail 叢集 NTP 組態

使用 v1_sytem_ntp_get API 系統資訊區段，以查詢目前的 NTP 組態：
  • 直接網址將是 https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_get 但是，這些可能會因版本而異，因此最好在UI中導航。
  • 輸入 VxRail vCenter 單一登入 （SSO） 驗證登入資料，通常是 administrator@vsphere.local 但可能會有所不同，具體取決於您的域配置。
  • 按 一下傳送要求 按鈕以執行 GET 求：
從 REST API 查詢 NTP
  • API 用戶端進行身份驗證，如果收到 200 OK 回應，則返回我們當前 NTP 伺服器實驗室 IP 所在的請求資訊 172.168.10.45:
REST API 查詢結果


正在更新 VxRail 叢集 NTP IP 伺服器資訊

請使用在左側面板的系統 資訊 區段下找到的 v1_system_ntp_post API，以更新目前的 NTP 組態：
  • 直接網址將是 https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_post 但是，這些可能會因版本而異，因此最好在UI中導航。
  • 在 驗證區段 中，輸入 VxRail vCenter SSO 認證登入資料，通常是 administrator@vsphere.local 但可能會有所不同，具體取決於您的域配置。
  • 若要更新 NTP 伺服器，也請編輯三個區域 的「正文 」區段：
    • 元件區段為選用，預設為「全部」。若已設定 ALL，則會更換叢集中的所有 NTP 伺服器。如果已設定 VXM，則只會更換 VxRail Manager 的 NTP 伺服器，這是一個有限的使用案例，因為建議讓所有元件組態保持一致。 

注意：只有在 VxRail 環境上的 VCF 中才支援 VXM 值。
 
  • 在 vCenter 區段中，您必須傳遞系統管理員 SSO 使用者名稱和密碼，這通常與驗證區段中的資訊相同，但可以提供不同的管理員層級 SSO 帳戶。
  • 在 「伺服器」區段中，以下範例顯示如何將 NTP 設為 IP 172.168.10.45
 
注意：新增多個伺服器時，IP 必須以逗號分隔，例如： 172.168.10.45, 172.168.10.46
 
  • 按一下 傳送要求 按鈕以執行 POST 要求：
使用 REST API SET 命令
REST API 集結果


如果出現未預期的回應代碼

在不健全的系統中，或可能無法從 ESXi 主機連接新的 NTP 伺服器等。API 用戶端提供了一些基本的錯誤消息指導，並且可以在線找到其他回應錯誤代碼，例如 https://restfulapi.net/http-status-codes/ 是一個不錯的位置。

如果出現任何未預期的錯誤代碼，請聯絡 Dell 支援以進行額外的故障診斷。
REST API 錯誤

Additional Information

在早期的 VxRail 8.0 版本中，Solve Online 程序參考透過 REST API 更新 VxRail NTP IP 設定，而在 VxRail 藍圖 （確切版本待稍後確認） 上可於 VxRail UI 附掛程式中使用此功能。

本文為利用 VxRail REST API 經驗較少的客戶提供此活動的指南和範例。

本文中的IP資訊來自臨時虛擬隔離實驗室，不包含客戶或機密IP資訊。

Affected Products

VxRail Appliance Family
Article Properties
Article Number: 000215966
Article Type: How To
Last Modified: 28 Mar 2025
Version:  8
Find answers to your questions from other Dell users
Support Services
Check if your device is covered by Support Services.