Cloud Hadoop 개요

Prev Next

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

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

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

API URL

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

https://fin-ncloud.apigw.fin-ntruss.com
HTTP

요청 헤더

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

필드 필수 여부 설명
x-ncp-apigw-timestamp Required 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
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
    {
        "responseError":{
            "returnCode":"stirng",
            "returnMessage":"stirng"
        }
    }
    
    JSON
  • XML
    <responseError>
        <returnCode>stirng</returnCode>
        <returnMessage>stirng</returnMessage>
    </responseError>
    
    XML

응답 상태 코드

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

HTTP 상태 코드 코드 메시지 설명
400 900 Required field is not specified. location : [파라미터 이름] 필수 파라미터 누락
  • 필수 파라미터 추가 후 재시도
400 5000009 An error occurred while processing the internal system. 내부 시스템 오류 발생
  • 네이버 클라우드 플랫폼 포털의 고객 지원으로 문의
400 5000020 Processing of [View or Change]/[Sub Account 액션 이름] SubAccount authentication failed. 서브 계정에 권한 없음
  • 계정에 권한 추가 후 재시도
400 5001005 The cluster is in another operation. Please try again after the existing work is completed. 이미 동작 중인 클러스터 호출
  • 동작 완료까지 대기 후 재시도
400 5001022 Not a user-owned cluster. 클러스터의 인스턴스 번호 입력 오류
  • 클러스터 번호 수정 후 재시도
400 5001049 Network Interface does not have an IP that can be assigned. Subnet 부족
  • VPC에 Subnet 추가 후 재시도
400 5001139 Contract restriction error. Creation limit is set. The cluster can no longer be created. Please contact customer support to modify the limit. 생성 한도 제한
  • 네이버 클라우드 플랫폼 포털의 고객 지원으로 문의
400 5001269 The instance could not be found. 클러스터가 삭제되어 존재하지 않음
  • 운영 중인 클러스터에서 재시도
참고

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

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

클러스터 관련 API에 대한 설명은 다음과 같습니다.

API 설명
backupClusterConfiguration Object Storage 버킷에 클러스터 설정 백업
changeCloudHadoopNodeCount 클러스터 노드 수 변경
changeCloudHadoopNodeSpec 클러스터 노드 스펙 업그레이드
createCloudHadoopInstance 클러스터 생성
deleteCloudHadoopInstance 클러스터 삭제
getCloudHadoopAddOnList 추가 설치 가능한 컴포넌트 목록 조회
getCloudHadoopBucketList 사용 가능한 Object Storage 버킷 조회
getCloudHadoopClusterTypeList 사용 가능한 클러스터 타입 조회
getCloudHadoopImageProductList 사용 가능한 클러스터 이미지 조회
getCloudHadoopInstanceDetail 클러스터 단건 상세 조회
getCloudHadoopInstanceList 클러스터 목록 조회
getCloudHadoopLoginKeyList 사용 중인 인증키 조회
getCloudHadoopMysqlInstanceList Hive 메타스토어와 연동 가능한 Cloud DB for MySQL 조회
getCloudHadoopMysqlUserList Hive 메타스토어와 연동 가능한 Cloud DB for MySQL의 사용자 정보 조회
getCloudHadoopObjectList 사용 중인 Object Storage 버킷 내 객체 목록 조회
getCloudHadoopProductList 사용 가능한 노드별 서버 타입 조회
getCloudHadoopTargetSubnetList 사용 중인 Subnet 조회
getCloudHadoopTargetVpcList 사용 중인 VPC 조회
saveExternalHiveMetaStore Hive 메타스토어 연동
testConnectExternalHiveMetaStore Hive 메타스토어 연동 가능 여부 테스트

노트북 관련 API에 대한 설명은 다음과 같습니다.

API 설명
createCloudHadoopNotebookInstance 노트북 생성
deleteCloudHadoopNotebookInstance 노트북 삭제
getCloudHadoopNotebookBucketList 사용 가능한 Object Storage 버킷 조회
getCloudHadoopNotebookComponentList 사용 가능한 노트북 컴포넌트 조회
getCloudHadoopNotebookImageProductList 사용 가능한 노트북 이미지 조회
getCloudHadoopNotebookInstanceDetail 노트북 단건 상세 조회
getCloudHadoopNotebookInstanceList 노트북 목록 조회
getCloudHadoopNotebookProductList 사용 가능한 노트북 노드 서버 타입 조회

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