--- title: "createCloudHadoopInstance" slug: "cli-vhadoop-createcloudhadoopinstance" tags: ["Cloud Hadoop"] updated: 2026-06-25T09:10:26Z published: 2026-06-25T09:10:26Z canonical: "cli-fin.ncloud-docs.com/cli-vhadoop-createcloudhadoopinstance" --- > ## Documentation Index > Fetch the complete documentation index at: https://cli-fin.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # createCloudHadoopInstance ## 개요 Cloud Hadoop 인스턴스를 생성합니다. ## 요청 ### 요청 파라미터 | 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 | | ----- | ----- | ----- | ----- | ----- | | regionCode | No | String | | - 리전 코드
Cloud Hadoop 인스턴스가 생성될 리전(Region)을 결정 가능
regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능
Default: getRegionList 조회 결과의 첫 번째 리전을 선택 | | vpcNo | Yes | String | | - VPC 번호
Cloud Hadoop 인스턴스가 생성될 VPC를 결정 가능
vpcNo는 [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 액션을 통해서 획득 가능 | | cloudHadoopImageProductCode | No | String | | - Cloud Hadoop 이미지 상품 코드
cloudHadoopImageProductCode는 [getCloudHadoopImageProductList](/docs/cli-vhadoop-getcloudhadoopimageproductlist) 액션의 productCode로 획득 가능
입력하지 않을 경우 Default값으로 생성됨
Default: Cloud Hadoop 최신 버전 | | masterNodeProductCode | No | String | | - Cloud Hadoop Master 서버 상품 코드
생성할 Cloud Hadoop 인스턴스의 서버 스펙을 결정 가능
masterNodeProductCode는 [getCloudHadoopProductList](/docs/cli-vhadoop-getcloudhadoopproductlist) 액션의 infraResourceDetailTypeCode = 'MSTDT'로 설정하여 호출 시 획득 가능
Default:최소 사양으로 선택됨
최소 사양의 기준: 1. 메모리 2. CPU | | edgeNodeProductCode | No | String | | - Cloud Hadoop Edge 서버 상품 코드
생성할 Cloud Hadoop 인스턴스의 서버 스펙을 결정 가능
edgeNodeProductCode는 [getCloudHadoopProductList](/docs/cli-vhadoop-getcloudhadoopproductlist) 액션의 infraResourceDetailTypeCode = 'EDGND'로 설정하여 호출 시 획득 가능
Default:최소 사양으로 선택됨
최소 사양의 기준: 1. 메모리 2. CPU | | workerNodeProductCode | No | String | | - Cloud Hadoop Worker 서버 상품 코드
생성할 Cloud Hadoop 인스턴스의 서버 스펙을 결정 가능
workerNodeProductCode는 [getCloudHadoopProductList](/docs/cli-vhadoop-getcloudhadoopproductlist) 액션의 infraResourceDetailTypeCode = 'MSTDT'로 설정하여 호출 시 획득 가능
Default:최소 사양으로 선택됨
최소 사양의 기준: 1. 메모리 2. CPU | | cloudHadoopClusterName | Yes | String | 영어, 숫자, -의 특수문자, 한글만 입력 가능
첫 글자와 마지막 글자는 영문자(소문자) 또는 숫자
Min: 3
Max: 15 | Cloud Hadoop 클러스터 이름 | | cloudHadoopClusterTypeCode | Yes | String | | - Cloud Hadoop 클러스터 유형코드
cloudHadoopClusterTypeCode는 [getCloudHadoopClusterTypeList](/docs/cli-vhadoop-getcloudhadoopclustertypelist) 액션을 통해서 획득 가능 | | cloudHadoopAddOnCodeList | No | List<String> | | - Cloud Hadoop Add-On 리스트
Cloud Hadoop 1.5 버전 이상에서만 사용
cloudHadoopAddOnCode는 [getCloudHadoopAddOnList](/docs/cli-vhadoop-getcloudhadoopaddonlist) 액션을 통해서 획득 가능
Options: PRESTO \| HBASE
<예시> cloudHadoopAddOnCodeList PRESTO,HBASE| | cloudHadoopAdminUserName | Yes | String | 영문자(소문자), 숫자, 하이픈(-)으로만 구성
첫 글자와 마지막 글자는 영문자(소문자) 또는 숫자만 가능
Min : 3
Max: 15| - 클러스터 관리키 유저명
ambari 관리 콘솔 접속을 위해 필요한 관리자 계정 | | cloudHadoopAdminUserPassword | Yes | String | 영어(대문자), 특수문자, 숫자가 각각 1자 이상 포함 필수
특수문자(작은따옴표(' '), 큰따옴표(" "), 원 기호(₩), 빗금(/), 앰퍼샌드(&), 억음 부호(\`), Space는 포함 불가
Min:8
Max:20 |- 클러스터 관리자 패스워드
ambari 관리 콘솔 접속을 위해 필요한 관리자 계정 패스워드 | | loginKeyName | Yes | String | | - 인증키 이름
loginKeyName은 [getCloudHadoopLoginKeyList](/docs/cli-vhadoop-getcloudhadooploginkeylist) 액션을 통해서 획득 가능
노드에 직접 접속할 때 필요한 SSH 인증키를 설정 | | edgeNodeSubnetNo | Yes | String | | - 엣지노드의 Subent 번호
엣지노드를 위치 시킬 Subnet을 선택 가능
엣지노드는 Private/Public Subnet안에 위치
edgeNodeSubnetNo는 [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 액션을 통해서 획득 가능 | | masterNodeSubnetNo | Yes | String| | - 마스터노드의 Subent 번호
마스터노드를 위치 시킬 Subnet을 선택 가능
마스터노드는 Private/Public Subnet안에 위치
masterNodeSubnetNo는 [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 액션을 통해서 획득 가능 | | bucketName | Yes | String | | - 버킷 이름
Object Storage에 데이터를 저장하기 위한 공간을 의미
bucketName은 [getCloudHadoopBucketList](/docs/cli-vhadoop-getcloudhadoopbucketlist) 액션을 통해서 획득 가능 | | workerNodeSubnetNo | Yes | String | | - 작업자노드의 Subent 번호
작업자노드를 위치 시킬 Subnet을 선택 가능
작업자노드는 Private Subnet안에만 위치
workerNodeSubnetNo는 [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 액션을 통해서 획득 가능 | | masterNodeDataStorageTypeCode | Yes | String | SSD \| HDD | - 마스터노드의 데이터 스토리지 타입 코드
설치 이후에 데이터 스토리지 타입은 변경되지 않음
Options: SSD \| HDD
Default: SSD | | workerNodeDataStorageTypeCode | Yes | String | SSD \| HDD | - 작업자노드의 데이터 스토리지 타입 코드
설치 이후에 데이터 스토리지 타입은 변경되지 않음
Options: SSD \| HDD
Default: SSD | | masterNodeDataStorageSize | Yes | Integer | - Min: 100
- Max: 2000| - 마스터노드의 데이터 스토리지 크기
100GB ~ 2000GB 까지 10GB 단위로 입력 가능
4000GB, 6000GB 도 사용이 가능 | | workerNodeDataStorageSize | Yes | Integer | Min: 100
Max: 2000| - 작업자노드의 데이터 스토리지 크기
100GB ~ 2000GB 까지 10GB 단위로 입력 가능
4000GB, 6000GB 도 사용이 가능 | | workerNodeCount | No | Integer | | - 작업자노드 개수
작업자노드 개수는 2~8개에서 선택 가능
Default : 2 | | useKdc | No | Boolean | | - 로스 인증 구성 사용 여부
로스를 사용하여 Secure Hadoop 클러스터를 구성
Default: false | | kdcRealm | Conditional | String | | - KDC의 Realm 정보
useKdc가 true 일때에만 입력
useKdc가 false이면 무시됨
Relam 형태의 도메인 규칙만 허용 | | kdcPassword | Conditional | String | | - KDC admin 계정의 패스워드
useKdc가 true 일때에만 입력
useKdc가 false이면 무시됨 | | useBootstrapScript | No | Boolean | | - Cloud Hadoop 부트스트랩 스크립트 사용 여부
Default: false | | bootstrapScript | Conditional | String | 영문만 지원되며, 공백,특수문자는 허용하지 않음
최대 길이는 1024Bytes까지만 가능 | - Cloud Hadoop 부트스트랩 스크립트
useBootstrapScript가 true 일때에만 입력
useBootstrapScript가 false이면 무시됨
Cloud Hadoop과 연동되어 있는 버킷으로만 스크립트 수행 가능
버킷명을 제외한 폴더, 파일이름까지 입력 필요
<예시> init-script/example.sh
Default: false | | output | No | String | | - 응답 결과의 포맷 타입
Options : xml \| json
Default : json | ## 응답 ### 응답 데이터 타입 - CloudHadoopInstanceList 타입 | CloudHadoopInstanceList extends CommonResponse | | ---------- | |private Integer totalRows;| |private List<CloudHadoopInstance> cloudHadoopInstanceList = new ArrayList<>();| | CloudHadoopInstance | | ---------- | |private String cloudHadoopInstanceNo;| |private String cloudHadoopClusterName;| |private String cloudHadoopInstanceStatusName; | |private CommonCode cloudHadoopInstanceStatus;| |private CommonCode cloudHadoopInstanceOperation;| |private CloudHadoopClusterType cloudHadoopClusterType;| |private CloudHadoopVersion cloudHadoopVersion;| |private List<CloudHadoopAddOn> cloudHadoopAddOnList| |private String ambariServerHost;| |private String clusterDirectAccessAccount;| |private String loginKey;| |private String objectStorageBucket;| |private String kdcRealm;| |private String cloudHadoopImageProductCode; | |private Boolean isHa;| |private String domain;| |private AccessControlGroupNoList accessControlGroupNoList;| |private String generationCode;| |private Date createDate;| |private List<CloudHadoopServerInstance> cloudHadoopServerInstanceList;| | CloudHadoopAddOn | | ---------- | |private String code;| |private String codeName;| | CloudHadoopClusterType | | ---------- | |private String code;| |private String codeName;| | CloudHadoopVersion | | ---------- | |private String code;| |private String codeName;| | AccessControlGroupNoList | | ---------- | |private List<String> accessControlGroupNoList = new ArrayList<>(); | | CloudHadoopServerInstance | | ---------- | |private String cloudHadoopServerInstanceNo; | |private String cloudHadoopServerName; | |private String cloudHadoopServerInstanceStatusName;| |private CommonCode cloudHadoopServerInstanceStatus;| |private CommonCode cloudHadoopServerInstanceOperation;| |private CommonCode cloudHadoopServerRole;| |private String regionCode; | |private String vpcNo;| |private String vpcName;| |private String subnetNo;| |private String subnetName;| |private String privateIp;| |private Date createDate;| |private Date uptime;| |private String zoneCode;| |private Long memorySize;| |private Integer cpuCount;| |private Boolean isPublicSubnet;| |private Long dataStorageSize;| |private String cloudHadoopProductCode;| |private CommonCode dataStorageType;| ## 예시 ### 호출 ```http ncloud vhadoop createCloudHadoopInstance --regionCode FKR --vpcNo **65 --cloudHadoopImageProductCode SW.VCHDP.LNX64.CNTOS.0708.HDP.15.B050 --masterNodeProductCode SVR.VCHDP.MSTDT.HIMEM.C004.M032.NET.HDD.B050.G002 --edgeNodeProductCode SVR.VCHDP.EDGND.STAND.C004.M016.NET.HDD.B050.G002 --workerNodeProductCode SVR.VCHDP.MSTDT.HICPU.C008.M016.NET.HDD.B050.G002 --cloudHadoopClusterName test*** --cloudHadoopClusterTypeCode CORE_HADOOP_WITH_SPARK --cloudHadoopAddOnCodeList PRESTO --cloudHadoopAdminUserName test-*** --cloudHadoopAdminUserPassword ******* --loginKeyName key**** --bucketName buc*** --edgeNodeSubnetNo 11** --masterNodeSubnetNo 11** --workerNodeSubnetNo 12** --masterNodeDataStorageTypeCode SSD --workerNodeDataStorageTypeCode SSD --masterNodeDataStorageSize 100 --workerNodeDataStorageSize 100 --workerNodeCount 2 --useKdc true --kdcRealm EX**LE.COM --kdcPassword ********* --useBootstrapScript true --bootstrapScript init-script/example.sh ``` ### 응답 ```json { "createCloudHadoopInstanceResponse": { "totalRows": 1, "cloudHadoopInstanceList": [ { "cloudHadoopInstanceNo": "****778", "cloudHadoopClusterName": "****123", "cloudHadoopInstanceStatusName": "creating", "cloudHadoopInstanceStatus": { "code": "INIT", "codeName": "CLOUD DATABASE(VPC) Init State" }, "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.0", "codeName": "Cloud Hadoop 2.0" }, "cloudHadoopAddOnList": [], "ambariServerHost": "e-001-****-15iv-hd", "clusterDirectAccessAccount": "sshuser", "loginKey": "newkey", "objectStorageBucket": "**dd", "cloudHadoopImageProductCode": "SW.VCHDP.LNX64.CNTOS.0708.HDP.20.B050", "isHa": true, "generationCode": "G2", "createDate": "2023-02-08T21:26:09+0900", "accessControlGroupNoList": [], "cloudHadoopServerInstanceList": [ { "cloudHadoopServerName": "e-001-****-15iv-hd", "cloudHadoopServerRole": { "code": "E", "codeName": "Edge Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) Server Pending State" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Server Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.EDGND.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "FKR", "zoneCode": "FKR-2", "vpcNo": "**65", "vpcName": "vpcTestName", "subnetNo": "**46", "subnetName": "subnetTestName", "privateIp": "192.168.***.***", "isPublicSubnet": false, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2023-02-08T21:26:09+0900" }, { "cloudHadoopServerName": "m-001-****-15it-hd", "cloudHadoopServerRole": { "code": "M", "codeName": "Master Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) Server Pending State" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Server Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "FKR", "zoneCode": "FKR-2", "vpcNo": "**65", "vpcName": "vpcTestName", "subnetNo": "**46", "subnetName": "subnetTestName", "privateIp": "192.168.***.***", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2023-02-08T21:26:09+0900" }, { "cloudHadoopServerName": "m-002-****-15iu-hd", "cloudHadoopServerRole": { "code": "M", "codeName": "Master Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) Server Pending State" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Server Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "FKR", "zoneCode": "FKR-2", "vpcNo": "**65", "vpcName": "vpcTestName", "subnetNo": "**46", "subnetName": "subnetTestName", "privateIp": "192.168.***.***", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2023-02-08T21:26:09+0900" }, { "cloudHadoopServerName": "d-001-****-15iw-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Date Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) Server Pending State" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Server Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "FKR", "zoneCode": "FKR-2", "vpcNo": "**65", "vpcName": "vpcTestName", "subnetNo": "**46", "subnetName": "subnetTestName", "privateIp": "192.168.***.***", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2023-02-08T21:26:09+0900" }, { "cloudHadoopServerName": "d-002-****-15ix-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Date Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC) Server Pending State" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Server Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "FKR", "zoneCode": "FKR-2", "vpcNo": "**65", "vpcName": "vpcTestName", "subnetNo": "**46", "subnetName": "subnetTestName", "privateIp": "192.168.***.***", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2023-02-08T21:26:09+0900" } ] } ], "requestId": "aa789745-****-****-a4c2-****82eaa9ed", "returnCode": "0", "returnMessage": "success" } } ``` ```xml b8828eca-c3f8-****-****-****026b4b94 0 success 1 ***4904 ******* creating INIT CLOUD DATABASE(VPC) Init State CREAT CLOUD DATABASE(VPC) Creat OP CORE_HADOOP_WITH_SPARK Core Hadoop with Spark : HDFS(3.1.1), YARN(3.1.1), Zookeeper(3.4.6), Ranger(1.2.0), HIVE(3.1.0), Hue(4.3.0), Zepplin Notebook(0.8.0), Spark(2.4.8) HADOOP1.6 Cloud Hadoop 1.6 e-001-****-mel-hd ***user **** **** SW.VCHDP.LNX64.CNTOS.0708.HDP.16.B050 true G2 2021-11-09T18:55:29+0900 ***28 **** E Edge Node creating PEND CLOUD DATABASE(VPC) Server Pending State CREAT CLOUD DATABASE(VPC) Server Create OP SVR.VCHDP.EDGND.STAND.C004.M016.NET.HDD.B050.G002 FKR FKR-2 **65 ***** **23 ***** ***.***.***.*** false 107374182400 4 17179869184 2021-11-09T18:55:29+0900 **** M Master Node creating PEND CLOUD DATABASE(VPC) Server Pending State CREAT CLOUD DATABASE(VPC) Server Create OP SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002 FKR FKR-2 **65 ***** **23 ***** ***.***.***.*** false SSD SSD 107374182400 4 17179869184 2021-11-09T18:55:29+0900 **** M Master Node creating PEND CLOUD DATABASE(VPC) Server Pending State CREAT CLOUD DATABASE(VPC) Server Create OP SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002 FKR FKR-2 **65 ***** **23 ***** ***.***.***.*** false SSD SSD 107374182400 4 17179869184 2021-11-09T18:55:29+0900 **** D Date Node creating PEND CLOUD DATABASE(VPC) Server Pending State CREAT CLOUD DATABASE(VPC) Server Create OP SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002 FKR FKR-2 **65 ***** **23 ***** ***.***.***.*** false SSD SSD 107374182400 4 17179869184 2021-11-09T18:55:29+0900 **** D Date Node creating PEND CLOUD DATABASE(VPC) Server Pending State CREAT CLOUD DATABASE(VPC) Server Create OP SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002 FKR FKR-2 **65 ***** **23 ***** ***.***.***.*** false SSD SSD 107374182400 4 17179869184 2021-11-09T18:55:29+0900 ```