---
title: "changeCloudHadoopNodeSpec"
slug: "cli-vhadoop-changecloudhadoopnodespec"
tags: ["Cloud Hadoop"]
updated: 2026-09-17T09:10:28Z
published: 2026-09-17T09:10:28Z
canonical: "cli-fin.ncloud-docs.com/cli-vhadoop-changecloudhadoopnodespec"
---

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

# changeCloudHadoopNodeSpec

Cloud Hadoop 클러스터의 노드 스펙을 업그레이드합니다.

## 구문

`changeCloudHadoopNodeSpec` 구문은 다음과 같습니다.

```
./ncloud vhadoop changeCloudHadoopNodeSpec \
    --cloudHadoopInstanceNo <cloud-hadoop-instance-no> \
    --masterNodeProductCode <master-node-product-code> \
    --edgeNodeProductCode <edge-node-product-code> \
    --workerNodeProductCode <worker-node-product-code> \
    [--regionCode <FKR>] \
    [--output <json|xml>]
```

## 옵션

`changeCloudHadoopNodeSpec` 실행 시 지정할 수 있는 옵션을 설명합니다.

### 필수 옵션

`changeCloudHadoopNodeSpec`의 필수 옵션입니다.

| 옵션 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `--cloudHadoopInstanceNo` | String | Required | 클러스터 인스턴스 번호 - [getCloudHadoopInstanceList](/docs/cli-vhadoop-getcloudhadoopinstancelist) 참조 |
| `--masterNodeProductCode` | String | Conditional | 마스터 노드 서버 타입 코드 - `masterNodeProductCode`, `edgeNodeProductCode`, `workerNodeProductCode` 중 하나 이상 필수 입력 - [getCloudHadoopProductList](/docs/cli-vhadoop-getcloudhadoopproductlist) 참조 |
| `--edgeNodeProductCode` | String | Conditional | 엣지 노드 서버 타입 코드 - `masterNodeProductCode`, `edgeNodeProductCode`, `workerNodeProductCode` 중 하나 이상 필수 입력 - [getCloudHadoopProductList](/docs/cli-vhadoop-getcloudhadoopproductlist) 참조 |
| `--workerNodeProductCode` | String | Conditional | 작업자 노드 서버 타입 코드 - `masterNodeProductCode`, `edgeNodeProductCode`, `workerNodeProductCode` 중 하나 이상 필수 입력 - [getCloudHadoopProductList](/docs/cli-vhadoop-getcloudhadoopproductlist) 참조 |

### 공통 옵션

`vhadoop` 명령에서 공통으로 사용하는 옵션에 대한 정보는 [Cloud Hadoop 옵션](/docs/cli-vhadoop#%EC%98%B5%EC%85%98)을 참조해 주십시오.

## 예시

Cloud Hadoop 노드 스펙 업그레이드 요청이 성공하면 클러스터의 구성 정보와 업그레이드 상태가 반환됩니다.

### 명령

명령 예시는 다음과 같습니다.

```
./ncloud vhadoop changeCloudHadoopNodeSpec \
    --cloudHadoopInstanceNo 34567890 \
    --edgeNodeProductCode SVR.VCHDP.EDGND.STAND.C004.M032.NET.HDD.B050.G001 \
    --regionCode FKR \
    --output json
```

### 출력

출력 예시는 다음과 같습니다.

```
{
  "changeCloudHadoopNodeSpec": {
    "totalRows": 1,
    "cloudHadoopInstanceList": [
      {
        "cloudHadoopInstanceNo": "34567890",
        "cloudHadoopClusterName": "cluster-01",
        "cloudHadoopInstanceStatusName": "upgrading",
        "cloudHadoopInstanceStatus": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Created 상태"
        },
        "cloudHadoopInstanceOperation": {
          "code": "UPGD",
          "codeName": "CLOUD DATABASE(VPC) Upgrade 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.3",
          "codeName": "Cloud Hadoop 2.3"
        },
        "cloudHadoopAddOnList": [],
        "ambariServerHost": "e-001-cluster-01-3ru9-hd",
        "clusterDirectAccessAccount": "sshuser",
        "loginKey": "test-key",
        "objectStorageBucket": "my-test-bucket",
        "cloudHadoopImageProductCode": "SW.VCHDP.OS.LNX64.ROCKY.0810.HDP.B050",
        "isHa": true,
        "createDate": "2026-08-07T13:28:00+0900",
        "domain": "pub-1a2b3c.hadoop.fin-ntruss.com",
        "useDataCatalog": false,
        "accessControlGroupNoList": [
          "6789023"
        ],
        "cloudHadoopServerInstanceList": [
          {
            "cloudHadoopServerInstanceNo": "45678901",
            "cloudHadoopServerName": "e-001-cluster-01-3ru9-hd",
            "cloudHadoopServerRole": {
              "code": "E",
              "codeName": "Edge Node"
            },
            "cloudHadoopServerInstanceStatusName": "settingUp",
            "cloudHadoopServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "SETUP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Setup OP"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.EDGND.STAND.C004.M032.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "12345678",
            "vpcName": "vpc01",
            "subnetNo": "23456789",
            "subnetName": "public-subnet",
            "privateIp": "192.168.1.8",
            "isPublicSubnet": true,
            "dataStorageSize": 107374182400,
            "cpuCount": 4,
            "memorySize": 34359738368,
            "uptime": "2026-08-07T13:34:30+0900",
            "createDate": "2026-08-07T13:28:00+0900"
          },
          {
            "cloudHadoopServerInstanceNo": "45678902",
            "cloudHadoopServerName": "m-001-cluster-01-3ru7-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"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M032.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "12345678",
            "vpcName": "vpc01",
            "subnetNo": "23456789",
            "subnetName": "public-subnet",
            "privateIp": "192.168.1.6",
            "isPublicSubnet": true,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "dataStorageSize": 107374182400,
            "cpuCount": 4,
            "memorySize": 34359738368,
            "uptime": "2026-08-07T13:34:07+0900",
            "createDate": "2026-08-07T13:28:00+0900"
          },
          {
            "cloudHadoopServerInstanceNo": "45678903",
            "cloudHadoopServerName": "m-002-cluster-01-3ru8-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"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M032.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "12345678",
            "vpcName": "vpc01",
            "subnetNo": "23456789",
            "subnetName": "public-subnet",
            "privateIp": "192.168.1.7",
            "isPublicSubnet": true,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "dataStorageSize": 107374182400,
            "cpuCount": 4,
            "memorySize": 34359738368,
            "uptime": "2026-08-07T13:35:56+0900",
            "createDate": "2026-08-07T13:28:00+0900"
          },
          {
            "cloudHadoopServerInstanceNo": "45678904",
            "cloudHadoopServerName": "d-001-cluster-01-3rua-hd",
            "cloudHadoopServerRole": {
              "code": "D",
              "codeName": "Data Node"
            },
            "cloudHadoopServerInstanceStatusName": "running",
            "cloudHadoopServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C008.M016.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "12345678",
            "vpcName": "vpc01",
            "subnetNo": "23456790",
            "subnetName": "private-subnet",
            "privateIp": "192.168.2.6",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 17179869184,
            "uptime": "2026-08-07T13:34:44+0900",
            "createDate": "2026-08-07T13:28:00+0900"
          },
          {
            "cloudHadoopServerInstanceNo": "45678905",
            "cloudHadoopServerName": "d-002-cluster-01-3rub-hd",
            "cloudHadoopServerRole": {
              "code": "D",
              "codeName": "Data Node"
            },
            "cloudHadoopServerInstanceStatusName": "running",
            "cloudHadoopServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C008.M016.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "12345678",
            "vpcName": "vpc01",
            "subnetNo": "23456790",
            "subnetName": "private-subnet",
            "privateIp": "192.168.2.7",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 17179869184,
            "uptime": "2026-08-07T13:35:00+0900",
            "createDate": "2026-08-07T13:28:00+0900"
          },
          {
            "cloudHadoopServerInstanceNo": "45678906",
            "cloudHadoopServerName": "d-003-cluster-01-3ruh-hd",
            "cloudHadoopServerRole": {
              "code": "D",
              "codeName": "Data Node"
            },
            "cloudHadoopServerInstanceStatusName": "running",
            "cloudHadoopServerInstanceStatus": {
              "code": "RUN",
              "codeName": "CLOUD DATABASE(VPC) 서버 Running 상태"
            },
            "cloudHadoopServerInstanceOperation": {
              "code": "NOOP",
              "codeName": "CLOUD DATABASE(VPC) 서버 Null OP"
            },
            "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C008.M016.NET.HDD.B050.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "12345678",
            "vpcName": "vpc01",
            "subnetNo": "23456790",
            "subnetName": "private-subnet",
            "privateIp": "192.168.2.8",
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "dataStorageSize": 107374182400,
            "cpuCount": 8,
            "memorySize": 17179869184,
            "uptime": "2026-08-07T17:31:11+0900",
            "createDate": "2026-08-07T17:26:00+0900"
          }
        ]
      }
    ],
    "requestId": "843baa99-777c-4f65-ab11-183629f9d808",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```