---
title: "getCloudHadoopInstanceList"
slug: "cli-vhadoop-getcloudhadoopinstancelist"
tags: ["Cloud Hadoop", "VPC"]
updated: 2026-04-23T08:56:49Z
published: 2026-04-23T08:58:50Z
canonical: "cli.ncloud-docs.com/cli-vhadoop-getcloudhadoopinstancelist"
---

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

# getCloudHadoopInstanceList

<p class="platform-info type-vpc">VPC 환경에서 이용 가능합니다.</p>

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

Cloud Hadoop 인스턴스 리스트를 조회합니다.

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

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

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| ----- | ----- | ----- | ----- | ----- |
| regionCode | No | String | | 리전 코드<ul><li> Cloud Hadoop 인스턴스 리스트가 조회될 리전(Region)을 결정 가능 </li><li> regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능 </li><li>Default : getRegionList 조회 결과의 첫 번째 리전 선택 </li></ul> |
| zoneCode | No | String | |  ZONE 코드<ul><li>Cloud Hadoop 인스턴스 리스트가 조회될 Zone 결정 가능</li><li>zoneCode는 [getZoneList](/docs/cli-vserver-server-common-getzonelist) 액션을 통해서 획득 가능 </li></ul> |
| vpcNo | No | String | | VPC 번호<ul><li>Cloud Hadoop 인스턴스 리스트가 조회될 VPC 결정 가능 </li><li>vpcNo는 [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 액션을 통해서 획득 가능 </li></ul> |
| subnetNo | No | String | | Subnet 번호<ul><li>Cloud Hadoop 인스턴스 리스트가 조회될 Subnet 결정 가능</li><li> SubnetNo는 [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 액션을 통해서 획득 가능 </li></ul>  |
| cloudHadoopClusterName | No | String | |  Cloud Hadoop 클러스터 이름<ul><li> Cloud Hadoop 클러스터 이름으로 필터링하여 검색할 수 있음 </li><li> cloudHadoopClusterName은 [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 액션을 통해서 획득 가능 </li></ul> |
| cloudHadoopInstanceNoList | No | List&lt;String&gt; | | Cloud Hadoop 인스턴스 번호 리스트<ul><li> Cloud Hadoop 인스턴스 번호로 필터링하여 검색 가능 </li><li> cloudHadoopInstanceNoList는 [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 액션을 통해서 획득 가능 </li><li> (예시) cloudHadoopInstanceNoList 1234 2345  </li></ul>|
| cloudHadoopServerName | No | String | | Cloud Hadoop 서버 이름 <ul><li> Cloud Hadoop 서버 이름으로 필터링하여 검색 가능  </li><li> cloudHadoopServerName은 [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 액션을 통해서 획득 가능 </li></ul> |
| cloudHadoopServerInstanceNoList | No | List&lt;String&gt; | |  Cloud Hadoop 서버 인스턴스 번호 리스트<ul><li> Cloud Hadoop 서버 인스턴스 번호로 필터링하여 검색 가능 </li><li> cloudHadoopServerInstanceNoList [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 액션을 통해서 획득 가능  </li><li> (예시)  cloudHadoopServerInstanceNoList1234 2345 </li></ul> |
| pageNo | No | Integer | Min: 0 | 페이징된 결과의 페이지 번호 <ul><li>결괏값을 pageNo, pageSize를 이용하여 페이징 처리 가능 </li></ul> |
| pageSize | Conditional | Integer | Min: 1 | 페이징 시 보여줄 각 페이지 사이즈<ul><li> 결괏값을 pageNo, pageSize를 이용하여 페이징 처리 가능  </li><li> pageNo 입력 시 입력 필수 </li></ul> |
| output | No | String | | 응답 결과의 포맷 타입<ul><li> Options : xml \| json </li><li> Default : json </li></ul> |

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

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

- CloudHadoopInstanceList 타입

| CloudHadoopInstanceList extends CommonResponse |
| ---------- |
|private Integer totalRows;|
|private List&lt;CloudHadoopInstance&gt; 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&lt;CloudHadoopAddOn&gt; 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 Date createDate;|
|private Boolean useDataCatalog;|
|private List&lt;CloudHadoopServerInstance&gt; 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&lt;String&gt; 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;|

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

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

```http
ncloud vhadoop getCloudHadoopInstanceList --regionCode KR --zoneCode KR-1 --vpcNo ***87 --subnetNo ***32 --cloudHadoopClusterName test-**** --cloudHadoopInstanceNoList 178**** --cloudHadoopServerName test-**** --cloudHadoopServerInstanceNoList 1781*** --pageNo 0 --pageSize 10
```

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

```json
{
  "getCloudHadoopInstanceListResponse": {
    "totalRows": 1,
    "cloudHadoopInstanceList": [
      {
        "cloudHadoopInstanceNo": "2773990",
        "cloudHadoopClusterName": "dsadsad",
        "cloudHadoopInstanceStatusName": "running",
        "cloudHadoopInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Created State"
        },
        "cloudHadoopInstanceOperation": {
          "code": "NULL",
          "codeName": "CLOUD DATABASE(VPC) Null 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"
        },
        "cloudHadoopImageProductCode": "SW.VCHDP.LNX64.CNTOS.0708.HDP.20.B050",
        "cloudHadoopServerInstanceList": [
          {
            "cloudHadoopServerInstanceNo": "2773999",
            "cloudHadoopServerName": "e-001-dsadsad-15fd-hd",
            "cloudHadoopServerRole": {
              "code": "E",
              "codeName": "Edge Node"
            },
            "cloudHadoopServerInstanceStatusName": "running",
            "cloudHadoopServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) Server Running State"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) Server Null OP"
            },
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "3977",
            "vpcName": "vpcTestName",
            "subnetNo": "5747",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          },
          {
            "cloudHadoopServerInstanceNo": "2773991",
            "cloudHadoopServerName": "m-001-dsadsad-15fb-hd",
            "cloudHadoopServerRole": {
              "code": "M",
              "codeName": "Master Node"
            },
            "cloudHadoopServerInstanceStatusName": "running",
            "cloudHadoopServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) Server Running State"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) Server Null OP"
            },
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "3977",
            "vpcName": "vpcTestName",
            "subnetNo": "5747",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          },
          {
            "cloudHadoopServerInstanceNo": "2773995",
            "cloudHadoopServerName": "m-002-dsadsad-15fc-hd",
            "cloudHadoopServerRole": {
              "code": "M",
              "codeName": "Master Node"
            },
            "cloudHadoopServerInstanceStatusName": "running",
            "cloudHadoopServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) Server Running State"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) Server Null OP"
            },
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "3977",
            "vpcName": "vpcTestName",
            "subnetNo": "5747",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          },
          {
            "cloudHadoopServerInstanceNo": "2774002",
            "cloudHadoopServerName": "d-001-dsadsad-15fe-hd",
            "cloudHadoopServerRole": {
              "code": "D",
              "codeName": "Date Node"
            },
            "cloudHadoopServerInstanceStatusName": "running",
            "cloudHadoopServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) Server Running State"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) Server Null OP"
            },
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "3977",
            "vpcName": "vpcTestName",
            "subnetNo": "5747",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          },
          {
            "cloudHadoopServerInstanceNo": "2774006",
            "cloudHadoopServerName": "d-002-dsadsad-15ff-hd",
            "cloudHadoopServerRole": {
              "code": "D",
              "codeName": "Date Node"
            },
            "cloudHadoopServerInstanceStatusName": "running",
            "cloudHadoopServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) Server Running State"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) Server Null OP"
            },
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "3977",
            "vpcName": "vpcTestName",
            "subnetNo": "5747",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          },
          {
            "cloudHadoopServerInstanceNo": "2775743",
            "cloudHadoopServerName": "d-003-dsadsad-15ir-hd",
            "cloudHadoopServerRole": {
              "code": "D",
              "codeName": "Date Node"
            },
            "cloudHadoopServerInstanceStatusName": "running",
            "cloudHadoopServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) Server Running State"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) Server Null OP"
            },
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "3977",
            "vpcName": "vpcTestName",
            "subnetNo": "5747",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          }
        ]
      }
    ],
    "requestId": "dfb64c78-5b94-44b1-8514-e5d14158b46b",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

```xml
<getCloudHadoopInstanceListResponse>
    <requestId>74dd4dd4-9fa3-49a9-b001-86cfd2931a4a</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudHadoopInstanceList>
        <cloudHadoopInstance>
            <cloudHadoopInstanceNo>1912200</cloudHadoopInstanceNo>
            <cloudHadoopClusterName>fasdasd</cloudHadoopClusterName>
            <cloudHadoopInstanceStatusName>running</cloudHadoopInstanceStatusName>
            <cloudHadoopInstanceStatus>
                <code>CREAT</code>
                <codeName>CLOUD DATABASE(VPC) Created State</codeName>
            </cloudHadoopInstanceStatus>
            <cloudHadoopInstanceOperation>
                <code>NULL</code>
                <codeName>CLOUD DATABASE(VPC) Null OP</codeName>
            </cloudHadoopInstanceOperation>
            <cloudHadoopClusterType>
                <code>CORE_HADOOP_WITH_SPARK</code>
                <codeName>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.3.2)</codeName>
            </cloudHadoopClusterType>
            <cloudHadoopVersion>
                <code>HADOOP1.5</code>
                <codeName>Cloud Hadoop 1.5</codeName>
            </cloudHadoopVersion>
            <cloudHadoopImageProductCode>SW.VCHDP.LNX64.CNTOS.0708.HDP.15.B050</cloudHadoopImageProductCode>
            <cloudHadoopServerInstanceList>
                <cloudHadoopServerInstance>
                    <cloudHadoopServerInstanceNo>****</cloudHadoopServerInstanceNo>
                    <cloudHadoopServerName>****</cloudHadoopServerName>
                    <cloudHadoopServerRole>
                        <code>D</code>
                        <codeName>Date Node</codeName>
                    </cloudHadoopServerRole>
                    <cloudHadoopServerInstanceStatusName>running</cloudHadoopServerInstanceStatusName>
                    <cloudHadoopServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudHadoopServerInstanceStatus>
                    <cloudHadoopServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudHadoopServerInstanceOperation>
                    <regionCode>KR</regionCode>
                    <zoneCode>KR-2</zoneCode>
                    <vpcNo>**65</vpcNo>
                    <vpcName>*****</vpcName>
                    <subnetNo>**23</subnetNo>
                    <subnetName>*****</subnetName>
                    <privateIp>***.***.***.***</privateIp>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>4</cpuCount>
                    <memorySize>34359738368</memorySize>
                </cloudHadoopServerInstance>
                <cloudHadoopServerInstance>
                    <cloudHadoopServerInstanceNo>****</cloudHadoopServerInstanceNo>
                    <cloudHadoopServerName>****</cloudHadoopServerName>
                    <cloudHadoopServerRole>
                        <code>D</code>
                        <codeName>Date Node</codeName>
                    </cloudHadoopServerRole>
                    <cloudHadoopServerInstanceStatusName>running</cloudHadoopServerInstanceStatusName>
                    <cloudHadoopServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudHadoopServerInstanceStatus>
                    <cloudHadoopServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudHadoopServerInstanceOperation>
                    <regionCode>KR</regionCode>
                    <zoneCode>KR-2</zoneCode>
                    <vpcNo>**65</vpcNo>
                    <vpcName>*****</vpcName>
                    <subnetNo>**23</subnetNo>
                    <subnetName>*****</subnetName>
                    <privateIp>***.***.***.***</privateIp>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>4</cpuCount>
                    <memorySize>34359738368</memorySize>
                </cloudHadoopServerInstance>
                <cloudHadoopServerInstance>
                    <cloudHadoopServerInstanceNo>****</cloudHadoopServerInstanceNo>
                    <cloudHadoopServerName>****</cloudHadoopServerName>
                    <cloudHadoopServerRole>
                        <code>E</code>
                        <codeName>Edge Node</codeName>
                    </cloudHadoopServerRole>
                    <cloudHadoopServerInstanceStatusName>running</cloudHadoopServerInstanceStatusName>
                    <cloudHadoopServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudHadoopServerInstanceStatus>
                    <cloudHadoopServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudHadoopServerInstanceOperation>
                    <regionCode>KR</regionCode>
                    <zoneCode>KR-2</zoneCode>
                    <vpcNo>1665</vpcNo>
                    <vpcName>*****</vpcName>
                    <subnetNo>2020</subnetNo>
                    <subnetName>*****</subnetName>
                    <privateIp>***.***.***.***</privateIp>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>4</cpuCount>
                    <memorySize>34359738368</memorySize>
                </cloudHadoopServerInstance>
                <cloudHadoopServerInstance>
                    <cloudHadoopServerInstanceNo>****</cloudHadoopServerInstanceNo>
                    <cloudHadoopServerName>****</cloudHadoopServerName>
                    <cloudHadoopServerRole>
                        <code>M</code>
                        <codeName>Master Node</codeName>
                    </cloudHadoopServerRole>
                    <cloudHadoopServerInstanceStatusName>running</cloudHadoopServerInstanceStatusName>
                    <cloudHadoopServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudHadoopServerInstanceStatus>
                    <cloudHadoopServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudHadoopServerInstanceOperation>
                    <regionCode>KR</regionCode>
                    <zoneCode>KR-2</zoneCode>
                    <vpcNo>1665</vpcNo>
                    <vpcName>*****</vpcName>
                    <subnetNo>2020</subnetNo>
                    <subnetName>*****</subnetName>
                    <privateIp>***.***.***.***</privateIp>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>8</cpuCount>
                    <memorySize>34359738368</memorySize>
                </cloudHadoopServerInstance>
                <cloudHadoopServerInstance>
                    <cloudHadoopServerInstanceNo>****</cloudHadoopServerInstanceNo>
                    <cloudHadoopServerName>****</cloudHadoopServerName>
                    <cloudHadoopServerRole>
                        <code>M</code>
                        <codeName>Master Node</codeName>
                    </cloudHadoopServerRole>
                    <cloudHadoopServerInstanceStatusName>running</cloudHadoopServerInstanceStatusName>
                    <cloudHadoopServerInstanceStatus>
                        <code>RUN</code>
                        <codeName>CLOUD DATABASE(VPC) Server Running State</codeName>
                    </cloudHadoopServerInstanceStatus>
                    <cloudHadoopServerInstanceOperation>
                        <code>NOOP</code>
                        <codeName>CLOUD DATABASE(VPC) Server Null OP</codeName>
                    </cloudHadoopServerInstanceOperation>
                    <regionCode>KR</regionCode>
                    <zoneCode>KR-2</zoneCode>
                    <vpcNo>1665</vpcNo>
                    <vpcName>*****</vpcName>
                    <subnetNo>2020</subnetNo>
                    <subnetName>*****</subnetName>
                    <privateIp>***.***.***.***</privateIp>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>8</cpuCount>
                    <memorySize>34359738368</memorySize>
                </cloudHadoopServerInstance>
            </cloudHadoopServerInstanceList>
        </cloudHadoopInstance>
    </cloudHadoopInstanceList>
</getCloudHadoopInstanceListResponse>
```