--- title: "createCloudHadoopInstance" slug: "cli-vhadoop-createcloudhadoopinstance" tags: ["Cloud Hadoop", "VPC"] updated: 2026-10-08T10:00:43Z published: 2026-10-08T10:00:43Z canonical: "cli.ncloud-docs.com/cli-vhadoop-createcloudhadoopinstance" --- > ## 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. # createCloudHadoopInstance VPC環境で利用できます。 Cloud Hadoopクラスタを作成します。 ## 構文 `createCloudHadoopInstance`構文は次の通りです。 ``` ./ncloud vhadoop createCloudHadoopInstance \ --vpcNo \ --edgeNodeSubnetNo \ --masterNodeSubnetNo \ --workerNodeSubnetNo \ --cloudHadoopClusterName \ --cloudHadoopClusterTypeCode \ --masterNodeDataStorageSize \ --workerNodeDataStorageSize \ --bucketName \ --cloudHadoopAdminUserName \ --cloudHadoopAdminUserPassword \ --loginKeyName \ [--cloudHadoopImageProductCode ] \ [--engineVersionCode ] \ [--cloudHadoopAddOnCodeList ] \ [--useDataCatalog ] \ [--useKdc ] \ [--kdcRealm ] \ [--kdcPassword ] \ [--useBootstrapScript ] \ [--bootstrapScript ] \ [--edgeNodeProductCode ] \ [--masterNodeProductCode ] \ [--masterNodeDataStorageTypeCode ] \ [--workerNodeProductCode ] \ [--workerNodeCount ] \ [--workerNodeDataStorageTypeCode ] \ [--regionCode ] \ [--output ] ``` ## オプション `createCloudHadoopInstance`の実行時に指定できるオプションについて説明します。 ### 必須オプション `createCloudHadoopInstance`の必須オプションです。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--vpcNo` | String | Required | VPC番号 - [getVpcList](/docs/ja/cli-vpc-vpcmanagement-getvpclist)を参照 | | `--edgeNodeSubnetNo` | String | Required | エッジノード Subnet番号 - [getSubnetList](/docs/ja/cli-vpc-subnetmanagement-getsubnetlist)を参照 | | `--masterNodeSubnetNo` | String | Required | マスターノード Subnet番号 - [getSubnetList](/docs/ja/cli-vpc-subnetmanagement-getsubnetlist)を参照 | | `--workerNodeSubnetNo` | String | Required | ワーカーノード Subnet番号 - [getSubnetList](/docs/ja/cli-vpc-subnetmanagement-getsubnetlist)を参照 - Private Subnetにのみ配置可能 | | `--cloudHadoopClusterName` | String | Required | クラスタ名 - 英字の小文字、数字、記号の`-`を組み合わせて3~15文字以内で入力 - 先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用 - 重複使用不可 | | `--cloudHadoopClusterTypeCode` | String | Required | クラスタタイプコード - [getCloudHadoopClusterTypeList](/docs/ja/cli-vhadoop-getcloudhadoopclustertypelist)を参照 | | `--masterNodeDataStorageSize` | Integer | Required | マスターノードストレージ容量 (GB) - `100`~`2000` (10GB単位) \| `4000` \| `6000` | | `--workerNodeDataStorageSize` | Integer | Required | ワーカーノードストレージ容量 (GB) - `100`~`2000` (10GB単位)\| `4000` \| `6000` | | `--bucketName` | String | Required | Object Storageのバケット名 - [getCloudHadoopBucketList](/docs/ja/cli-vhadoop-getcloudhadoopbucketlist)を参照 | | `--cloudHadoopAdminUserName` | String | Required | クラスタ管理者アカウントのユーザー名 - 英字の小文字、数字、記号の`-`を組み合わせて3~15文字以内で入力 - 先頭文字は英字の小文字、末尾文字は英字の小文字または数字のみ使用 - Ambariコンソールへのアクセス時に必要 | | `--cloudHadoopAdminUserPassword` | String | Required | クラスタ管理者アカウントのパスワード - 英字、数字、記号を組み合わせて8~20文字以内で入力 - 記号の`'` `"` `₩` `/` `&` ```およびスペースは使用不可 - Ambariコンソールへのアクセス時に必要 | | `--loginKeyName` | String | Required | 認証キー名 - SSH方式でノードに直接接続する際に必要 - [getCloudHadoopLoginKeyList](/docs/ja/cli-vhadoop-getcloudhadooploginkeylist)を参照 | | `--kdcRealm` | String | Conditional | KDC Realm情報 - Realm形式のドメインルールのみ許可 - `useKdc`が`true`の場合、必ず入力 | | `--kdcPassword` | String | Conditional | KDC管理者アカウントのパスワード - 英字、数字、記号を組み合わせて8~20文字以内で入力 - 記号の`'` `"` `₩` `/` `&` ```およびスペースは使用不可 - `useKdc`が`true`の場合、必ず入力 | | `--bootstrapScript` | String | Conditional | ブートストラップスクリプト - 1~1,024バイト - バケット内のフォルダおよびファイル名を入力 - ファイル名は英字のみ使用可能で、スペースや記号は使用不可 - クラスタに連携されたバケットでのみスクリプトを実行可能 - `useBootstrapScript`が`true`の場合、必ず入力 | ### 任意オプション `createCloudHadoopInstance`の任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。 | オプション | タイプ | 必須の有無 | 説明 | | --- | --- | --- | --- | | `--cloudHadoopImageProductCode` | String | Optional | クラスタイメージコード - [getCloudHadoopImageProductList](/docs/ja/cli-vhadoop-getcloudhadoopimageproductlist)の`productCode`を参照 - 入力しない場合、現在提供中の最新バージョンを適用 | | `--engineVersionCode` | String | Optional | エンジンバージョンコード - 未入力の場合、提供中の最新バージョンを適用 - Rockyクラスタ作成時に入力 - [getCloudHadoopImageProductList](/docs/ja/cli-vhadoop-getcloudhadoopimageproductlist)を参照 | | `--cloudHadoopAddOnCodeList` | List | Optional | クラスタ Add-onコンポーネントリスト - スペースで区切って複数入力可能 (例: `--cloudHadoopAddOnCodeList PRESTO HBASE`) - Cloud Hadoop 1.5以降のバージョンで適用可能 - [getCloudHadoopAddOnList](/docs/ja/cli-vhadoop-getcloudhadoopaddonlist)を参照 | | `--useDataCatalog` | Boolean | Optional | Data Catalogサービスを使用するか - `true` \| `false` (デフォルト) - `true`: Hiveメタストアを Data Catalogサービスのカタログ経由で提供 - `false`: 使用しない - 使用条件 - Data Catalogサービスのお申し込みおよび正常運用状態 - Cloud Hadoop 2.0以降のバージョン | | `--useKdc` | Boolean | Optional | Kerberos認証設定を使用するか - `true` \| `false` (デフォルト) - `true`: 使用 - `false`: 使用しない - 使用する場合、マスターノードに KDCサーバの冗長性を提供 | | `--useBootstrapScript` | Boolean | Optional | ブートストラップスクリプトを使用するか - `true` \| `false` (デフォルト) - `true`: 使用 - `false`: 使用しない - 使用する場合、すべてのノードでスクリプトを事前に実行 | | `--edgeNodeProductCode` | String | Optional | エッジノードのサーバタイプコード - デフォルト: 最小スペック(メモリ、CPU順) - [getCloudHadoopProductList](/docs/ja/cli-vhadoop-getcloudhadoopproductlist)を参照 | | `--masterNodeProductCode` | String | Optional | マスターノードのサーバタイプコード - デフォルト: 最小スペック(メモリ、CPU順) - [getCloudHadoopProductList](/docs/ja/cli-vhadoop-getcloudhadoopproductlist)を参照 | | `--masterNodeDataStorageTypeCode` | String | Optional | マスターノードのストレージタイプ - `cloudHadoopImageProductCode`の`generationCode`に応じてデフォルト値が異なる - G2: `SSD` (デフォルト) \| `HDD` - G3: `CB2` (デフォルト) - インストール後、データストレージのタイプは変更不可 | | `--workerNodeProductCode` | String | Optional | ワーカーノードのサーバタイプコード - デフォルト: 最小スペック(メモリ、CPU順) - [getCloudHadoopProductList](/docs/ja/cli-vhadoop-getcloudhadoopproductlist)を参照 | | `--workerNodeCount` | Integer | Optional | ワーカーノード数 - `2`~`8` (デフォルト: `2`) | | `--workerNodeDataStorageTypeCode` | String | Optional | ワーカーノードのストレージタイプ - `cloudHadoopImageProductCode`の`generationCode`に応じてデフォルト値が異なる - G2: `SSD` (デフォルト) \| `HDD` - G3: `CB2` (デフォルト) - インストール後、データストレージのタイプは変更不可 | ### 共通オプション `vhadoop`コマンドで共通して使用されるオプションの詳細は、[Cloud Hadoop (VPC)のオプション](/docs/ja/cli-vhadoop#%EC%98%B5%EC%85%98)をご参照ください。 ## 例 Cloud Hadoopクラスタの作成リクエストが成功すると、クラスタの構成情報と作成状態が返されます。 ### コマンド コマンドの例は次の通りです。 ``` ./ncloud vhadoop createCloudHadoopInstance \ --vpcNo 12345678 \ --edgeNodeSubnetNo 23456789 \ --masterNodeSubnetNo 23456790 \ --workerNodeSubnetNo 23456790 \ --cloudHadoopClusterName cluster-01 \ --cloudHadoopClusterTypeCode CORE_HADOOP_WITH_SPARK \ --masterNodeDataStorageSize 100 \ --workerNodeDataStorageSize 100 \ --bucketName my-test-bucket \ --cloudHadoopAdminUserName adminuser \ --cloudHadoopAdminUserPassword Examplepw123! \ --loginKeyName test-key \ --cloudHadoopImageProductCode SW.VCHDP.OS.LNX64.ROCKY.0810.HDP.B050 \ --engineVersionCode HADOOP2.2 \ --workerNodeCount 2 \ --regionCode KR \ --output json ``` ### 出力 出力の例は次の通りです。 ``` { "createCloudHadoopInstanceResponse": { "totalRows": 1, "cloudHadoopInstanceList": [ { "cloudHadoopInstanceNo": "34567890", "cloudHadoopClusterName": "cluster-01", "cloudHadoopInstanceStatusName": "creating", "cloudHadoopInstanceStatus": { "code": "INIT", "codeName": "CLOUD DATABASE(VPC) Init状態" }, "cloudHadoopInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC) Creat 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" }, "cloudHadoopAddOnList": [], "ambariServerHost": "e-001-cluster-01-9d5z-hd", "clusterDirectAccessAccount": "sshuser", "loginKey": "test-key", "objectStorageBucket": "my-test-bucket", "cloudHadoopImageProductCode": "SW.VCHDP.OS.LNX64.ROCKY.0810.HDP.B050", "isHa": true, "createDate": "2026-07-06T13:58:52+0900", "useDataCatalog": false, "accessControlGroupNoList": [], "cloudHadoopServerInstanceList": [ { "cloudHadoopServerName": "e-001-cluster-01-9d5z-hd", "cloudHadoopServerRole": { "code": "E", "codeName": "Edge Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC)サーバ Pending状態" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC)サーバ Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.EDGND.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "vpcName": "vpc-01", "subnetNo": "23456789", "subnetName": "public-subnet", "isPublicSubnet": true, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2026-07-06T13:58:52+0900" }, { "cloudHadoopServerName": "m-001-cluster-01-9d5x-hd", "cloudHadoopServerRole": { "code": "M", "codeName": "Master Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC)サーバ Pending状態" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC)サーバ Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "vpcName": "vpc-01", "subnetNo": "23456790", "subnetName": "private-subnet", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2026-07-06T13:58:52+0900" }, { "cloudHadoopServerName": "m-002-cluster-01-9d5y-hd", "cloudHadoopServerRole": { "code": "M", "codeName": "Master Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC)サーバ Pending状態" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC)サーバ Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "vpcName": "vpc-01", "subnetNo": "23456790", "subnetName": "private-subnet", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2026-07-06T13:58:52+0900" }, { "cloudHadoopServerName": "d-001-cluster-01-9d60-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Data Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC)サーバ Pending状態" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC)サーバ Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "vpcName": "vpc-01", "subnetNo": "23456790", "subnetName": "private-subnet", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2026-07-06T13:58:52+0900" }, { "cloudHadoopServerName": "d-002-cluster-01-9d61-hd", "cloudHadoopServerRole": { "code": "D", "codeName": "Data Node" }, "cloudHadoopServerInstanceStatusName": "creating", "cloudHadoopServerInstanceStatus": { "code": "PEND", "codeName": "CLOUD DATABASE(VPC)サーバ Pending状態" }, "cloudHadoopServerInstanceOperation": { "code": "CREAT", "codeName": "CLOUD DATABASE(VPC)サーバ Create OP" }, "cloudHadoopProductCode": "SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002", "regionCode": "KR", "zoneCode": "KR-2", "vpcNo": "12345678", "vpcName": "vpc-01", "subnetNo": "23456790", "subnetName": "private-subnet", "isPublicSubnet": false, "dataStorageType": { "code": "SSD", "codeName": "SSD" }, "dataStorageSize": 107374182400, "cpuCount": 4, "memorySize": 17179869184, "createDate": "2026-07-06T13:58:52+0900" } ] } ], "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890", "returnCode": "0", "returnMessage": "success" } } ```