createCloudHadoopNotebookInstance

Cloud Hadoop 노트북을 생성합니다.

구문

createCloudHadoopNotebookInstance 구문은 다음과 같습니다.

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

옵션

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

필수 옵션

createCloudHadoopNotebookInstance의 필수 옵션입니다.

옵션	타입	필수 여부	설명
`--cloudHadoopInstanceNo`	String	Required	클러스터 인스턴스 번호 getCloudHadoopInstanceList 참조
`--notebookNodeSubnetNo`	String	Required	노트북 노드 Subnet 번호 getCloudHadoopTargetSubnetList 참조
`--cloudHadoopNotebookName`	String	Required	노트북 이름 영문 소문자, 숫자, 특수문자 `-`를 조합하여 3~15자 이내로 입력 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성
`--cloudHadoopNotebookComponent`	String	Required	노트북 컴포넌트 getCloudHadoopNotebookComponentList의 `code` 참조
`--bucketName`	String	Required	Object Storage 버킷 이름 getCloudHadoopNotebookBucketList 참조
`--loginKeyName`	String	Required	인증키 이름 SSH 방식으로 노드에 직접 접속 시 필요 getCloudHadoopLoginKeyList 참조
`--notebookNodeDataStorageSize`	Integer	Conditional	노트북 노드 스토리지 용량 (GB) `100`~`2000` (10 GB 단위) \| `4000` \| `6000` `useNotebookBlockStorage`가 `true`인 경우, 필수 입력

선택 옵션

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	노트북 노드 스토리지 타입 `SSD` (기본값) \| `HDD` 설치 이후 데이터 스토리지 타입 변경 불가

공통 옵션

vhadoop 명령에서 공통으로 사용하는 옵션에 대한 정보는 Cloud Hadoop 옵션을 참조해 주십시오.

예시

Cloud Hadoop 노트북 생성 요청이 성공하면 노트북의 구성 정보와 생성 상태가 반환됩니다.

명령

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

./ncloud vhadoop createCloudHadoopNotebookInstance \
    --cloudHadoopInstanceNo 34567890 \
    --notebookNodeSubnetNo 23456789 \
    --cloudHadoopNotebookName notebook-01 \
    --cloudHadoopNotebookComponent NOTEBOOK_1.1 \
    --bucketName my-test-bucket \
    --notebookNodeDataStorageSize 100 \
    --loginKeyName test-key \
    --useNotebookBlockStorage true \
    --notebookNodeDataStorageTypeCode SSD \
    --regionCode FKR \
    --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-08-10T11:37:19+0900",
        "loginKey": "test-key",
        "objectStorageBucket": "my-test-bucket",
        "accessControlGroupNoList": [],
        "cloudHadoopClusterName": "cluster-01",
        "clusterDirectAccessAccount": "sshuser",
        "cloudHadoopNotebookServerInstanceList": [
          {
            "cloudHadoopNotebookServerName": "n-001-notebook-01-3s08-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.G001",
            "regionCode": "FKR",
            "zoneCode": "FKR-1",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "cpuCount": 4,
            "memorySize": 17179869184,
            "dataStorageSize": 107374182400,
            "isPublicSubnet": true,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "createDate": "2026-08-10T11:37:19+0900"
          }
        ]
      }
    ],
    "requestId": "5f61b77a-2850-4cc1-8afb-d1a126226f3e",
    "returnCode": "0",
    "returnMessage": "success"
  }
}