ResourceManager REST API

이 문서는 ResourceManager(RM)에서 제공하는 웹 서비스 REST API를 설명합니다. ResourceManager REST API는 클러스터, 노드, 애플리케이션, 큐, 리소스 예약 등의 정보에 접근할 수 있게 해줍니다. 모든 REST API는 HTTP GET을 사용하며, JSON/XML 형식으로 응답합니다.

출처: 문서

본문

URI 형식

ResourceManager REST API의 URI 형식은 다음과 같습니다.

  http://{RM http address}/ws/v1/cluster/{resourcepath}

{RM http address}는 ResourceManager의 웹 주소(기본 포트 8088)입니다.

클러스터 정보

GET /ws/v1/cluster/info

ResourceManager에 대한 일반 정보(버전, 상태, 남은 리소스, 사용 중인 리소스 등)를 반환합니다.

클러스터 통계

GET /ws/v1/cluster/metrics

클러스터의 통계(제출된/실행 중인/완료된 애플리케이션 수, 사용 가능한 메모리/코어 등)를 반환합니다.

스케줄러 정보

GET /ws/v1/cluster/scheduler

현재 사용 중인 스케줄러의 정보와 큐 상태(용량, 사용량, 대기 애플리케이션 등)를 반환합니다.

노드

GET /ws/v1/cluster/nodes

클러스터의 모든 노드 목록을 반환합니다.

GET /ws/v1/cluster/nodes/{nodeid}

지정된 노드의 자세한 정보를 반환합니다.

애플리케이션

GET /ws/v1/cluster/apps

클러스터의 애플리케이션 목록을 반환합니다. 상태, 사용자, 큐 등으로 필터링할 수 있습니다.

GET /ws/v1/cluster/apps/{appid}

지정된 애플리케이션의 정보를 반환합니다.

GET /ws/v1/cluster/apps/{appid}/appattempts

지정된 애플리케이션의 시도(attempt) 목록을 반환합니다.

GET /ws/v1/cluster/apps/{appid}/containers

지정된 애플리케이션 시도의 컨테이너 정보를 반환합니다. (애플리케이션 시도 id가 필요)

큐

GET /ws/v1/cluster/scheduler 로 큐 정보를 조회하거나, 큐 관련 상태를 확인합니다.

응답 형식

기본 응답 형식은 JSON이며, Accept: application/xml 헤더로 XML을 요청할 수 있습니다. 보안이 활성화된 클러스터에서는 인증 후 접근할 수 있습니다.

예시

curl "http://rmhost:8088/ws/v1/cluster/apps"
curl "http://rmhost:8088/ws/v1/cluster/nodes"
curl "http://rmhost:8088/ws/v1/cluster/metrics"

더 알아보기 (Learn more)

원문: 문서