VxRail: VxRail 8.0.x 및 7.0.x 릴리스에서 REST API를 사용하여 NTP 서버 IP를 변경하는 방법

Summary: VxRail API(Application Programming Interface)를 활용하여 하나 이상의 구성된 VxRail NTP(Network Time Protocol) 서버 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 쿼리 또는 업데이트에 대한 특정 문서는 System Information, Get 및 Set 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(Single Sign-On) 인증 자격 증명을 입력합니다. administrator@vsphere.local 그러나 도메인 구성에 따라 다를 수 있습니다.
  • Send Request 버튼을 클릭하여 GET 요청:
REST API에서 NTP 쿼리
  • API 클라이언트가 인증하고 200 OK 응답을 받으면 현재 NTP 서버 랩 IP가 있는 요청된 정보를 반환합니다. 172.168.10.45:
REST API 쿼리 결과


VxRail 클러스터 NTP IP 서버 정보 업데이트

왼쪽 패널의 System Information 섹션에서 찾을 수 있는 v1_system_ntp_post API를 사용하여 현재 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 서버를 업데이트하려면 본문 섹션의 세 영역도 편집합니다.
    • 구성 요소 섹션은 선택 사항이며 ALL이 기본값입니다. ALL을 설정하면 클러스터의 모든 NTP 서버가 교체됩니다. VXM이 설정된 경우 VxRail Manager용 NTP 서버만 대체됩니다. 이는 모든 구성 요소 구성을 일관되게 유지하는 것이 좋으므로 제한된 사용 사례입니다. 

참고: VXM 값은 VxRail 기반 VCF 환경에서만 지원됩니다.
 
  • vCenter 섹션에서 관리자 SSO 사용자 이름과 비밀번호를 전달해야 합니다. 일반적으로 이 정보는 인증 섹션과 동일하지만 다른 관리자 수준의 SSO 계정을 제공할 수 있습니다.
  • 서버 섹션에서 아래 예는 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/ 좋은 위치입니다.

예기치 않은 오류 코드가 있는 경우 Dell 지원 부서에 문의하여 추가 문제 해결을 요청합니다.
REST API 오류

Additional Information

초기 VxRail 8.0 릴리스에서 SolVe Online 절차는 REST API를 통한 VxRail NTP IP 설정 업데이트를 참조하며, VxRail UI 플러그인에서 이 기능을 사용할 수 있도록 하는 것이 VxRail 로드맵(정확한 릴리스는 추후 확정)에 포함되어 있습니다.

이 문서에서는 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.