NodeManager REST APIs

NodeManager REST APIs

이 문서는 NodeManager에서 제공하는 웹 서비스 REST API를 설명합니다. NodeManager REST API는 노드에서 실행 중인 컨테이너, 애플리케이션, 노드 상태 등의 정보에 접근할 수 있게 해줍니다. 모든 REST API는 HTTP GET을 사용해 호출하며, JSON/XML 형식으로 응답을 받을 수 있습니다.

출처: 문서

본문

URI 형식

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

  http://{NM http address}/ws/v1/node/{resourcepath}

여기서 {NM http address}는 NodeManager의 웹 주소(기본 포트 8042)이며, {resourcepath}는 접근할 리소스를 정의하는 경로입니다. 지원되는 리소스 경로는 다음과 같습니다.

| 리소스 경로 | 설명 | | /ws/v1/node/info | NodeManager에 대한 일반 정보(버전, 리소스 등)를 반환한다. | /ws/v1/node/apps | 이 노드에서 실행 중인 모든 애플리케이션 목록을 반환한다. | /ws/v1/node/apps/{appid} | 지정된 애플리케이션에 대한 정보를 반환한다. | /ws/v1/node/containers | 이 노드에서 실행 중인 모든 컨테이너 목록을 반환한다. | /ws/v1/node/containers/{containerid} | 지정된 컨테이너에 대한 정보를 반환한다.

참고: 2.x 이후의 YARN 릴리스에서는 애플리케이션/컨테이너 정보 REST API들의 형식과 필드가 확장됨에 따라, 항상 해당 릴리스의 공식 문서와 일치하도록 합니다. 위 필드명은 대표적인 예시입니다.

응답 형식

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

예시

curl "http://localhost:8042/ws/v1/node/info"

위 요청은 NodeManager의 정보를 JSON으로 반환합니다.

더 알아보기 (Learn more)