---
title: "createCloudHadoopInstance  "
slug: "analytics-cloudhadoop-createcloudhadoopinstance"
tags: ["Cloud Hadoop"]
updated: 2026-10-22T10:46:55Z
published: 2026-10-22T10:46:55Z
canonical: "api-gov.ncloud-docs.com/analytics-cloudhadoop-createcloudhadoopinstance"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api-gov.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# createCloudHadoopInstance

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

Cloud Hadoop 클러스터를 생성합니다.

## 요청

요청 형식을 설명합니다. 요청 형식은 다음과 같습니다.

| 메서드 | URI |
| --- | --- |
| GET \| POST | /hadoop/v2/createCloudHadoopInstance |

참고

가이드는 GET 방식 기준으로 안내합니다. POST 방식의 호출 테스트는 네이버 클라우드 플랫폼 콘솔의 API Gateway 서비스에서 Swagger를 통해서 가능합니다.

### 요청 헤더

Cloud Hadoop API에서 공통으로 사용하는 헤더에 대한 정보는 [Cloud Hadoop 요청 헤더](/docs/analytics-cloudhadoop#%EC%9A%94%EC%B2%AD%ED%97%A4%EB%8D%94)를 참조해 주십시오.

### 요청 쿼리 파라미터

요청 쿼리 파라미터에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `regionNo` | String | Optional | 리전 번호 - `1`: 한국 리전 (기본값) - [getRegionList](/docs/compute-server-getregionlist) 참조 |
| `zoneNo` | String | Optional | 존 번호 - `3`: KR-2 (기본값) - [getZoneList](/docs/compute-server-getzonelist) 참조 |
| `cloudHadoopClusterName` | String | Required | 클러스터 이름 - 영문 소문자, 숫자, 특수문자 '-'를 조합하여 3~15자로 입력 - 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 - 중복 사용 불가 |
| `cloudHadoopImageProductCode` | String | Required | 클러스터 이미지 코드 - [getCloudHadoopImageProductList](/docs/analytics-cloudhadoop-getcloudhadoopimageproductlist)의 `productCode` 참조 |
| `cloudHadoopClusterTypeCode` | String | Required | 클러스터 타입 코드 - `CHADP` \| `HBASE` \| `SPARK` \| `PRESTO` - `CHADP`: Core Hadoop - `HBASE`: HBase - `SPARK`: Spark - `PRESTO`: Presto |
| `cloudHadoopAdminName` | String | Required | 클러스터 관리자 계정 사용자 이름 - 영문 소문자, 숫자, 특수문자 '-'를 조합하여 3~15자로 입력 - 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성 - Ambari 콘솔 접속 시 필요 |
| `cloudHadoopAdminPassword` | String | Required | 클러스터 관리자 계정 비밀번호 - 영문자, 숫자, 특수문자를 조합하여 9~20자로 입력 - 사용 불가 특수문자: ', ", ₩, /, &, `, 공백 - Ambari 콘솔 접속 시 필요 |
| `loginKeyName` | String | Required | 인증키 이름 - [getLoginKeyList](/docs/compute-server-getloginkeylist) 참조 - SSH 방식으로 노드에 직접 접속 시 필요 |
| `bucketName` | String | Required | Object Storage 버킷 이름 - [getCloudHadoopBucketList](/docs/analytics-cloudhadoop-getcloudhadoopbucketlist) 참조 |
| `masterNodeProductCode` | String | Required | 마스터노드 서버 타입 코드 - [getCloudHadoopProductList](/docs/analytics-cloudhadoop-getcloudhadoopproductlist) 참조 |
| `masterNodeCount` | Integer | Optional | 마스터노드 수 - 2 (유효 값) |
| `masterNodeStorageTypeCode` | String | Required | 마스터노드 스토리지 타입 - `SSD` \| `HDD` |
| `masterNodeStorageSize` | Integer | Required | 마스터노드 스토리지 용량(GB) - 100~2000 (10 GB 단위) |
| `workerNodeProductCode` | String | Required | 작업자노드 서버 타입 코드 - [getCloudHadoopProductList](/docs/analytics-cloudhadoop-getcloudhadoopproductlist) 참조 |
| `workerNodeCount` | Integer | Optional | 작업자노드 수 - 2~8 (기본값: 2) |
| `workerNodeStorageTypeCode` | String | Required | 작업자노드 스토리지 타입 - `SSD` \| `HDD` |
| `workerNodeStorageSize` | Integer | Required | 작업자노드 스토리지 용량(GB) - 100~2000 (10 GB 단위) |
| `edgeNodeProductCode` | String | Conditional | 엣지노드 서버 타입 코드 - [getCloudHadoopProductList](/docs/analytics-cloudhadoop-getcloudhadoopproductlist) 참조 - `cloudHadoopImageProductCode`가 `SPSWCHADPLINUX03`인 경우, 필수 입력 |
| `edgeNodeCount` | String | Conditional | 엣지노드 수 - 1 (유효 값) - `cloudHadoopImageProductCode`가 `SPSWCHADPLINUX03`인 경우, 필수 입력 |
| `responseFormatType` | String | Optional | 응답 데이터의 형식 - `xml` (기본값) \| `json` |

참고

클러스터의 마스터노드와 엣지노드 수는 별도로 설정할 수 없습니다.

- Cloud Hadoop 서비스는 고가용성(HA)을 필수로 지원하므로, 클러스터에는 항상 2개의 마스터노드가 포함됩니다.
- Cloud Hadoop 1.2 클러스터의 엣지노드는 1개로 고정되어 있습니다.

### 요청 예시

요청 예시는 다음과 같습니다.

```
curl --location --request GET 'https://ncloud.apigw.gov-ntruss.com/hadoop/v2/createCloudHadoopInstance
?regionNo=1
&zoneNo=3
&cloudHadoopClusterName=cluster999
&cloudHadoopImageProductCode=SPSWCHADPLINUX03
&cloudHadoopClusterTypeCode=CHADP
&cloudHadoopAdminName=ncpadmin
&cloudHadoopAdminPassword=**********
&loginKeyName=loginkey000
&bucketName=bucket000
&masterNodeProductCode=SPSVRCHADP000001
&masterNodeCount=2
&masterNodeStorageTypeCode=SSD
&masterNodeStorageSize=100
&workerNodeProductCode=SPSVRCHADP000001
&workerNodeCount=2
&workerNodeStorageTypeCode=SSD
&workerNodeStorageSize=100
&edgeNodeProductCode=SPSVRCHADP000010
&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}' \
--header 'x-ncp-apigw-api-key: {API Key}'
```

## 응답

응답 형식을 설명합니다.

### 응답 바디

응답 바디에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `createCloudHadoopInstanceResponse` | Object | - | 응답 결과 |
| `createCloudHadoopInstanceResponse.totalRows` | Integer | - | 응답 결과 수 |
| `createCloudHadoopInstanceResponse.cloudHadoopInstanceList` | Array | - | [클러스터 목록](/docs/analytics-cloudhadoop-createcloudhadoopinstance#createCloudHadoopInstanceResponsecloudHadoopInstanceList) |
| `createCloudHadoopInstanceResponse.requestId` | String | - | 요청에 대한 아이디 - UUID 형식 |
| `createCloudHadoopInstanceResponse.returnCode` | String | - | 응답 코드 |
| `createCloudHadoopInstanceResponse.returnMessage` | String | - | 응답 메시지 |

#### `createCloudHadoopInstanceResponse.cloudHadoopInstanceList`

`createCloudHadoopInstanceResponse.cloudHadoopInstanceList`에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `cloudHadoopInstanceNo` | String | - | 클러스터 인스턴스 번호 |
| `cloudHadoopClusterName` | String | - | 클러스터 이름 |
| `cloudHadoopImageProductCode` | String | - | 클러스터 이미지 코드 |
| `cloudHadoopClusterType` | Object | - | 클러스터 타입 정보 |
| `cloudHadoopClusterType.code` | String | - | 클러스터 타입 코드 - `CHADP` \| `HBASE` \| `SPARK` \| `PRESTO` - `CHADP`: Core Hadoop - `HBASE`: HBase - `SPARK`: Spark - `PRESTO`: Presto |
| `cloudHadoopClusterType.codeName` | String | - | 클러스터 타입 코드 이름 |
| `masterNodeCpuCount` | Integer | - | 마스터노드 CPU 수 |
| `masterNodeCount` | Integer | - | 마스터노드 수 |
| `masterNodeMemorySize` | Integer | - | 마스터노드 메모리 용량(Byte) |
| `workerNodeCpuCount` | Integer | - | 작업자노드 CPU 수 |
| `workerNodeCount` | Integer | - | 작업자노드 수 |
| `workerNodeMemorySize` | Integer | - | 작업자노드 메모리 용량(Byte) |
| `edgeNodeCpuCount` | Integer | - | 엣지노드 CPU 수 |
| `edgeNodeCount` | Integer | - | 엣지노드 수 |
| `edgeNodeMemorySize` | Integer | - | 엣지노드 메모리 용량(Byte) |
| `cloudHadoopInstanceStatus` | Object | - | 클러스터 상태 정보 - `cloudHadoopInstanceStatusName`이 `creating`인 경우, 표시 |
| `cloudHadoopInstanceStatus.code` | String | - | 클러스터 상태 코드 - `INIT`: Cloud Hadoop INIT 상태 |
| `cloudHadoopInstanceStatus.codeName` | String | - | 클러스터 상태 코드 이름 |
| `cloudHadoopInstanceStatusName` | String | - | 클러스터 상태 이름 - `creating` \| `running` \| `settingup` \| `deleting` - `creating`: 생성 중 - `running`: 운영 중 - `settingup`: 설정 중 - `deleting`: 삭제 중 |
| `isHa` | Boolean | - | 고가용성 지원 여부 - `true` (기본값) \| `false` - `true`: 지원 - `false`: 지원 안 함 |
| `zone` | Object | - | 존 정보 |
| `zone.zoneNo` | String | - | 존 번호 |
| `zone.zoneName` | String | - | 존 이름 |
| `zone.zoneCode` | String | - | 존 코드 |
| `zone.zoneDescription` | String | - | 존 설명 |
| `zone.regionNo` | String | - | 리전 번호 |
| `region` | Object | - | 리전 정보 |
| `region.regionNo` | String | - | 리전 번호 |
| `region.regionCode` | String | - | 리전 코드 |
| `region.regionName` | String | - | 리전 이름 |
| `masterNodeServerName` | String | - | 마스터노드 서버 이름 |
| `createDate` | String | - | 클러스터 생성 일시 - ISO 8601 형식 |
| `dataArchitecture` | String | - | 데이터 아키텍처 |
| `bucketName` | String | - | Object Storage 버킷 이름 |
| `directConnectionAccount` | String | - | 클러스터 직접 접속 계정 |
| `loginKeyName` | String | - | 인증키 이름 |

### 응답 상태 코드

Cloud Hadoop API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Cloud Hadoop 응답 상태 코드](/docs/analytics-cloudhadoop#%EC%9D%91%EB%8B%B5%EC%83%81%ED%83%9C%EC%BD%94%EB%93%9C)를 참조해 주십시오.

### 응답 예시

응답 예시는 다음과 같습니다.

```
{
    "createCloudHadoopInstanceResponse": {
        "totalRows": 3,
        "cloudHadoopInstanceList": [
            {
                "cloudHadoopInstanceNo": "2777****",
                "cloudHadoopClusterName": "cluster999",
                "cloudHadoopImageProductCode": "SPSWCHADPLINUX03",
                "cloudHadoopClusterType": {
                    "code": "CHADP",
                    "codeName": "Core Hadoop"
                },
                "masterNodeCpuCount": 4,
                "masterNodeCount": 2,
                "masterNodeMemorySize": 8589934592,
                "workerNodeCpuCount": 4,
                "workerNodeCount": 2,
                "workerNodeMemorySize": 8589934592,
                "edgeNodeCpuCount": 4,
                "edgeNodeCount": 1,
                "edgeNodeMemorySize": 8589934592,
                "cloudHadoopInstanceStatus": {
                    "code": "INIT",
                    "codeName": "Cloud Hadoop INIT 상태"
                },
                "cloudHadoopInstanceStatusName": "creating",
                "isHa": true,
                "zone": {
                    "zoneNo": "3",
                    "zoneName": "KR-2",
                    "zoneCode": "KR-2",
                    "zoneDescription": "평촌 zone",
                    "regionNo": "1"
                },
                "region": {
                    "regionNo": "1",
                    "regionCode": "KR",
                    "regionName": "Korea"
                },
                "masterNodeServerName": "m-001-cluster999-hd",
                "createDate": "2025-02-28T11:29:26+0900",
                "dataArchitecture": "OBJST",
                "bucketName": "bucket000",
                "directConnectionAccount": "sshuser",
                "loginKeyName": "loginkey000"
            },
            ...
        ],
        "requestId": "d7b932a7-****-****-****-192d44c77deb",
        "returnCode": "0",
        "returnMessage": "success"
    }
}
```