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

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

# getCloudHadoopInstanceList

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

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

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

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

| 파라미터명 | 필수 여부 | 타입 | 제약 사항 | 설명 |
| ----- | ----- | ----- | ----- | ----- |
| regionCode | No | String | | - 리전 코드<br>Cloud Hadoop 인스턴스 리스트가 조회될 리전(Region) 결정 가능 <br>regionCode는 [getRegionList](/docs/cli-vserver-server-common-getregionlist) 액션을 통해서 획득 가능 <br>Default: getRegionList 조회 결과의 첫 번째 리전을 선택 |
| zoneCode | No | String | | - ZONE 코드<br>Cloud Hadoop 인스턴스 리스트가 조회될 Zone을 결정 가능 <br>zoneCode는 [getZoneList](/docs/cli-vserver-server-common-getzonelist) 액션을 통해서 획득 가능 |
| vpcNo | No | String | | - VPC 번호<br>Cloud Hadoop 인스턴스 리스트가 조회될 VPC를 결정 가능 <br>vpcNo는 [getVpcList](/docs/cli-vpc-vpcmanagement-getvpclist) 액션을 통해서 획득 가능 |
| subnetNo | No | String | | - Subnet 번호<br>Cloud Hadoop 인스턴스 리스트가 조회될 Subnet을 결정 가능 <br>SubnetNo는 [getSubnetList](/docs/cli-vpc-subnetmanagement-getsubnetlist) 액션을 통해서 획득 가능  |
| cloudHadoopClusterName | No | String | | - Cloud Hadoop 클러스터 이름<br>Cloud Hadoop 클러스터 이름으로 필터링하여 검색할 수 있음 <br>cloudHadoopClusterName은 [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 액션을 통해서 획득 가능 |
| cloudHadoopInstanceNoList | No | List&lt;String&gt; | | - Cloud Hadoop 인스턴스 번호 리스트<br>Cloud Hadoop 인스턴스 번호로 필터링하여 검색 가능 <br>cloudHadoopInstanceNoList는 [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 액션을 통해서 획득 가능 <br><예시>  cloudHadoopInstanceNoList 1234 2345 |
| cloudHadoopServerName | No | String | | - Cloud Hadoop 서버 이름<br>Cloud Hadoop 서버 이름으로 필터링하여 검색 가능 <br>cloudHadoopServerName은 [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 액션을 통해서 획득 가능 |
| cloudHadoopServerInstanceNoList | No | List&lt;String&gt; | | -  Cloud Hadoop 서버 인스턴스 번호 리스트<br>Cloud Hadoop 서버 인스턴스 번호로 필터링하여 검색 가능 <br>cloudHadoopServerInstanceNoList [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 액션을 통해서 획득 가능 <br><예시> cloudHadoopServerInstanceNoList1234 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 : json |

## 응답<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 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 FKR --zoneCode FKR-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": "****",
        "cloudHadoopClusterName": "****",
        "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": "****",
            "cloudHadoopServerName": "e-001-****-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": "FKR",
            "zoneCode": "FKR-2",
            "vpcNo": "**77",
            "vpcName": "vpcTestName",
            "subnetNo": "**47",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          },
          {
            "cloudHadoopServerInstanceNo": "****",
            "cloudHadoopServerName": "m-001-****-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": "FKR",
            "zoneCode": "FKR-2",
            "vpcNo": "**77",
            "vpcName": "vpcTestName",
            "subnetNo": "**47",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          },
          {
            "cloudHadoopServerInstanceNo": "****",
            "cloudHadoopServerName": "m-002-****-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": "FKR",
            "zoneCode": "FKR-2",
            "vpcNo": "**77",
            "vpcName": "vpcTestName",
            "subnetNo": "**47",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          },
          {
            "cloudHadoopServerInstanceNo": "****",
            "cloudHadoopServerName": "d-001-****-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": "FKR",
            "zoneCode": "FKR-2",
            "vpcNo": "**77",
            "vpcName": "vpcTestName",
            "subnetNo": "**47",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          },
          {
            "cloudHadoopServerInstanceNo": "****",
            "cloudHadoopServerName": "d-002-****-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": "FKR",
            "zoneCode": "FKR-2",
            "vpcNo": "**77",
            "vpcName": "vpcTestName",
            "subnetNo": "**47",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          },
          {
            "cloudHadoopServerInstanceNo": "****",
            "cloudHadoopServerName": "d-003-****-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": "FKR",
            "zoneCode": "FKR-2",
            "vpcNo": "**77",
            "vpcName": "vpcTestName",
            "subnetNo": "**47",
            "subnetName": "subnetTestName",
            "privateIp": "192.168.***.***",
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 34359738368
          }
        ]
      }
    ],
    "requestId": "dfb64c78-5b94-****-8514-****4158b46b",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```

```xml
<getCloudHadoopInstanceListResponse>
    <requestId>74dd4dd4-9fa3-****-b001-****d2931a4a</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudHadoopInstanceList>
        <cloudHadoopInstance>
            <cloudHadoopInstanceNo>****</cloudHadoopInstanceNo>
            <cloudHadoopClusterName>****</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>FKR</regionCode>
                    <zoneCode>FKR-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>FKR</regionCode>
                    <zoneCode>FKR-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>FKR</regionCode>
                    <zoneCode>FKR-2</zoneCode>
                    <vpcNo>**65</vpcNo>
                    <vpcName>*****</vpcName>
                    <subnetNo>**20</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>FKR</regionCode>
                    <zoneCode>FKR-2</zoneCode>
                    <vpcNo>**65</vpcNo>
                    <vpcName>*****</vpcName>
                    <subnetNo>**20</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>FKR</regionCode>
                    <zoneCode>FKR-2</zoneCode>
                    <vpcNo>**65</vpcNo>
                    <vpcName>*****</vpcName>
                    <subnetNo>**20</subnetNo>
                    <subnetName>*****</subnetName>
                    <privateIp>***.***.***.***</privateIp>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>8</cpuCount>
                    <memorySize>34359738368</memorySize>
                </cloudHadoopServerInstance>
            </cloudHadoopServerInstanceList>
        </cloudHadoopInstance>
    </cloudHadoopInstanceList>
</getCloudHadoopInstanceListResponse>
```