개요
Proxmox는 HTTP 메서드 기반으로 통신하는 REST API 방식입니다. API를 통해 가상 머신(VM), 클러스터 노드, 네트워크, 스토리지 등의 관리를 자동화할 수 있습니다.
API 설명 URL
API 규격
특별한 설정이나 설치 없이 Proxmox VE를 설치하면 API가 활성화되어 있습니다. EndPoint 주소는 URL 또는 IP:8006이므로 8006번 포트의 활성화 여부를 확인해야 합니다.
| ※ 참고자료 |
|---|
| https://www.youtube.com/watch?v=1AGvfKaGp3c https://www.youtube.com/watch?v=8DCwnauqg3E https://www.youtube.com/watch?v=xTpaCAq1ruM |
테스트 환경
| Cluster Node | Proxmox Version |
|---|---|
| 2 | pve-manager/8.2.2/9355359cd7afbae4 (running kernel: 6.8.4-2-pve) |
Proxmox Version 확인 명령어
# pveversion
===
pve-manager/8.2.2/9355359cd7afbae4 (running kernel: 6.8.4-2-pve)
===pve-manager/8.2.2 : Proxmox의 주요 관리 소프트웨어(관리 인터페이스 및 관련 서비스) 버전으로 실질적인 Proxmox 버전
9355359cd7afbae4 : 소프트웨어의 Git 커밋 해시
running kernel: 6.8.4-2-pve : 실행 중인 리눅스 커널 버전으로 Proxmox 커스터마이징 버전의 커널
API 통신 방법
API 통신을 이용하는 방법에는 크게 세 가지가 있습니다. 대부분 Postman WEB(https://web.postman.co/) 7.43.0 Free Ver을 이용하여 테스트하였습니다.
① bash 터미널에서 curl로 호출
② Proxmox 서버 내부에서 pvesh 명령어 이용
③ Postman Clinet Tool을 이용하여 직접 HTTP 메서드 전달
Raiju Hantu Goryo Obake