---
title: "getCloudHadoopNotebookInstanceList"
slug: "cli-vhadoop-getcloudhadoopnotebookinstancelist"
tags: ["Cloud Hadoop"]
updated: 2026-06-25T09:10:26Z
published: 2026-06-25T09:10:26Z
canonical: "cli-fin.ncloud-docs.com/cli-vhadoop-getcloudhadoopnotebookinstancelist"
---

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

# getCloudHadoopNotebookInstanceList

## 개요<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 조회 결과의 첫 번째 리전 선택                                                                                                                                                                           |
| zoneCode                                | No | String | | - ZONE 코드<br/>Cloud Hadoop Notebook 인스턴스 리스트가 조회될 Zone 결정 가능<br/>[getZoneList](/docs/cli-vserver-server-common-getzonelist) 액션을 통해 획득 가능                                                                                                                                                                       |
| vpcNo                                   | No | String | | - VPC 번호<br/>Cloud Hadoop Notebook 인스턴스 리스트가 조회될 VPC 결정 가능<br/>[getCloudHadoopTargetVpcList](/docs/cli-vhadoop-getcloudhadooptargetvpclist) 액션을 통해 획득 가능                                                                                                                                                     |
| subnetNo                                | No | String | | - Subnet 번호<br/>Cloud Hadoop Notebook 인스턴스 리스트가 조회될 Subnet 결정 가능<br/>[getCloudHadoopTargetSubnetList](/docs/cli-vhadoop-getcloudhadooptargetsubnetlist) 액션을 통해 획득 가능                                                                                                                                         |
| cloudHadoopNotebookName                 | No | String | | - Cloud Hadoop Notebook 이름<br/>Cloud Hadoop Notebook 이름으로 필터링하여 검색 가능<br/>[getCloudHadoopNotebookInstanceList](/docs/cli-vhadoop-getcloudhadoopnotebookinstancelist) 액션을 통해 획득 가능                                                                                                                            |
| cloudHadoopNotebookInstanceNoList       | No | List&lt;String&gt; | | - Cloud Hadoop Notebook 인스턴스 번호 리스트<br/>Cloud Hadoop Notebook 인스턴스 번호로 필터링하여 검색 가능<br/>[getCloudHadoopNotebookInstanceList](/docs/cli-vhadoop-getcloudhadoopnotebookinstancelist) 액션을 통해 획득 가능<br/>  <예시> cloudHadoopNotebookInstanceNoList.1=1234&cloudHadoopNotebookInstanceNoList.2=2345                  |
| cloudHadoopNotebookServerName           | No | String | | - Cloud Hadoop Notebook 서버 이름<br/>Cloud Hadoop Notebook 서버 이름으로 필터링하여 검색 가능<br/>[getCloudHadoopNotebookInstanceList](/docs/cli-vhadoop-getcloudhadoopnotebookinstancelist) 액션을 통해 획득 가능                                                                                                                      |
| cloudHadoopNotebookServerInstanceNoList | No | List&lt;String&gt; | | - Cloud Hadoop Notebook 서버 인스턴스 번호 리스트<br/>Cloud Hadoop Notebook 서버 인스턴스 번호로 필터링하여 검색 가능<br/>[getCloudHadoopNotebookInstanceList](/docs/cli-vhadoop-getcloudhadoopnotebookinstancelist) 액션을 통해 획득 가능<br/> <예시> cloudHadoopNotebookServerInstanceNoList.1=1234&cloudHadoopNotebookServerInstanceNoList.2=2345 |
| pageNo                                  | No | Integer | Min: 0 | - 페이징된 결과의 페이지 번호<br/>결괏값을 pageNo, pageSize를 이용하여 페이징 처리 가능                                                                                                                                                                                                                                                           |
| pageSize                                | Conditional | Integer | Min: 1 | - 페이징 시 보여줄 각 페이지 사이즈<br/>결괏값을 pageNo, pageSize를 이용하여 페이징 처리 가능<br/> - pageNo 입력 시 입력 필수                                                                                                                                                                                                                              |
| 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 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 getCloudHadoopNotebookInstanceList --regionCode FKR --zoneCode FKR-1 --vpcNo ***87 --subnetNo ***32 --cloudHadoopNotebookName test-**** --cloudHadoopNotebookInstanceNoList.1 178**** --cloudHadoopNotebookServerName test-**** --cloudHadoopServerNotebookInstanceNoList.1 1781*** --pageNo 0 --pageSize 10
```

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

```json
{
  "getCloudHadoopNotebookInstanceListResponse": {
    "totalRows": 1,
    "cloudHadoopNotebookInstanceList": [
      {
        "cloudHadoopNotebookInstanceNo": "****",
        "cloudHadoopNotebookName": "****",
        "cloudHadoopNotebookImageProductCode": "SW.VCHDP.LNX64.CNTOS.0708.HDNTB.10.B050",
        "cloudHadoopNotebookInstanceStatusName": "running",
        "cloudHadoopNotebookInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Created State"
        },
        "cloudHadoopNotebookInstanceOperation": {
          "code": "NULL",
          "codeName": "CLOUD DATABASE(VPC) Null OP"
        },
        "cloudHadoopNotebookVersion": {
          "code": "NOTEBOOK1.0",
          "codeName": "Notebook 1.0"
        },
        "cloudHadoopNotebookComponent": {
          "code": "NOTEBOOK_1.0",
          "codeName": "Jupyter notebook 6.4.10 , JupyterLab : 3.2.9"
        },
        "cloudHadoopNotebookServerInstanceList": [
          {
            "cloudHadoopNotebookServerInstanceNo": ****,
            "cloudHadoopNotebookServerName": "n-001-****-15dk-hd",
            "cloudHadoopNotebookServerInstanceStatusName": "running",
            "cloudHadoopNotebookServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) Server Running State"
            },
            "cloudHadoopNotebookServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) Server Null OP"
            },
            "cloudHadoopNotebookServerRole": {
              "code": "N",
              "codeName": "Notebook Node"
            },
            "regionCode": "FKR",
            "zoneCode": "FKR-2",
            "vpcNo": "**77",
            "subnetNo": "**47",
            "cpuCount": 4,
            "memorySize": 17179869184,
            "dataStorageSize": 107374182400
          }
        ]
      }
    ],
    "requestId": "182ae8cd-1c30-****-9954-****7a88aeb8",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

```xml
<getCloudHadoopNotebookInstanceListResponse>
  <requestId>4e1ac8f5-b411-****-83fb-****aa1c1a7e</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <cloudHadoopNotebookInstanceList>
    <cloudHadoopNotebookInstance>
      <cloudHadoopNotebookInstanceNo>****</cloudHadoopNotebookInstanceNo>
      <cloudHadoopNotebookName>****</cloudHadoopNotebookName>
      <cloudHadoopNotebookImageProductCode>SW.VCHDP.LNX64.CNTOS.0708.HDNTB.10.B050</cloudHadoopNotebookImageProductCode>
      <cloudHadoopNotebookInstanceStatusName>running</cloudHadoopNotebookInstanceStatusName>
      <cloudHadoopNotebookInstanceStatus>
        <code>CREAT</code>
        <codeName>CLOUD DATABASE(VPC) Created State</codeName>
      </cloudHadoopNotebookInstanceStatus>
      <cloudHadoopNotebookInstanceOperation>
        <code>NULL</code>
        <codeName>CLOUD DATABASE(VPC) Null 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>
      <cloudHadoopNotebookServerInstanceList>
        <cloudHadoopNotebookServerInstance>
          <cloudHadoopNotebookServerInstanceNo>****</cloudHadoopNotebookServerInstanceNo>
          <cloudHadoopNotebookServerName>n-001-****-15dk-hd</cloudHadoopNotebookServerName>
          <cloudHadoopNotebookServerInstanceStatusName>running</cloudHadoopNotebookServerInstanceStatusName>
          <cloudHadoopNotebookServerInstanceStatus>
            <code>RUN</code>
            <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
          </cloudHadoopNotebookServerInstanceStatus>
          <cloudHadoopNotebookServerInstanceOperation>
            <code>NOOP</code>
            <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
          </cloudHadoopNotebookServerInstanceOperation>
          <cloudHadoopNotebookServerRole>
            <code>N</code>
            <codeName>Notebook Node</codeName>
          </cloudHadoopNotebookServerRole>
          <regionCode>FKR</regionCode>
          <zoneCode>FKR-2</zoneCode>
          <vpcNo>**77</vpcNo>
          <subnetNo>**47</subnetNo>
          <cpuCount>4</cpuCount>
          <memorySize>17179869184</memorySize>
          <dataStorageSize>107374182400</dataStorageSize>
        </cloudHadoopNotebookServerInstance>
      </cloudHadoopNotebookServerInstanceList>
    </cloudHadoopNotebookInstance>
  </cloudHadoopNotebookInstanceList>
</getCloudHadoopNotebookInstanceListResponse>
```