Cloud Hadoop 개요

Prev Next

Classic 환경에서 이용 가능합니다.

Cloud Hadoop은 Apache Hadoop, HBase, Spark, Hive, Presto 등의 오픈소스 기반 프레임워크를 사용자가 자유롭게 사용하여 빅데이터를 쉽고 빠르게 처리할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. Cloud Hadoop 서비스에서는 Hadoop 클러스터의 생성, 작업자노드 추가 및 리소스 조회 기능에 대한 API를 RESTful 형태로 제공합니다.

Cloud Hadoop 공통 설정

Cloud Hadoop API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://ncloud.apigw.gov-ntruss.com

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-timestamp Required 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
x-ncp-apigw-api-key Required 네이버 클라우드 플랫폼의 API Gateway 서비스에서 발급받은 API Key
x-ncp-iam-access-key Required 네이버 클라우드 플랫폼에서 발급받은 Access Key
x-ncp-apigw-signature-v2 Required 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명

응답

공통 응답 형식을 설명합니다.

응답 데이터 타입

공통 응답 데이터 타입을 설명합니다.

responseError
responseError는 API 호출 실패 시 실패에 대한 내용을 정의합니다. responseError에 대한 설명은 다음과 같습니다.

필드 타입 필수 여부 설명
returnCode String Required 오류 코드
returnMessage String Required 오류 메시지

responseError의 예시는 다음과 같습니다.

  • JSON
    {
    "error": {
        "returnCode": "string",
        "returnMessage": "string",
    }
}
  • XML
    <error>
    <returnCode>string</returnCode>
    <returnMessage>string</returnMessage>
</error>

응답 상태 코드

응답 상태 코드에 대한 설명은 다음과 같습니다.

HTTP 상태 코드 코드 메시지 설명
400 900 Required field is not specified. location : [파라미터 이름] 필수 파라미터 누락
  • 필수 파라미터 추가 후 재시도
500 908 workerNodeCount is invalid. workerNodeCount should be in [2, 12] 작업자노드 수 증감 범위 초과
  • 10개 이하의 변경 값으로 수정 후 재시도
500 929 Please try your call again later.\nTemporarily out of service.\nIf error continue, Please contact our customer service center. 일시적인 오류
  • 잠시 후 다시 시도하거나 문제가 지속될 경우에는 네이버 클라우드 플랫폼 포털의 고객 지원으로 문의
500 10713 No such item found. If the error persists,contact Customer Service. 클러스터 인스턴스 번호 입력 오류
  • 클러스터 인스턴스 번호 수정 후 재시도
참고

네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

Cloud Hadoop API

Cloud Hadoop 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.

API 설명
changeCloudHadoopNodeCount 클러스터 작업자노드 수 변경
createCloudHadoopInstance 클러스터 생성
deleteCloudHadoopInstance 클러스터 삭제
getCloudHadoopBucketList 사용 가능한 Object Storage 버킷 조회
getCloudHadoopImageProductList 사용 가능한 클러스터 이미지 조회
getCloudHadoopInstanceList 클러스터 목록 조회
getCloudHadoopProductList 사용 가능한 노드별 서버 타입 조회

Cloud Hadoop 연관 리소스

Cloud Hadoop API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.