--- title: "createCloudHadoopInstance" slug: "analytics-vhadoop-createcloudhadoopinstance" tags: ["Cloud Hadoop"] updated: 2026-04-23T08:56:15Z published: 2026-04-23T09:02:33Z canonical: "api.ncloud-docs.com/analytics-vhadoop-createcloudhadoopinstance" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # createCloudHadoopInstance VPC 환경에서 이용 가능합니다. Cloud Hadoop 클러스터를 생성합니다. ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | --- | --- | | GET \| POST | /vhadoop/v2/createCloudHadoopInstance | 참고 가이드는 GET 방식 기준으로 안내합니다. POST 방식의 호출 테스트는 네이버 클라우드 플랫폼 콘솔의 API Gateway 서비스에서 Swagger를 통해서 가능합니다. ### 요청 헤더 Cloud Hadoop API에서 공통으로 사용하는 헤더에 대한 정보는 [Cloud Hadoop 요청 헤더](/docs/analytics-vhadoop#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오. ### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `regionCode` | String | Optional | 리전 코드 - [getRegionList](/docs/compute-vserver-server-common-getregionlist) 참조 - 조회 결과의 첫 번째 리전(기본값) | | `cloudHadoopClusterName` | String | Required | 클러스터 이름 - 영문 소문자, 숫자, 특수문자 '-'를 조합하여 3~15자로 입력 - 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 - 중복 사용 불가 | | `cloudHadoopImageProductCode` | String | Optional | 클러스터 이미지 코드 - [getCloudHadoopImageProductList](/docs/analytics-vhadoop-getcloudhadoopimageproductlist)의 `productCode` 참조 - 미입력 시 제공 중인 최신 버전 적용 | | `cloudHadoopClusterTypeCode` | String | Required | 클러스터 타입 코드 - [getCloudHadoopClusterTypeList](/docs/analytics-vhadoop-getcloudhadoopclustertypelist) 참조 | | `cloudHadoopAddOnCodeList` | Array | Optional | 클러스터 Add-on 컴포넌트 목록 - [getCloudHadoopAddOnList](/docs/analytics-vhadoop-getcloudhadoopaddonlist) 참조 - Cloud Hadoop 1.5 이상 버전에서 적용 가능 - <예시> `cloudHadoopAddOnCodeList.1=PRESTO&cloudHadoopAddOnCodeList.2=HBASE` | | `useDataCatalog` | Boolean | Optional | Data Catalog 서비스 사용 여부 - `true` \| `false` (기본값) - `true`: 사용. Hive 메타스토어를 Data Catalog 서비스의 카탈로그를 통해 제공 - `false`: 사용 안 함 - 사용 조건 - Data Catalog 서비스 이용 신청 및 정상 운영 상태 - Cloud Hadoop 2.0 이상 버전 | | `useKdc` | Boolean | Optional | 커버로스(Kerberos) 인증 구성의 사용 여부 - `true` \| `false` (기본값) - `true`: 사용 - `false`: 사용 안 함 - 사용할 경우, 마스터 노드에 KDC 서버 이중화 제공 | | `kdcRealm` | String | Conditional | KDC Realm 정보 - `useKdc`가 `true`인 경우, 필수 입력 - Realm 형태의 도메인 규칙만 허용 | | `kdcPassword` | String | Conditional | KDC 관리자 계정 비밀번호 - `useKdc`가 `true`인 경우, 필수 입력 - 영문자, 숫자, 특수문자를 조합하여 8~20자로 입력 - 사용 불가 특수문자: ', ", ₩, /, &, `, 공백 | | `vpcNo` | String | Required | VPC 번호 - [getVpcList](/docs/networking-vpc-vpcmanagement-getvpclist) 참조 | | `cloudHadoopAdminUserName` | String | Required | 클러스터 관리자 계정 사용자 이름 - 영문 소문자, 숫자, 특수문자 '-'를 조합하여 3~15자로 입력 - 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 - Ambari 콘솔 접속 시 필요 | | `cloudHadoopAdminUserPassword` | String | Required | 클러스터 관리자 계정 비밀번호 - 영문자, 숫자, 특수문자를 조합하여 8~20자로 입력 - 사용 불가 특수문자: ', ", ₩, /, &, `, 공백 - Ambari 콘솔 접속 시 필요 | | `bucketName` | String | Required | Object Storage 버킷 이름 - [getCloudHadoopBucketList](/docs/analytics-vhadoop-getcloudhadoopbucketlist) 참조 | | `useBootstrapScript` | Boolean | Optional | 부트스트랩 스크립트 사용 여부 - `true` \| `false` (기본값) - `true`: 사용 - `false`: 사용 안 함 - 사용할 경우, 모든 노드에 스크립트 미리 실행 | | `bootstrapScript` | String | Conditional | 부트스트랩 스크립트 - `useBootstrapScript`가 `true`인 경우, 필수 입력 - 버킷 내 폴더와 파일 이름 입력 - 클러스터에 연동된 버킷으로만 스크립트 수행 가능 - 파일 이름은 영문만 허용. 공백, 특수문자 사용 불가 - 스크립트 길이: N~1,024 Bytes | | `edgeNodeSubnetNo` | String | Required | 엣지노드 Subnet 번호 - [getSubnetList](/docs/networking-vpc-subnetmanagement-getsubnetlist) 참조 | | `edgeNodeProductCode` | String | Optional | 엣지노드 서버 타입 코드 - [getCloudHadoopProductList](/docs/analytics-vhadoop-getcloudhadoopproductlist) 참조 - 기본값: 최소 사양(메모리, CPU 순) | | `masterNodeSubnetNo` | String | Required | 마스터노드 Subnet 번호 - [getSubnetList](/docs/networking-vpc-subnetmanagement-getsubnetlist) 참조 | | `masterNodeProductCode` | String | Optional | 마스터노드 서버 타입 코드 - [getCloudHadoopProductList](/docs/analytics-vhadoop-getcloudhadoopproductlist) 참조 - 기본값: 최소 사양(메모리, CPU 순) | | `masterNodeDataStorageTypeCode` | String | Required | 마스터노드 스토리지 타입 - `SSD` \| `HDD` \| `CB2` - 설치 후 변경 불가 - `getCloudHadoopImageProductList`의 generationCode 값에 따라 기본값 상이 | | `masterNodeDataStorageSize` | Integer | Required | 마스터노드 스토리지 용량(GB) - `100`~`2000` (10 GB 단위) \| `4000` \| `6000` | | `workerNodeSubnetNo` | String | Required | 작업자노드 Subnet 번호 - [getSubnetList](/docs/networking-vpc-subnetmanagement-getsubnetlist) 참조 - Private Subnet에만 배치 가능 | | `workerNodeProductCode` | String | Optional | 작업자노드 서버 타입 코드 - [getCloudHadoopProductList](/docs/analytics-vhadoop-getcloudhadoopproductlist) 참조 - 기본값: 최소 사양(메모리, CPU 순) | | `workerNodeCount` | Integer | Optional | 작업자노드 수 - 2~8 (기본값: 2) | | `workerNodeDataStorageTypeCode` | String | Required | 작업자노드 스토리지 타입 - `SSD` \| `HDD` \| `CB2` - 설치 후 변경 불가 - `getCloudHadoopImageProductList`의 generationCode 값에 따라 기본값 상이 | | `workerNodeDataStorageSize` | Integer | Required | 작업자노드 스토리지 용량(GB) - `100`~`2000` (10 GB 단위) \| `4000` \| `6000` | | `loginKeyName` | String | Required | 인증키 이름 - [getCloudHadoopLoginKeyList](/docs/analytics-vhadoop-getcloudhadooploginkeylist) 참조 - SSH 방식으로 노드에 직접 접속 시 필요 | | `engineVersionCode` | String | Optional | 엔진 버전 코드 - [getCloudHadoopImageProductList](/docs/analytics-vhadoop-getcloudhadoopimageproductlist) 참조 - Rocky 클러스터 생성 시 입력 - 미입력 시 제공 중인 최신 버전 적용 | | `responseFormatType` | String | Optional | 응답 데이터의 형식 - `xml` (기본값) \| `json` | 참고 클러스터의 마스터노드와 엣지노드 수는 별도로 설정할 수 없습니다. - Cloud Hadoop 서비스는 고가용성(HA)을 필수로 지원하므로, 클러스터에는 항상 2개의 마스터노드가 포함됩니다. - 엣지노드는 1개로 고정되어 있습니다. ### 요청 예시 요청 예시는 다음과 같습니다. ``` curl --location --request GET 'https://ncloud.apigw.ntruss.com/vhadoop/v2/createCloudHadoopInstance ?regionCode=KR &cloudHadoopClusterName=cluster03 &cloudHadoopClusterTypeCode=CORE_HADOOP_WITH_SPARK &cloudHadoopAddOnCodeList=PRESTO &vpcNo=***** &cloudHadoopAdminUserName=******* &cloudHadoopAdminUserPassword=******** &bucketName=bk1 &edgeNodeSubnetNo=20**** &edgeNodeProductCode=SVR.VCHDP.EDGND.STAND.C004.M016.NET.HDD.B050.G002 &masterNodeSubnetNo=20**** &masterNodeProductCode=SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002 &masterNodeDataStorageTypeCode=SSD &masterNodeDataStorageSize=100 &workerNodeSubnetNo=20**** &workerNodeProductCode=SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002 &workerNodeCount=2 &workerNodeDataStorageTypeCode=SSD &workerNodeDataStorageSize=100 &loginKeyName=ncp****** &responseFormatType=json' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ## 응답 응답 형식을 설명합니다. ### 응답 바디 응답 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | --- | --- | --- | --- | | `createCloudHadoopInstanceResponse` | Object | - | 응답 결과 - [CloudHadoopInstanceList](/docs/common-vapidatatype-cloudhadoopinstancelist) 참조 | | `createCloudHadoopInstanceResponse.requestId` | String | - | 요청에 대한 아이디 - UUID 형식 | | `createCloudHadoopInstanceResponse.returnCode` | String | - | 응답 코드 | | `createCloudHadoopInstanceResponse.returnMessage` | String | - | 응답 메시지 | ### 응답 상태 코드 Cloud Hadoop API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Cloud Hadoop 응답 상태 코드](/docs/analytics-vhadoop#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. ``` { "createCloudHadoopInstanceResponse": { "totalRows": 1, "cloudHadoopInstanceList": [ { "cloudHadoopInstanceNo": "1000*****", "cloudHadoopClusterName": "cluster03", "cloudHadoopInstanceStatusName": "creating", "cloudHadoopInstanceStatus": { "code": "INIT", "codeName": "CLOUD DATABASE(VPC) Init 상태" }, "cloudHadoopInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Creat OP" }, "cloudHadoopClusterType": { "code": "CORE_HADOOP_WITH_SPARK", "codeName": "Core Hadoop with Spark : HDFS(3.1.1), YARN(3.1.1), Zookeeper(3.4.9), Ranger(2.0.0), HIVE(3.1.2), Hue(4.8.0), Zeppelin Notebook(0.10.1), Spark (2.4.8)" }, "cloudHadoopVersion": { "code": "HADOOP2.1", "codeName": "Cloud Hadoop 2.1" }, "cloudHadoopAddOnList": [], "ambariServerHost": "e-001-cluster03-5v3z-hd", "clusterDirectAccessAccount": "sshuser", "loginKey": "**********", "objectStorageBucket": "bk1", "cloudHadoopImageProductCode": "SW.VCHDP.LNX64.CNTOS.0708.HDP.21.B050", "isHa": true, "createDate": "2025-02-25T09:24:44+0900", "useDataCatalog": false, "accessControlGroupNoList": [], "cloudHadoopServerInstanceList": [ { "cloudHadoopServerName": "e-001-cluster03-5v3z-hd", "cloudHadoopServerRole": { "code": "E", "codeName": "Edge Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) 서버 Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.EDGND.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "7****", "vpcName": "****", "subnetNo": "20****", "subnetName": "****", "privateIp": "***.***.***.***", "isPublicSubnet": true, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2025-02-25T09:24:44+0900" }, { "cloudHadoopServerName": "m-001-cluster03-5v3x-hd", "cloudHadoopServerRole": { "code": "M", "codeName": "Master Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) 서버 Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "7****", "vpcName": "****", "subnetNo": "20****", "subnetName": "****", "privateIp": "***.***.***.***", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2025-02-25T09:24:44+0900" }, { "cloudHadoopServerName": "m-002-cluster03-5v3y-hd", "cloudHadoopServerRole": { "code": "M", "codeName": "Master Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) 서버 Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "7****", "vpcName": "****", "subnetNo": "20****", "subnetName": "****", "privateIp": "***.***.***.***", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2025-02-25T09:24:44+0900" }, { "cloudHadoopServerName": "d-001-cluster03-5v40-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Date Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) 서버 Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "7****", "vpcName": "****", "subnetNo": "20****", "subnetName": "****", "privateIp": "***.***.***.***", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2025-02-25T09:24:44+0900" }, { "cloudHadoopServerName": "d-002-cluster03-5v41-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Date Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) 서버 Pending 상태" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) 서버 Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "7****", "vpcName": "****", "subnetNo": "20****", "subnetName": "****", "privateIp": "***.***.***.***", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2025-02-25T09:24:44+0900" } ] } ], "requestId": "86e6bc28-****-****-****-1b00ebda0d97", "returnCode": "0", "returnMessage": "success" } } ```