- 인쇄
- PDF
Cloud Hadoop (VPC) 개요
- 인쇄
- PDF
VPC 환경에서 이용 가능합니다.
Cloud Hadoop은 Apache Hadoop, HBase, Spark, Hive, Presto 등의 오픈소스 기반 프레임워크를 사용자가 자유롭게 사용하여 빅데이터를 쉽고 빠르게 처리할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. Cloud Hadoop 서비스에서는 Cloud Hadoop 클러스터 관리와 노트북노드 관리 기능에 대한 API를 RESTful 형태로 제공합니다.
Cloud Hadoop 공통 설정
Cloud Hadoop API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.
요청
공통 요청 형식을 설명합니다.
API URL
요청 API URL은 다음과 같습니다.
요청 헤더
요청 헤더에 대한 설명은 다음과 같습니다.
필드 | 필수 여부 | 설명 |
---|---|---|
x-ncp-apigw-timestamp | Required | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
|
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
- 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 부족
|
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
Cloud Hadoop 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.
Clusters
클러스터 관련 API에 대한 설명은 다음과 같습니다.
API | 설명 |
---|---|
getCloudHadoopAddOnList | 추가 설치 가능한 컴포넌트 목록 조회 |
getCloudHadoopBucketList | 사용 가능한 Object Storage 버킷 조회 |
getCloudHadoopClusterTypeList | 사용 가능한 클러스터 타입 조회 |
getCloudHadoopImageProductList | 사용 가능한 클러스터 이미지 조회 |
getCloudHadoopProductList | 사용 가능한 노드별 서버 타입 조회 |
createCloudHadoopInstance | 클러스터 생성 |
getCloudHadoopInstanceDetail | 클러스터 단건 상세 조회 |
getCloudHadoopInstanceList | 클러스터 목록 조회 |
getCloudHadoopLoginKeyList | 사용 중인 인증키 조회 |
getCloudHadoopMysqlInstanceList | Hive 메타스토어와 연동 가능한 Cloud DB for MySQL 조회 |
getCloudHadoopMysqlUserList | Hive 메타스토어와 연동 가능한 Cloud DB for MySQL의 사용자 정보 조회 |
getCloudHadoopObjectList | 사용 중인 Object Storage 버킷 내 객체 목록 조회 |
getCloudHadoopTargetSubnetList | 사용 중인 Subnet 조회 |
getCloudHadoopTargetVpcList | 사용 중인 VPC 조회 |
backupClusterConfiguration | Object Storage 버킷에 클러스터 설정 백업 |
changeCloudHadoopNodeCount | 클러스터 노드 수 변경 |
changeCloudHadoopNodeSpec | 클러스터 노드 스펙 업그레이드 |
saveExternalHiveMetaStore | Hive 메타스토어 연동 |
testConnectExternalHiveMetaStore | Hive 메타스토어 연동 가능 여부 테스트 |
deleteCloudHadoopInstance | 클러스터 삭제 |
Notebooks
노트북 관련 API에 대한 설명은 다음과 같습니다.
API | 설명 |
---|---|
getCloudHadoopNotebookBucketList | 사용 가능한 Object Storage 버킷 조회 |
getCloudHadoopNotebookComponentList | 사용 가능한 노트북 컴포넌트 조회 |
getCloudHadoopNotebookImageProductList | 사용 가능한 노트북 이미지 조회 |
getCloudHadoopNotebookProductList | 사용 가능한 노트북노드 서버 타입 조회 |
createCloudHadoopNotebookInstance | 노트북 생성 |
getCloudHadoopNotebookInstanceDetail | 노트북 단건 상세 조회 |
getCloudHadoopNotebookInstanceList | 노트북 목록 조회 |
deleteCloudHadoopNotebookInstance | 노트북 삭제 |
Cloud Hadoop 연관 리소스
Cloud Hadoop API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.
- Cloud Hadoop API 사용 방법
- 서명(시그니처) 생성: 요청 헤더에 추가할 서명 생성 방법
- Sub Account 사용 가이드: 요청 헤더에 추가할 Access Key 발급 방법
- Ncloud 공통 응답 상태 코드: Cloud Hadoop 서비스에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Cloud Hadoop 서비스 사용 방법
- Cloud Hadoop 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 Cloud Hadoop 사용하는 방법
- Ncloud 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 관한 사용 가이드
- 요금 소개, 특징, 상세 기능: Cloud Hadoop의 요금 체계, 특징, 상세 기능 요약
- 서비스 최신 소식: Cloud Hadoop 서비스 관련 최신 소식
- 자주 하는 질문: Cloud Hadoop 서비스 사용자들이 자주 하는 질문
- 문의하기: API 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의