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.

Instructions

戴尔开发人员公共文档

有关 VxRail REST API 和其他戴尔产品的开发人员文档,请访问 戴尔支持开发人员站点,筛选 超融合基础架构 以查找特定于 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 开始,将使用一个新界面,该界面具有基于 spotlight 的更强大功能。要访问本机 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 左侧面板中的 System Information 部分查询当前 NTP 配置:
  • 直接 URL 将为 https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_get 但是,这些可能会因版本而异,因此最好在 UI 中导航。
  • 输入 VxRail vCenter 单点登录 (SSO) 身份验证凭据,这些凭据通常是 administrator@vsphere.local 但可能会有所不同,具体取决于您的域配置。
  • 单击 Send Request 按钮以执行 GET 请求:
从 REST API 查询 NTP
  • API 客户端进行身份验证,如果它获得 200 OK 响应,则返回请求的信息,其中我们当前的 NTP 服务器实验室 IP 位于 172.168.10.45:
REST API 查询结果


更新 VxRail 群集 NTP IP 服务器信息

使用v1_system_ntp_post API(可在左侧面板的 System Information 部分下找到)更新当前 NTP 配置:
  • 直接 URL 将为 https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_ntp_post 但是,这些可能会因版本而异,因此最好在 UI 中导航。
  • 身份验证 部分中,输入 VxRail vCenter SSO 身份验证凭据,这些凭据通常是 administrator@vsphere.local 但可能会有所不同,具体取决于您的域配置。
  • 要更新 NTP 服务器,还要编辑三个区域中的 Body 部分:
    • Components部分是可选的,ALL是默认值。如果设置了 ALL,则替换群集中的所有 NTP 服务器。如果设置 了 VXM,则仅替换用于 VxRail Manager 的 NTP 服务器,这将是有限的应用场景,因为建议保持所有组件配置一致。 

提醒:值 VXM 仅在 VCF on VxRail 环境中受支持。
 
  • vCenter 部分中,您必须传递管理员 SSO 用户名和密码,这通常是与 Auth 部分中相同的信息,但可以提供不同的管理员级别 SSO 帐户。
  • servers 部分中,以下示例显示了将 NTP 设置为 IP 172.168.10.45
 
提醒:添加多个服务器时,IP 必须用逗号分隔,例如 172.168.10.45, 172.168.10.46
 
  • 单击 Send Request 按钮以执行 POST 请求:
使用 REST API SET 命令
REST API SET 结果


如果意外响应代码

在运行状况不佳的系统中,或者可能无法从 ESXi 主机访问新的 NTP 服务器等。API 客户端提供了一些基本的错误消息指南,其他响应错误代码也可以联机找到,例如 https://restfulapi.net/http-status-codes/ 地理位置很好。

如果出现任何意外错误代码,请相应地联系戴尔支持,以便进行其他故障处理。
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.