--- title: "getCloudHadoopInstanceList" slug: "analytics-vhadoop-getcloudhadoopinstancelist" tags: ["Cloud Hadoop"] updated: 2026-09-17T09:16:07Z published: 2026-09-17T09:16:07Z canonical: "api.ncloud-docs.com/analytics-vhadoop-getcloudhadoopinstancelist" --- > ## Documentation Index > Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt > Use this file to discover all available pages before exploring further. # getCloudHadoopInstanceList

VPC 환경에서 이용 가능합니다.

Cloud Hadoop 클러스터 목록을 조회합니다. ## 요청 요청 형식을 설명합니다. 요청 형식은 다음과 같습니다. | 메서드 | URI | | :--- | :--- | | GET \| POST | /vhadoop/v2/getCloudHadoopInstanceList | :::(Info) (참고) 가이드는 GET 방식 기준으로 안내합니다. POST 방식의 호출 테스트는 네이버 클라우드 플랫폼 콘솔의 API Gateway 서비스에서 Swagger를 통해서 가능합니다. ::: ### 요청 헤더 Cloud Hadoop API에서 공통으로 사용하는 헤더에 대한 정보는 [Cloud Hadoop 요청 헤더](/docs/analytics-vhadoop#요청헤더)를 참조해 주십시오. ### 요청 쿼리 파라미터 요청 쿼리 파라미터에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | :---- | :---- | :---- | :---- | | `regionCode` | String | Optional | 리전 코드 | | `zoneCode` | String | Optional | 존 코드로 필터링 | | `vpcNo` | String | Optional | VPC 번호로 필터링 | | `subnetNo` | String | Optional | Subnet 번호로 필터링 | | `cloudHadoopClusterName` | String | Optional | 클러스터 이름으로 필터링 | | `cloudHadoopInstanceNoList` | Array | Optional | 클러스터 인스턴스 번호 목록 | | `cloudHadoopServerName` | String | Optional | 서버 이름으로 필터링 | | `cloudHadoopServerInstanceNoList` | Array | Optional | 서버 인스턴스 번호 목록 | | `pageNo` | Integer | Optional | 페이지 번호 | | `pageSize` | Integer | Optional | 페이지 출력 수 | | `responseFormatType` | String | Optional | 응답 데이터의 형식 | ### 요청 예시 요청 예시는 다음과 같습니다. ```shell curl --location --request GET 'https://ncloud.apigw.ntruss.com/vhadoop/v2/getCloudHadoopInstanceList ?regionCode=KR &vpcNo=7**** &subnetNo=17**** &responseFormatType=json' \ --header 'x-ncp-apigw-timestamp: {Timestamp}' \ --header 'x-ncp-iam-access-key: {Access Key}' \ --header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' ``` ## 응답 응답 형식을 설명합니다. ### 응답 바디 응답 바디에 대한 설명은 다음과 같습니다. | 필드 | 타입 | 필수 여부 | 설명 | | :---- | :---- | :---- | :---- | | `getCloudHadoopInstanceListResponse` | Object | - | 응답 결과 | | `getCloudHadoopInstanceListResponse.requestId` | String | - | 요청에 대한 아이디 | | `getCloudHadoopInstanceListResponse.returnCode` | String | - | 응답 코드 | | `getCloudHadoopInstanceListResponse.returnMessage` | String | - | 응답 메시지 | ### 응답 상태 코드 Cloud Hadoop API에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 [Cloud Hadoop 응답 상태 코드](/docs/analytics-vhadoop#응답상태코드)를 참조해 주십시오. ### 응답 예시 응답 예시는 다음과 같습니다. ```json { "getCloudHadoopInstanceListResponse": { "totalRows": 1, "cloudHadoopInstanceList": [ { "cloudHadoopInstanceNo": "2707****", "cloudHadoopClusterName": "clus1", "cloudHadoopInstanceStatusName": "running", "cloudHadoopInstanceStatus": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Created 상태" }, "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.1", "codeName": "Cloud Hadoop 2.1" }, "cloudHadoopImageProductCode": "SW.VCHDP.LNX64.CNTOS.0708.HDP.21.B050", "cloudHadoopServerInstanceList": [ { "cloudHadoopServerInstanceNo": "2707****", "cloudHadoopServerName": "e-001-clus1-5u29-hd", "cloudHadoopServerRole": { "code": "E", "codeName": "Edge Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) 서버 Null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "7****", "vpcName": "****", "subnetNo": "17****", "subnetName": "****", "privateIp": "***.***.***.***", "dataStorageSize": 107374182400, "cpuCount": 8, "memorySize": 17179869184 }, { "cloudHadoopServerInstanceNo": "2707****", "cloudHadoopServerName": "m-001-clus1-5u27-hd", "cloudHadoopServerRole": { "code": "M", "codeName": "Master Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) 서버 Null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "7****", "vpcName": "****", "subnetNo": "17****", "subnetName": "****", "privateIp": "***.***.***.***", "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184 }, { "cloudHadoopServerInstanceNo": "2707****", "cloudHadoopServerName": "m-002-clus1-5u28-hd", "cloudHadoopServerRole": { "code": "M", "codeName": "Master Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) 서버 Null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "7****", "vpcName": "****", "subnetNo": "17****", "subnetName": "****", "privateIp": "***.***.***.***", "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184 }, { "cloudHadoopServerInstanceNo": "2707****", "cloudHadoopServerName": "d-001-clus1-5u2a-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Date Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) 서버 Null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "7****", "vpcName": "****", "subnetNo": "17****", "subnetName": "****", "privateIp": "***.***.***.***", "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184 }, { "cloudHadoopServerInstanceNo": "2707****", "cloudHadoopServerName": "d-002-clus1-5u2b-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Date Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE(VPC) 서버 Null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "7****", "vpcName": "****", "subnetNo": "17****", "subnetName": "****", "privateIp": "***.***.***.***", "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184 } ] } ], "requestId": "8eb61b67-****-****-****-cac06da0d8d2", "returnCode": "0", "returnMessage": "success" } } ```