데이터센터 & AI/VAST Storage

VAST Fundementals(101) - VAST API

의그 2026. 8. 2. 19:48

1. VAST는 API-first 구조

VAST는 API-first architecture로 설계되어 있어.

즉, 클러스터의 관리 기능이 먼저 REST API 형태로 제공되고, VMS GUI와 CLI도 내부적으로 동일한 핵심 관리 기능을 사용한다고 이해하면 돼.

VMS GUI ─┐
CLI     ─┼─→ VAST 관리 기능/API ─→ VAST Cluster
REST API ┘
 

따라서 다음 세 가지 방식으로 같은 종류의 작업을 수행할 수 있어.

  • VMS GUI: 사람이 웹 화면에서 조작
  • CLI: 터미널에서 명령어로 조작
  • REST API: 스크립트나 외부 시스템에서 프로그램 방식으로 조작

예를 들어 View 생성, 사용자 관리, Quota 설정, 정책 구성 등의 기능을 GUI에서 수동으로 하거나 API로 자동화할 수 있다는 뜻이야.

2. VAST RESTful API란?

VAST RESTful API는 프로그램이나 스크립트가 HTTP 요청을 통해 VAST 클러스터를 조회하고 관리할 수 있도록 제공되는 인터페이스야.

일반적인 REST API 방식은 다음과 같아.

  • GET: 정보 조회
  • POST: 새 리소스 생성
  • PATCH 또는 PUT: 기존 설정 수정
  • DELETE: 리소스 삭제

예를 들면 개념적으로 다음과 같은 작업이 가능해.

GET    → View 목록 조회
POST   → 새로운 View 생성
PATCH  → Quota 값 변경
DELETE → 불필요한 정책 삭제
 

API를 사용하면 사람이 VMS GUI에서 반복 클릭하지 않아도 프로그램이 같은 작업을 수행할 수 있어.

3. API를 사용하는 주요 목적

교육 자료에서는 API 활용 목적을 세 가지로 구분하고 있어.

① Streamlining Routine Tasks

반복적인 관리 작업 자동화

사용자 생성, Quota 할당, Policy 적용 같은 반복 작업을 스크립트로 자동화하는 것이야.

예를 들어 신규 사용자 100명에게 다음 작업이 필요하다고 해보자.

사용자 계정 생성
→ 역할 할당
→ Quota 설정
→ 접근 권한 적용
 

GUI에서는 100번 반복해야 하지만, API 스크립트로는 사용자 목록을 읽어 일괄 처리할 수 있어.

장점

  • 반복 작업 시간 절감
  • 입력 실수 감소
  • 사용자마다 동일한 정책 적용
  • 규모가 커져도 쉽게 관리

예시

조직에서 모든 AI 연구원에게 다음 기준을 적용한다고 가정할 수 있어.

Role: AI-Researcher
Quota: 10 TB
Permission: AI Dataset Read/Write
 

API 스크립트는 신규 사용자 정보를 받아 이 설정을 자동으로 적용할 수 있어.

② Customizing Workflows

조직에 맞는 업무 흐름 구성

VAST를 Service Desk, 자동화 플랫폼, 모니터링 시스템 또는 사내 포털과 연동하는 용도야.

예를 들어 개발자가 사내 셀프서비스 포털에서 스토리지를 요청하는 상황을 생각해 보면 돼.

개발자가 포털에서 스토리지 요청
→ 관리자 승인
→ 자동화 시스템이 VAST API 호출
→ View 또는 스토리지 리소스 생성
→ Quota와 권한 적용
→ 요청자에게 결과 전달
 

이 방식에서는 개발자가 VMS에 직접 접속할 필요가 없어.

연동 가능한 시스템 예

  • ServiceNow 같은 ITSM
  • Ansible 등의 자동화 도구
  • 사내 셀프서비스 포털
  • Kubernetes 또는 VM 프로비저닝 시스템
  • 모니터링·알림 시스템

즉, VAST를 기존 업무 프로세스 안에 넣을 수 있다는 의미야.

③ Enhancing Reporting and Analytics

맞춤형 보고서 및 분석

VMS에도 기본적인 Capacity와 Analytics 기능이 있지만, API를 사용하면 필요한 데이터를 직접 수집해 조직 전용 보고서를 만들 수 있어.

수집할 수 있는 데이터의 예는 다음과 같아.

  • 클러스터 용량 사용량
  • Tenant·부서·프로젝트별 사용량
  • Bandwidth, IOPS, Latency 같은 성능 지표
  • 사용자 활동
  • 워크로드별 성능 추세
  • 비용 배분용 데이터

예시: 부서별 스토리지 비용 계산

VAST API로 부서별 사용 용량 수집
→ 회사의 TB당 비용 계산식 적용
→ 부서별 비용 보고서 생성
→ 매월 자동 배포
 

예를 들어:

부서사용량TB당 단가산정 비용
AI 연구팀 200 TB 10만 원 2,000만 원
개발팀 80 TB 10만 원 800만 원
백업팀 120 TB 10만 원 1,200만 원

이런 데이터를 BI 도구와 결합해 전사 리포트에 포함할 수도 있어.

4. API 사용의 핵심 장점

정리하면 다음과 같아.

장점설명
자동화 반복적인 사용자·Quota·Policy 작업 자동 처리
일관성 동일한 설정을 누락 없이 반복 적용
오류 감소 수동 입력이나 클릭 과정에서 발생하는 실수 방지
확장성 사용자나 Tenant 수가 늘어도 대량 처리 가능
시스템 통합 ITSM, 포털, 모니터링, 자동화 시스템과 연동
맞춤 분석 필요한 지표를 수집해 전용 보고서 생성

5. VAST API Documentation

API를 사용하려면 각 API Endpoint의 사용법을 알아야 해.

API 문서에는 보통 다음 정보가 들어 있어.

  • Endpoint URL
  • HTTP Method
  • 필요한 Parameter
  • Request Body 형식
  • 인증 방법
  • Response 형식
  • 상태 코드
  • 실행 예시

예를 들어 개념적으로 다음처럼 표시될 수 있어.

GET /api/views/
 

의미:

클러스터에 생성된 View 목록을 조회한다.

또는:

POST /api/views/
 

의미:

새로운 View를 생성한다.

정확한 URL과 Payload 구조는 설치된 VAST 버전의 Swagger 문서에서 확인해야 해.

6. Swagger UI란?

VAST는 API 문서를 보여주기 위해 Swagger UI를 사용해.

Swagger UI는 브라우저에서 다음 작업을 할 수 있는 인터랙티브 API 문서야.

  • 사용 가능한 API Endpoint 검색
  • 각 Endpoint의 목적 확인
  • 필수 및 선택 Parameter 확인
  • Request Body 형식 확인
  • Response 예제 확인
  • 브라우저에서 API 호출 시험

즉, 단순 설명서가 아니라 실제 API를 탐색하고 테스트할 수 있는 화면이야.

7. API 문서 접속 방법

현재 사용하는 VMS URL 뒤에 /docs/를 붙이면 돼.

https://<VMS_VIP>/docs/
 

예를 들어 VMS 관리 VIP가 다음과 같다면:

https://192.168.100.50
 

API 문서는:

https://192.168.100.50/docs/
 

로 접속해.

여기서 <VMS_VIP>는 클러스터 설치 시 지정한 Management VIP야.

즉:

  • VMS GUI 접속: https://<VMS_VIP>/
  • Swagger API 문서: https://<VMS_VIP>/docs/

이 내용은 앞에서 질문한 **“VMS 웹페이지 IP가 어느 IP인가?”**에 대한 정확한 연결이기도 해. VMS 접속에 사용하는 주소는 설치 시 지정된 **관리용 VIP(Management VIP)**이고, 그 주소 뒤에 /docs/를 붙이면 API 문서가 열려.

8. 실제 활용 흐름

API 자동화는 일반적으로 다음 순서로 진행돼.

1. https://<VMS_VIP>/docs/ 접속
2. 필요한 API Endpoint 검색
3. Request Method와 Parameter 확인
4. 인증 방법 확인
5. Swagger에서 시험 호출
6. curl 또는 Python으로 스크립트 작성
7. 오류 처리와 결과 검증 추가
8. 운영 자동화 시스템에 연동
 

개념적인 curl 호출 형태는 다음과 같아.

 
curl -k \
  -H "Authorization: Bearer <TOKEN>" \
  "https://<VMS_VIP>/api/<endpoint>/"
 

다만 인증 Header와 실제 Endpoint는 VAST 버전 및 인증 구성에 따라 다를 수 있으므로 반드시 해당 클러스터의 /docs/를 기준으로 작성해야 해.

핵심 정리

VAST는 API-first 구조이므로 GUI, CLI, REST API가 같은 핵심 관리 기능을 제공한다.

REST API를 사용하면:

  1. 반복적인 사용자·Quota·Policy 관리 작업을 자동화하고
  2. ServiceNow나 사내 포털 같은 외부 시스템과 연동하며
  3. 용량·성능·사용자 활동 데이터를 수집해 맞춤형 분석 보고서를 만들 수 있어.

그리고 API 문서는 다음 주소에서 확인해.

https://<VMS Management VIP>/docs/
저작자표시 (새창열림)

'데이터센터 & AI > VAST Storage' 카테고리의 다른 글

VAST Fundementals(101) - Snapshots & Replication  (0) 2026.08.02
VAST Fundementals(101) - Security & User Management  (1) 2026.07.18
VAST Fundementals(101) - VMS(Vast Management System)  (0) 2026.07.18
VAST Fundementals(101) - Introduction  (0) 2026.07.18

'데이터센터 & AI/VAST Storage'의 다른글

  • 현재글VAST Fundementals(101) - VAST API

관련글

티스토리툴바