--- title: "getCloudHadoopInstanceList" slug: "cli-vhadoop-getcloudhadoopinstancelist" tags: ["Cloud Hadoop", "VPC"] updated: 2026-10-08T05:11:31Z published: 2026-10-08T05:11:31Z 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 Available in VPC Get the list of Cloud Hadoop clusters. ## Syntax The `getCloudHadoopInstanceList` syntax is as follows: ``` ./ncloud vhadoop getCloudHadoopInstanceList \ [--zoneCode ] \ [--vpcNo ] \ [--subnetNo ] \ [--cloudHadoopClusterName ] \ [--cloudHadoopInstanceNoList ] \ [--cloudHadoopServerName ] \ [--cloudHadoopServerInstanceNoList ] \ [--pageNo ] \ [--pageSize ] \ [--regionCode ] \ [--output ] ``` ## Options This section describes the options available when running `getCloudHadoopInstanceList`. ### Required options The following options are required for `getCloudHadoopInstanceList`. | Options | Type | Required | Description | | --- | --- | --- | --- | | `--pageSize` | Integer | Conditional | Page output count - `1`-N - Required when entering `pageNo` | ### Optional options These are the optional options for `getCloudHadoopInstanceList`. Options that are not specified will use their default values. | Options | Type | Required | Description | | --- | --- | --- | --- | | `--zoneCode` | String | Optional | Zone code - See [getZoneList](/docs/en/cli-vserver-server-common-getzonelist). | | `--vpcNo` | String | Optional | VPC number - See [getCloudHadoopTargetVpcList](/docs/en/cli-vhadoop-getcloudhadooptargetvpclist). | | `--subnetNo` | String | Optional | Subnet number - See [getCloudHadoopTargetSubnetList](/docs/en/cli-vhadoop-getcloudhadooptargetsubnetlist). | | `--cloudHadoopClusterName` | String | Optional | Cluster name | | `--cloudHadoopInstanceNoList` | List | Optional | Cluster instance ID list - You can enter multiple items separated by spaces (e.g., `--cloudHadoopInstanceNoList 1234 2345`). | | `--cloudHadoopServerName` | String | Optional | Server name | | `--cloudHadoopServerInstanceNoList` | List | Optional | Server instance number list - You can enter multiple items separated by spaces (e.g., `--cloudHadoopServerInstanceNoList 1234 2345`). | | `--pageNo` | Integer | Optional | Page number - `0`-N (default: `0`) | ### Common options For information about the options common to all `vhadoop` subcommands, see [Cloud Hadoop (VPC) options](/docs/en/cli-vhadoop#%EC%98%B5%EC%85%98). ## Examples If the request to list Cloud Hadoop clusters is successful, the configuration information and status of each cluster are returned. ### Command The command example is as follows: ``` ./ncloud vhadoop getCloudHadoopInstanceList \ --zoneCode KR-2 \ --vpcNo 12345678 \ --subnetNo 23456790 \ --cloudHadoopClusterName cluster-01 \ --cloudHadoopInstanceNoList 34567890 \ --cloudHadoopServerName m-001-cluster-01-9d5x-hd \ --cloudHadoopServerInstanceNoList 45678902 \ --pageNo 0 \ --pageSize 10 \ --regionCode KR \ --output json ``` ### Output The output example is as follows: ``` { "getCloudHadoopInstanceListResponse": { "totalRows": 1, "cloudHadoopInstanceList": [ { "cloudHadoopInstanceNo": "34567890", "cloudHadoopClusterName": "cluster-01", "cloudHadoopInstanceStatusName": "running", "cloudHadoopInstanceStatus": { "code": "CREAT", "codeName": "CLOUD DATABASE (VPC) Created status" }, "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.11.2), Spark (2.4.8)" }, "cloudHadoopVersion": { "code": "HADOOP2.2", "codeName": "Cloud Hadoop 2.2" }, "cloudHadoopImageProductCode": "SW.VCHDP.OS.LNX64.ROCKY.0810.HDP.B050", "cloudHadoopServerInstanceList": [ { "cloudHadoopServerInstanceNo": "45678901", "cloudHadoopServerName": "e-001-cluster-01-9d5z-hd", "cloudHadoopServerRole": { "code": "E", "codeName": "Edge Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE (VPC) server Running status" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE (VPC) server null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "subnetNo": "23456789", "privateIp": "10.0.1.6", "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184 }, { "cloudHadoopServerInstanceNo": "45678902", "cloudHadoopServerName": "m-001-cluster-01-9d5x-hd", "cloudHadoopServerRole": { "code": "M", "codeName": "Master Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE (VPC) server Running status" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE (VPC) server null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "subnetNo": "23456790", "privateIp": "10.0.2.6", "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184 }, { "cloudHadoopServerInstanceNo": "45678903", "cloudHadoopServerName": "m-002-cluster-01-9d5y-hd", "cloudHadoopServerRole": { "code": "M", "codeName": "Master Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE (VPC) server Running status" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE (VPC) server null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "subnetNo": "23456790", "privateIp": "10.0.2.7", "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184 }, { "cloudHadoopServerInstanceNo": "45678904", "cloudHadoopServerName": "d-001-cluster-01-9d60-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Data Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE (VPC) server Running status" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE (VPC) server null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "subnetNo": "23456790", "privateIp": "10.0.2.8", "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184 }, { "cloudHadoopServerInstanceNo": "45678905", "cloudHadoopServerName": "d-002-cluster-01-9d61-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Data Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE (VPC) server Running status" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE (VPC) server null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "subnetNo": "23456790", "privateIp": "10.0.2.9", "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184 }, { "cloudHadoopServerInstanceNo": "45678906", "cloudHadoopServerName": "d-003-cluster-01-9d9s-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Data Node" }, "cloudHadoopServerInstanceStatusName": "running", "cloudHadoopServerInstanceStatus": { "code": "RUN", "codeName": "CLOUD DATABASE (VPC) server Running status" }, "cloudHadoopServerInstanceOperation": { "code": "NOOP", "codeName": "CLOUD DATABASE (VPC) server null OP" }, "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "subnetNo": "23456790", "privateIp": "10.0.2.10", "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184 } ] } ], "requestId": "b2c3d4e5-f6a7-8901-bcde-f23456789012", "returnCode": "0", "returnMessage": "success" } } ```