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

Dell 개발자를 위한 공개 설명서

VxRail REST API(Application Programming Interface) 및 기타 Dell 제품에 대한 전체 개발자 문서를 보려면 Dell Developer API로 이동하십시오. VxRail 전용 API를 빠르게 찾으려면 "하이퍼 컨버지드 인프라스트럭처"로 필터링합니다.
   
DNS 쿼리 또는 업데이트에 대한 특정 문서는 "시스템 정보" - DNS 가져오기 및 설정:  
이 문서는 사용자 정의 curl 명령을 작성하거나 "postman"과 같은 응용 프로그램 또는 숙련 된 사용자를 위한 기타 응용 프로그램에 통합하는 데 사용할 수 있습니다.
 

VxRail 내장 API 클라이언트 

VxRail API를 사용하는 기본 방법(REST API에 익숙하지 않은 사용자에게 권장)은 기본 VxRail Manager API 클라이언트를 활용하는 것입니다.
VxRail 릴리스 7.0.350에서 더 많은 기능을 갖춘 Spotlight 기반의 새로운 인터페이스로 마이그레이션했습니다.
브라우저에 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 클러스터 DNS 구성 쿼리

현재 DNS 구성을 쿼리하려면 왼쪽 패널의 "System Information" 섹션에 있는 v1_sytem_dns_get API를 사용합니다.

• 직접 URL이 https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_get 되지만 버전 간에 변경될 수 있으므로 UI에서 탐색하는 것이 가장 좋습니다.
• VxRail vCenter SSO(Single Sign-On) 인증 자격 증명을 입력합니다. 이 자격 증명은 대개 administrator@vsphere.local이지만 도메인 구성에 따라 다를 수 있습니다.
• Send Request 버튼을 클릭하여 GET 요청을 수행합니다.

• API 클라이언트가 인증하고 200 OK 응답을 받으면 현재 DNS 서버 랩 IP가 172.168.10.253이고 VxRail Manager가 "내부 DNS"로 구성되지 않은 요청된 정보를 반환합니다. 즉, 외부 고객이 제공한 DNS 서버를 사용하고 있습니다.

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

현재 DNS 구성을 업데이트하려면 왼쪽 패널의 "System Information" 섹션에 있는 v1_system_dns_post API를 사용합니다.

• 직접 URL이 https://172.168.10.50/rest/vxm/api-doc.html#/operations/v1_system_dns_post 되지만 버전에 따라 변경될 수 있으므로 UI에서 탐색하는 것이 가장 좋습니다.
• "Auth" 섹션에서 VxRail vCenter SSO 인증 자격 증명을 입력합니다. 이 자격 증명은 대개 administrator@vsphere.local이지만 도메인 구성에 따라 다를 수 있습니다.
• DNS 서버를 업데이트하려면 다음 세 영역에서 "본문" 섹션을 편집합니다.
  • "components" 섹션은 선택 사항이며 "ALL"이 기본값입니다. ALL을 설정하면 VxRail Manager, vCenter 및 ESXi를 포함하여 클러스터의 모든 DNS 서버가 대체됩니다. "VXM"이 설정된 경우 VxRail Manager의 DNS 서버만 대체됩니다. 이는 모든 구성 요소 구성을 일관되게 유지하는 것이 좋으므로 제한된 사용 사례입니다. "VXM" 값은 VxRail 기반 VCF 환경에서만 지원됩니다. 
  • "vCenter" 섹션에서 관리자 SSO 사용자 이름과 암호를 전달해야 합니다. 일반적으로 이 정보는 "Auth" 섹션과 동일하지만 다른 관리자 수준의 SSO 계정을 제공할 수 있습니다.
  • "servers" 섹션에서 아래 예에서는 DNS를 IP 172.168.10.253으로 설정합니다.  
    • 여러 서버를 추가할 때 IP는 쉼표로 구분된 "172.168.10.253,10.8.8.8"이어야 합니다.
• Send Request 버튼을 클릭하여 POST 요청을 수행합니다.

 

• 요청 시 클러스터의 ESXi 호스트 수에 따라 시간이 약간 걸릴 수 있지만 요청이 성공적으로 완료되면 200 OK 응답 코드가 반환됩니다.

예기치 않은 응답 코드가 있는 경우

비정상 시스템이거나 ESXi 호스트 등에서 새 DNS 서버에 연결할 수 없습니다. API 클라이언트는 몇 가지 기본 오류 메시지 지침을 제공하며, 추가 응답 오류 코드는 온라인에서 찾을 수 있습니다(예: https://restfulapi.net/http-status-codes/ 좋은 위치).
예기치 않은 오류 코드가 있는 경우 추가 문제 해결을 위해 Dell 지원 부서에 문의하십시오.
 

이전 VxRail 8.0 릴리스에서 SolVe Online 절차는 REST API를 통한 VxRail DNS IP 설정 업데이트를 참조합니다. 이 기능은 VxRail UI 플러그인에 추가됩니다.
이 문서에서는 VxRail REST API를 활용한 경험이 거의 없는 고객을 위해 이 활동에 대한 지침과 예시를 제공합니다.

이 문서의 IP 정보는 임시 가상 격리 랩에서 가져온 것이며 고객/기밀 IP 정보를 포함하지 않습니다.