Documentation Index

Fetch the complete documentation index at: https://cli-gov.ncloud-docs.com/llms.txt

Use this file to discover all available pages before exploring further.

createCloudHadoopNotebookInstance

Prev Next

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>] \
    [--regionCode <KR|KRS>] \
    [--output <json|xml>]

옵션

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

필수 옵션

createCloudHadoopNotebookInstance의 필수 옵션입니다.

옵션 타입 필수 여부 설명
--cloudHadoopInstanceNo String Required 클러스터 인스턴스 번호
--notebookNodeSubnetNo String Required 노트북 노드 Subnet 번호
--cloudHadoopNotebookName String Required 노트북 이름
  • 영문 소문자, 숫자, 특수문자 -를 조합하여 3~15자 이내로 입력
  • 문자열의 시작은 영문 소문자, 마지막은 영문 소문자 또는 숫자로 구성
--cloudHadoopNotebookComponent String Required 노트북 컴포넌트
--notebookNodeDataStorageSize Integer Required 노트북 노드 스토리지 용량 (GB)
  • 100~2000 (10 GB 단위) | 4000 | 6000
--bucketName String Required Object Storage 버킷 이름
--loginKeyName String Required 인증키 이름

선택 옵션

createCloudHadoopNotebookInstance의 선택 옵션입니다. 지정하지 않은 옵션에는 기본값이 적용됩니다.

옵션 타입 필수 여부 설명
--cloudHadoopNotebookImageProductCode String Optional 노트북 이미지 코드
--engineVersionCode String Optional 엔진 버전 코드
--notebookNodeProductCode String Optional 노트북 노드 서버 타입 코드
--useNotebookBlockStorage Boolean Optional 노트북 노드 스토리지 추가 여부
  • true | false (기본값)
    • true: 추가
    • false: 추가 안 함
--notebookNodeDataStorageTypeCode String Optional 노트북 노드 스토리지 타입
  • SSD (기본값) | HDD
  • 설치 이후 데이터 스토리지 타입 변경 불가

공통 옵션

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

예시

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

명령

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

./ncloud vhadoop createCloudHadoopNotebookInstance \
    --cloudHadoopInstanceNo 34567890 \
    --notebookNodeSubnetNo 23456789 \
    --cloudHadoopNotebookName notebook-01 \
    --cloudHadoopNotebookComponent NOTEBOOK_1.1 \
    --bucketName my-test-bucket \
    --notebookNodeDataStorageSize 100 \
    --loginKeyName test-login-key-01 \
    --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-16T11:14:22+0900",
        "loginKey": "test-login-key-01",
        "objectStorageBucket": "my-test-bucket",
        "accessControlGroupNoList": [],
        "cloudHadoopClusterName": "cluster-01",
        "clusterDirectAccessAccount": "sshuser",
        "cloudHadoopNotebookServerInstanceList": [
          {
            "cloudHadoopNotebookServerName": "n-001-notebook-01-4t0g-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-1",
            "vpcNo": "12345678",
            "subnetNo": "23456789",
            "cpuCount": 4,
            "memorySize": 17179869184,
            "dataStorageSize": 107374182400,
            "isPublicSubnet": true,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
            },
            "createDate": "2026-07-16T11:14:22+0900"
          }
        ]
      }
    ],
    "requestId": "b4b44c80-7e5e-42bf-b8c6-28bf7ce3fab7",
    "returnCode": "0",
    "returnMessage": "success"
  }
}