createCloudHadoopNotebookInstance

VPC環境で利用できます。

Cloud Hadoopノートブックを作成します。

構文

createCloudHadoopNotebookInstance構文は次の通りです。

./ncloud vhadoop createCloudHadoopNotebookInstance \
    --cloudHadoopInstanceNo <cloud-hadoop-instance-no> \
    --notebookNodeSubnetNo <notebook-node-subnet-no> \
    --cloudHadoopNotebookName <notebook-name> \
    --cloudHadoopNotebookComponent <notebook-component> \
    --notebookNodeDataStorageSize <notebook-node-storage-size> \
    --bucketName <bucket-name> \
    --loginKeyName <login-key-name> \
    [--cloudHadoopNotebookImageProductCode <notebook-image-product-code>] \
    [--engineVersionCode <engine-version-code>] \
    [--notebookNodeProductCode <notebook-node-product-code>] \
    [--useNotebookBlockStorage <true|false>] \
    [--notebookNodeDataStorageTypeCode <SSD|HDD|CB2>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]

オプション

createCloudHadoopNotebookInstanceの実行時に指定できるオプションについて説明します。

必須オプション

createCloudHadoopNotebookInstanceの必須オプションです。

オプション	タイプ	必須の有無	説明
`--cloudHadoopInstanceNo`	String	Required	クラスタインスタンス番号 getCloudHadoopInstanceListを参照
`--notebookNodeSubnetNo`	String	Required	ノートブックノード Subnet番号 getCloudHadoopTargetSubnetListを参照
`--cloudHadoopNotebookName`	String	Required	ノートブック名英字の小文字、数字、記号の`-` を組み合わせて3~15文字以内で入力文字列の先頭は英字の小文字、末尾は英字の小文字または数字のみ使用
`--cloudHadoopNotebookComponent`	String	Required	ノートブックコンポーネント getCloudHadoopNotebookComponentListの`code`を参照
`--notebookNodeDataStorageSize`	Integer	Required	ノートブックノードストレージ容量 (GB) `100`~`2000` (10GB単位)\| `4000` \| `6000`
`--bucketName`	String	Required	Object Storageバケット名 getCloudHadoopNotebookBucketListを参照
`--loginKeyName`	String	Required	認証キー名 SSH方式でノードに直接接続する際に必要 getCloudHadoopLoginKeyListを参照

任意オプション

createCloudHadoopNotebookInstanceの任意オプションです。指定しない場合、オプションにはデフォルト値が適用されます。

オプション	タイプ	必須の有無	説明
`--cloudHadoopNotebookImageProductCode`	String	Optional	ノートブックイメージコード入力しない場合、現在提供中の最新バージョンを適用 getCloudHadoopNotebookImageProductListの`productCode`を参照
`--engineVersionCode`	String	Optional	エンジンバージョンコード未入力の場合、提供中の最新バージョンを適用 Rockyクラスタ作成時に入力 getCloudHadoopImageProductListを参照
`--notebookNodeProductCode`	String	Optional	ノートブックノードサーバタイプコードデフォルト: 最小スペック(メモリ、CPU順) getCloudHadoopNotebookProductListを参照
`--useNotebookBlockStorage`	Boolean	Optional	ノートブックノードストレージを追加するか `true` \| `false` (デフォルト) `true`: 追加 `false`: 追加しない
`--notebookNodeDataStorageTypeCode`	String	Optional	ノートブックノードストレージタイプ `cloudHadoopNotebookImageProductCode`の`generationCode`に応じてデフォルト値が異なる G2: `SSD` (デフォルト) \| `HDD` G3: `CB2` (デフォルト) インストール後、ストレージタイプは変更不可

共通オプション

vhadoopコマンドで共通して使用されるオプションの詳細は、Cloud Hadoop (VPC)のオプションをご参照ください。

例

Cloud Hadoopノートブックの作成リクエストが成功すると、ノートブックの構成情報と作成状態が返されます。

コマンド

コマンドの例は次の通りです。

./ncloud vhadoop createCloudHadoopNotebookInstance \
    --cloudHadoopInstanceNo 34567890 \
    --notebookNodeSubnetNo 23456790 \
    --cloudHadoopNotebookName notebook-01 \
    --cloudHadoopNotebookComponent NOTEBOOK_1.1 \
    --bucketName my-test-bucket \
    --notebookNodeDataStorageSize 100 \
    --loginKeyName test-key \
    --useNotebookBlockStorage true \
    --notebookNodeDataStorageTypeCode SSD \
    --regionCode KR \
    --output json

出力

出力の例は次の通りです。

{
  "createCloudHadoopNotebookInstanceResponse": {
    "totalRows": 1,
    "cloudHadoopNotebookInstanceList": [
      {
        "cloudHadoopNotebookInstanceNo": "34567891",
        "cloudHadoopNotebookName": "notebook-01",
        "cloudHadoopNotebookImageProductCode": "SW.VCHDP.OS.LNX64.ROCKY.0810.HDNTB.B050",
        "cloudHadoopNotebookInstanceStatusName": "creating",
        "cloudHadoopNotebookInstanceStatus": {
          "code": "INIT",
          "codeName": "CLOUD DATABASE(VPC) Init状態"
        },
        "cloudHadoopNotebookInstanceOperation": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Creat OP"
        },
        "cloudHadoopNotebookVersion": {
          "code": "NOTEBOOK1.1",
          "codeName": "Notebook 1.1"
        },
        "cloudHadoopNotebookComponent": {
          "code": "NOTEBOOK_1.1",
          "codeName": "Jupyter notebook 6.4.10 , JupyterLab : 3.2.9"
        },
        "createDate": "2026-07-06T16:26:27+0900",
        "loginKey": "test-key",
        "objectStorageBucket": "my-test-bucket",
        "accessControlGroupNoList": [],
        "cloudHadoopClusterName": "cluster-01",
        "clusterDirectAccessAccount": "sshuser",
        "cloudHadoopNotebookServerInstanceList": [
          {
            "cloudHadoopNotebookServerName": "n-001-notebook-01-9dc2-hd",
            "cloudHadoopNotebookServerRole": {
              "code": "N",
              "codeName": "Notebook Node"
            },
            "cloudHadoopNotebookServerInstanceStatusName": "creating",
            "cloudHadoopNotebookServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC)サーバ Pending状態"
            },
            "cloudHadoopNotebookServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC)サーバ Create OP"
            },
            "cloudHadoopNotebookProductCode": "SVR.VCHDP.NTBND.STAND.C004.M016.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "12345678",
            "subnetNo": "23456790",
            "cpuCount": 4,
            "memorySize": 17179869184,
            "dataStorageSize": 107374182400,
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "createDate": "2026-07-06T16:26:27+0900"
          }
        ]
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}