---
title: "getCloudHadoopInstanceList"
slug: "cli-vhadoop-getcloudhadoopinstancelist"
tags: ["Cloud Hadoop"]
updated: 2026-04-23T09:04:50Z
published: 2026-04-23T09:07:28Z
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

## 개요

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

## 요청

### 요청 파라미터

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

## 예시

### 호출

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

### 응답

```
{
  "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"
  }
}
```

```
<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>
```