---
title: "createCloudHadoopNotebookInstance"
slug: "cli-vhadoop-createcloudhadoopnotebookinstance"
tags: ["Cloud Hadoop"]
updated: 2026-04-23T09:04:51Z
published: 2026-04-23T09:07:28Z
---

> ## 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.

# createCloudHadoopNotebookInstance

## 개요<a name="개요"></a>

Cloud Hadoop Notebook 인스턴스를 생성합니다.

## 요청<a name="요청"></a>

### 요청 파라미터<a name="요청파라미터"></a>

| 파라미터명                         | 필수 여부 | 타입                 | 제약 사항                                                                                                                                        | 설명                                                                                                                                                                                                                                                                                                                     |
|-------------------------------|--|--------------------|----------------------------------------------------------------------------------------------------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|
| regionCode                    | No | String             |                                                                                                                                              | - 리전 코드<br/>[getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해 획득 가능<br/> Default: getRegionList 조회 결과의 첫 번째 리전 선택                                                                                                                                                                             |
| cloudHadoopNotebookName        | Yes | String             | 영어, 숫자, 붙임표( - ), 한글만 입력 가능<br/> 첫 글자와 마지막 글자는 영문자(소문자) 또는 숫자만 가능<br/> Min: 3 <br/> Max: 15                                                  | - Cloud Hadoop Notebook 이름<br/>중복으로 사용할 수 없음                                                                                                                                                                                                                                                                                           |
| cloudHadoopNotebookImageProductCode   | No | String             |                                                                                                                                              | - Cloud Hadoop Notebook 이미지 상품 코드<br/>[getCloudHadoopNotebookImageProductList](/docs/cli-vhadoop-getcloudhadoopnotebookimageproductlist) 액션의 productCode로 획득 가능<br/>입력하지 않을 경우 Default값으로 생성<br/>  Default : Cloud Hadoop Notebook 최신 버전                                                               
| cloudHadoopNotebookComponent    | Yes | String             |                                                                                                                                              | - Cloud Hadoop Notebook Component<br/>[getCloudHadoopNotebookComponentList](/docs/cli-vhadoop-getcloudhadoopnotebookcomponentlist) 액션을 통해 획득 가능|
| loginKeyName                  | Yes | String             |                                                                                                                                              | - 인증키 이름 <br/>[getCloudHadoopLoginKeyList](/docs/cli-vhadoop-getcloudhadooploginkeylist) 액션을 통해 획득 가능<br/> 노드에 직접 접속할 때 필요한 SSH 인증키를 설정                                                                                                                                                          |
| notebookNodeProductCode         | No | String             |                                                                                                                                              | - Cloud Hadoop Notebook 서버 상품 코드<br/>생성할 Cloud Hadoop Notebook 인스턴스의 서버 스펙 결정 가능<br/>[getCloudHadoopNotebookProductList](/docs/cli-vhadoop-getcloudhadoopnotebookproductlist) 액션의 infraResourceDetailTypeCode = 'NTBND'로 설정하여 호출 시 획득 가능<br/> Default: 최소 사양으로 선택됨 <br> 최소 사양의 기준: 1. 메모리 2. CPU   |
| notebookNodeSubnetNo              | Yes | String             |                                                                                                                                              | - Notebook 노드의 Subent 번호<br/>Notebook노드를 위치 시킬 Subnet 선택 가능<br/>Notebook노드는 Private/Public Subnet안에 위치<br/>notebookNodeSubnetNo는 [getCloudHadoopTargetSubnetList](/docs/cli-vhadoop-getcloudhadooptargetsubnetlist) 액션을 통해 획득 가능                                                                                                                          |
| bucketName                    | Yes | String             |                                                                                                                                              | - 버킷 이름<br/>Object Storage에 데이터를 저장하기 위한 공간을 의미<br/>[getCloudHadoopNotebookBucketList](/docs/cli-vhadoop-getcloudhadoopnotebookbucketlist) 액션을 통해 획득 가능                                                                                                                                                            |
| notebookNodeDataStorageTypeCode | Yes | String             | SSD \| HDD                                                                                                                                                                                                                                                                                                                    | - Notebook 노드의 데이터 스토리지 타입 코드<br/>설치 이후에 데이터 스토리지 타입은 변경되지 않음<br/>Options: SSD \| HDD<br/> Default: SSD |
| notebookNodeDataStorageSize     | Yes | Integer            | Min: 100<br/> Max: 2000<br/>or<br/>4000, 6000                                                                                                                      | - Notebook 노드의 데이터 스토리지 크기<br/>100GB ~ 2000GB 까지 10GB 단위로 입력 가능 <br/>4000GB, 6000GB 도 사용  가능                                                                                                                                                                                                                               |
| useNotebookBlockStorage          | No | Boolean            |                                                                                                                                              | - Cloud Hadoop Notebook 데이터 스토리지 사용 여부<br/>Default: false                                                                                                                                                                                                                                                            |
| cloudHadoopInstanceNo          | Yes | String            |                                                                                                                                              | - Notebook과 연동하려는 Cloud Hadoop 클러스터 번호 <br/> [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 액션을 통해서 획득할 수 있음 |
| output            | No | String             |                                                                                                                                              | - 응답 결과의 포맷 타입<br/>Options: xml \| json<br/>Default: xml |



## 응답<a name="응답"></a>

### 응답 데이터 타입<a name="응답데이터타입"></a>

- CloudHadoopNotebookInstanceList 타입

| CloudHadoopNotebookInstanceList extends CommonResponse                                               |
|------------------------------------------------------------------------------------------------------|
| private Integer totalRows;                                                                           |
| private List&lt;CloudHadoopNotebookInstance&gt; cloudHadoopNotebookInstanceList = new ArrayList<>(); |

| CloudHadoopNotebookInstance                                                                          |
|----------------------------------------------------------------------------------------------|
| private String cloudHadoopNotebookInstanceNo;                                                |
| private String cloudHadoopNotebookName;                                                      |
| private String cloudHadoopNotebookInstanceStatusName;                                        |
| private CommonCode cloudHadoopNotebookInstanceStatus;                                        |
| private CommonCode cloudHadoopNotebookInstanceOperation;                                     |
| private CloudHadoopNotebookComponent cloudHadoopNotebookComponent;                           |
| private CloudHadoopNotebookVersion cloudHadoopNotebookVersion;                               |
| private String clusterDirectAccessAccount;                                                   |
| private String loginKey;                                                                     |
| private String objectStorageBucket;                                                          |
| private String cloudHadoopNotebookImageProductCode;                                          |
| private String domain;                                                                       |
| private AccessControlGroupNoList accessControlGroupNoList;                                   |
| private String generationCode;|
| private Date createDate;                                                                     |
| private String cloudHadoopClusterName;                                                       |
| private Boolean useNotebookBlockStorage;                                                     |
| private List&lt;CloudHadoopNotebookServerInstance&gt; cloudHadoopNotebookServerInstanceList; |

| CloudHadoopNotebookComponent |
|------------------------------|
| private String code;         |
| private String codeName;     |

| CloudHadoopNotebookVersion |
|----------------------------|
| private String code;       |
| private String codeName;   |

| AccessControlGroupNoList |
| ---------- |
|private List&lt;String&gt; accessControlGroupNoList = new ArrayList<>(); |

| CloudHadoopNotebookServerInstance                              |
|----------------------------------------------------------------|
| private String cloudHadoopNotebookServerInstanceNo;            |
| private String cloudHadoopNotebookServerName;                  |
| private String cloudHadoopNotebookServerInstanceStatusName;    |
| private CommonCode cloudHadoopNotebookServerInstanceStatus;    |
| private CommonCode cloudHadoopNotebookServerInstanceOperation; |
| private CommonCode cloudHadoopNotebookServerRole;              |
| private String regionCode;                                     |
| private String vpcNo;                                          |
| private String subnetNo;                                       |
| private Date createDate;                                       |
| private Date uptime;                                           |
| private String zoneCode;                                       |
| private Long memorySize;                                       |
| private Integer cpuCount;                                      |
| private Boolean isPublicSubnet;                                |
| private Long dataStorageSize;                                  |
| private String cloudHadoopNotebookProductCode;                 |
| private CommonCode dataStorageType;                            |

## 예시<a name="예시"></a>

### 호출<a name="호출"></a>

```http
ncloud vhadoop createCloudHadoopNotebookInstance --regionCode FKR --cloudHadoopNotebookName test*** --cloudHadoopNotebookImageProductCode SW.VCHDP.LNX64.CNTOS.0708.HDNTB.10.B050 --cloudHadoopNotebookComponent NOTEBOOK_COMPONENT_CODE1 --loginKeyName key**** --notebookNodeProductCode SVR.VCHDP.NTBND.STAND.C004.M016.NET.HDD.B050.G002 --notebookNodeSubnetNo 12** --bucketName buc*** --notebookNodeDataStorageTypeCode SSD --notebookNodeDataStorageSize 100 --useNotebookBlockStorage true --cloudHadoopInstanceNo 12**
```

### 응답<a name="응답"></a>

```json
{
  "createCloudHadoopNotebookInstanceResponse": {
    "totalRows": 1,
    "cloudHadoopNotebookInstanceList": [
      {
        "cloudHadoopNotebookInstanceNo": "****154",
        "cloudHadoopNotebookName": "****",
        "cloudHadoopNotebookImageProductCode": "SW.VCHDP.LNX64.CNTOS.0708.HDNTB.10.B050",
        "cloudHadoopNotebookInstanceStatusName": "creating",
        "cloudHadoopNotebookInstanceStatus": {
          "code": "INIT",
          "codeName": "CLOUD DATABASE(VPC) Init State"
        },
        "cloudHadoopNotebookInstanceOperation": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Creat OP"
        },
        "cloudHadoopNotebookVersion": {
          "code": "NOTEBOOK1.0",
          "codeName": "Notebook 1.0"
        },
        "cloudHadoopNotebookComponent": {
          "code": "NOTEBOOK_1.0",
          "codeName": "Jupyter notebook 6.4.10 , JupyterLab : 3.2.9"
        },
        "generationCode": "G2",
        "createDate": "2023-02-07T20:40:50+0900",
        "loginKey": "newkey",
        "objectStorageBucket": "****c",
        "accessControlGroupNoList": [],
        "cloudHadoopClusterName": "****",
        "clusterDirectAccessAccount": "sshuser",
        "useNotebookBlockStorage": true,
        "cloudHadoopNotebookServerInstanceList": [
          {
            "cloudHadoopNotebookServerName": "n-001-****-15dk-hd",
            "cloudHadoopNotebookServerInstanceStatusName": "creating",
            "cloudHadoopNotebookServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) Server Pending State"
            },
            "cloudHadoopNotebookServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) Server Create OP"
            },
            "cloudHadoopNotebookServerRole": {
              "code": "N",
              "codeName": "Notebook Node"
            }, 
            "cloudHadoopNotebookProductCode": "SVR.VCHDP.NTBND.STAND.C004.M016.NET.HDD.B050.G002",
            "regionCode": "FKR",
            "zoneCode": "FKR-2",
            "vpcNo": "**77",
            "subnetNo": "**47",
            "cpuCount": 4,
            "memorySize": 17179869184,
            "dataStorageSize": 107374182400,
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
             },
            "createDate": "2023-02-07T20:40:50+0900"
          }
        ]
      }
    ],
    "requestId": "9a425589-09e1-****-94df-****2dcca882",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

```xml
<createCloudHadoopNotebookInstanceResponse>
  <requestId>ff98794d-34b7-****-8154-****afa479cb</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <cloudHadoopNotebookInstanceList>
    <cloudHadoopNotebookInstance>
      <cloudHadoopNotebookInstanceNo>****068</cloudHadoopNotebookInstanceNo>
      <cloudHadoopNotebookName>****</cloudHadoopNotebookName>
      <cloudHadoopNotebookImageProductCode>SW.VCHDP.LNX64.CNTOS.0708.HDNTB.10.B050</cloudHadoopNotebookImageProductCode>
      <cloudHadoopNotebookInstanceStatusName>creating</cloudHadoopNotebookInstanceStatusName>
      <cloudHadoopNotebookInstanceStatus>
        <code>INIT</code>
        <codeName>CLOUD DATABASE(VPC) Init State</codeName>
      </cloudHadoopNotebookInstanceStatus>
      <cloudHadoopNotebookInstanceOperation>
        <code>CREAT</code>
        <codeName>CLOUD DATABASE(VPC) Creat OP</codeName>
      </cloudHadoopNotebookInstanceOperation>
      <cloudHadoopNotebookVersion>
        <code>NOTEBOOK1.0</code>
        <codeName>Notebook 1.0</codeName>
      </cloudHadoopNotebookVersion>
      <cloudHadoopNotebookComponent>
        <code>NOTEBOOK_COMPONENT_CODE1</code>
        <codeName>Jupyter notebook 6.4.10 , JupyterLab : 3.2.9</codeName>
      </cloudHadoopNotebookComponent>
      <generationCode>G2</generationCode>
      <createDate>2023-02-07T20:16:55+0900</createDate>
      <loginKey>newkey</loginKey>
      <objectStorageBucket>aabbcc</objectStorageBucket>
      <accessControlGroupNoList/>
      <cloudHadoopClusterName>****</cloudHadoopClusterName>
      <clusterDirectAccessAccount>sshuser</clusterDirectAccessAccount>
      <useNotebookBlockStorage>true</useNotebookBlockStorage>
      <cloudHadoopNotebookServerInstanceList>
        <cloudHadoopNotebookServerInstance>
          <cloudHadoopNotebookServerName>n-001-****-15d8-hd</cloudHadoopNotebookServerName>
          <cloudHadoopNotebookServerInstanceStatusName>creating</cloudHadoopNotebookServerInstanceStatusName>
          <cloudHadoopNotebookServerInstanceStatus>
            <code>PEND</code>
            <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
          </cloudHadoopNotebookServerInstanceStatus>
          <cloudHadoopNotebookServerInstanceOperation>
            <code>CREAT</code>
            <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
          </cloudHadoopNotebookServerInstanceOperation>
          <cloudHadoopNotebookServerRole>
            <code>N</code>
            <codeName>Notebook Node</codeName>
          </cloudHadoopNotebookServerRole> 
          <cloudHadoopNotebookProductCode>SVR.VCHDP.NTBND.STAND.C004.M016.NET.HDD.B050.G002</cloudHadoopNotebookProductCode>
          <regionCode>FKR</regionCode>
          <zoneCode>FKR-2</zoneCode>
          <vpcNo>**77</vpcNo>
          <subnetNo>**47</subnetNo>
          <cpuCount>4</cpuCount>
          <memorySize>17179869184</memorySize>
          <dataStorageSize>107374182400</dataStorageSize>
          <isPublicSubnet>false</isPublicSubnet>
          <dataStorageType>
    <code>SSD</code>
    <codeName>SSD</codeName>
</dataStorageType> 
          <createDate>2023-02-07T20:16:55+0900</createDate>
        </cloudHadoopNotebookServerInstance>
      </cloudHadoopNotebookServerInstanceList>
    </cloudHadoopNotebookInstance>
  </cloudHadoopNotebookInstanceList>
</createCloudHadoopNotebookInstanceResponse>
```