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 Notebook 인스턴스를 생성합니다.

요청

요청 파라미터

파라미터명 필수 여부 타입 제약 사항 설명
regionCode No String 리전 코드
- getRegionList 액션을 통해 획득 가능
Default: getRegionList 조회 결과의 첫 번째 리전 선택
cloudHadoopNotebookName Yes String 영어, 숫자, 붙임표( - ), 한글만 입력 가능
첫 글자와 마지막 글자는 영문자(소문자) 또는 숫자만 가능
Min: 3
Max: 15
Cloud Hadoop Notebook 이름
- 중복으로 사용할 수 없음
cloudHadoopNotebookImageProductCode No String Cloud Hadoop Notebook 이미지 상품 코드
- getCloudHadoopNotebookImageProductList 액션의 productCode로 획득 가능
- 입력하지 않을 경우 Default값으로 생성
Default : Cloud Hadoop Notebook 최신 버전
cloudHadoopNotebookComponent Yes String Cloud Hadoop Notebook Component
- getCloudHadoopNotebookComponentList 액션을 통해 획득 가능
loginKeyName Yes String 인증키 이름
- getCloudHadoopLoginKeyList 액션을 통해 획득 가능
노드에 직접 접속할 때 필요한 SSH 인증키를 설정
notebookNodeProductCode No String Cloud Hadoop Notebook 서버 상품 코드
- 생성할 Cloud Hadoop Notebook 인스턴스의 서버 스펙 결정 가능
- getCloudHadoopNotebookProductList 액션의 infraResourceDetailTypeCode = 'NTBND'로 설정하여 호출 시 획득 가능
Default: 최소 사양으로 선택됨
최소 사양의 기준: 1. 메모리 2. CPU
notebookNodeSubnetNo Yes String Notebook 노드의 Subent 번호
- Notebook노드를 위치 시킬 Subnet 선택 가능
- Notebook노드는 Private/Public Subnet안에 위치
- notebookNodeSubnetNo는 getCloudHadoopTargetSubnetList 액션을 통해 획득 가능
bucketName Yes String 버킷 이름
- Object Storage에 데이터를 저장하기 위한 공간을 의미
- getCloudHadoopNotebookBucketList 액션을 통해 획득 가능
notebookNodeDataStorageTypeCode Yes String SSD | HDD Notebook 노드의 데이터 스토리지 타입 코드
- 설치 이후에 데이터 스토리지 타입은 변경되지 않음
- Options: SSD | HDD
Default: SSD
notebookNodeDataStorageSize Yes Integer Min: 100
Max: 2000
or
4000, 6000
Notebook 노드의 데이터 스토리지 크기
- 100GB ~ 2000GB 까지 10GB 단위로 입력 가능
- 4000GB, 6000GB 도 사용 가능
useNotebookBlockStorage No Boolean Cloud Hadoop Notebook 데이터 스토리지 사용 여부
- Default: false
cloudHadoopInstanceNo Yes String Notebook과 연동하려는 Cloud Hadoop 클러스터 번호
getCloudHadoopInstanceList 액션을 통해서 획득할 수 있음
output No String 응답 결과의 포맷 타입
- Options: xml | json
- Default: xml

응답

응답 데이터 타입

  • CloudHadoopNotebookInstanceList 타입
CloudHadoopNotebookInstanceList extends CommonResponse
private Integer totalRows;
private List<CloudHadoopNotebookInstance> cloudHadoopNotebookInstanceList = new ArrayList<>();
CloudHadoopNotebookInstance
private String cloudHadoopNotebookInstanceNo;
private String cloudHadoopNotebookName;
private String cloudHadoopNotebookInstanceStatusName;
private CommonCode cloudHadoopNotebookInstanceStatus;
private CommonCode cloudHadoopNotebookInstanceOperation;
private CloudHadoopNotebookComponent cloudHadoopNotebookComponent;
private CloudHadoopNotebookVersion cloudHadoopNotebookVersion;
private String clusterDirectAccessAccount;
private String loginKey;
private String objectStorageBucket;
private String cloudHadoopNotebookImageProductCode;
private String domain;
private AccessControlGroupNoList accessControlGroupNoList;
private Date createDate;
private String cloudHadoopClusterName;
private Boolean useNotebookBlockStorage;
private List<CloudHadoopNotebookServerInstance> cloudHadoopNotebookServerInstanceList;
CloudHadoopNotebookComponent
private String code;
private String codeName;
CloudHadoopNotebookVersion
private String code;
private String codeName;
AccessControlGroupNoList
private List<String> accessControlGroupNoList = new ArrayList<>();
CloudHadoopNotebookServerInstance
private String cloudHadoopNotebookServerInstanceNo;
private String cloudHadoopNotebookServerName;
private String cloudHadoopNotebookServerInstanceStatusName;
private CommonCode cloudHadoopNotebookServerInstanceStatus;
private CommonCode cloudHadoopNotebookServerInstanceOperation;
private CommonCode cloudHadoopNotebookServerRole;
private String regionCode;
private String vpcNo;
private String subnetNo;
private Date createDate;
private Date uptime;
private String zoneCode;
private Long memorySize;
private Integer cpuCount;
private Boolean isPublicSubnet;
private Long dataStorageSize;
private String cloudHadoopNotebookProductCode;
private CommonCode dataStorageType;

예시

호출

ncloud vhadoop createCloudHadoopNotebookInstance --regionCode KR --cloudHadoopNotebookName test*** --cloudHadoopNotebookImageProductCode SW.VCHDP.LNX64.CNTOS.0708.HDNTB.10.B050 --cloudHadoopNotebookComponent NOTEBOOK_COMPONENT_CODE1 --loginKeyName key**** --notebookNodeProductCode SVR.VCHDP.NTBND.STAND.C004.M016.NET.HDD.B050.G002 --notebookNodeSubnetNo 12** --bucketName buc*** --notebookNodeDataStorageTypeCode SSD --notebookNodeDataStorageSize 100 --useNotebookBlockStorage true --cloudHadoopInstanceNo 12**

응답

{
  "createCloudHadoopNotebookInstanceResponse": {
    "totalRows": 1,
    "cloudHadoopNotebookInstanceList": [
      {
        "cloudHadoopNotebookInstanceNo": "2766154",
        "cloudHadoopNotebookName": "test12",
        "cloudHadoopNotebookImageProductCode": "SW.VCHDP.LNX64.CNTOS.0708.HDNTB.10.B050",
        "cloudHadoopNotebookInstanceStatusName": "creating",
        "cloudHadoopNotebookInstanceStatus": {
          "code": "INIT",
          "codeName": "CLOUD DATABASE(VPC) Init State"
        },
        "cloudHadoopNotebookInstanceOperation": {
          "code": "CREAT",
          "codeName": "CLOUD DATABASE(VPC) Creat OP"
        },
        "cloudHadoopNotebookVersion": {
          "code": "NOTEBOOK1.0",
          "codeName": "Notebook 1.0"
        },
        "cloudHadoopNotebookComponent": {
          "code": "NOTEBOOK_1.0",
          "codeName": "Jupyter notebook 6.4.10 , JupyterLab : 3.2.9"
        },
        "createDate": "2023-02-07T20:40:50+0900",
        "loginKey": "newkey",
        "objectStorageBucket": "aabbcc",
        "accessControlGroupNoList": [],
        "cloudHadoopClusterName": "fsdfds",
        "clusterDirectAccessAccount": "sshuser",
        "useNotebookBlockStorage": true,
        "cloudHadoopNotebookServerInstanceList": [
          {
            "cloudHadoopNotebookServerName": "n-001-test12-15dk-hd",
            "cloudHadoopNotebookServerInstanceStatusName": "creating",
            "cloudHadoopNotebookServerInstanceStatus": {
              "code": "PEND",
              "codeName": "CLOUD DATABASE(VPC) Server Pending State"
            },
            "cloudHadoopNotebookServerInstanceOperation": {
              "code": "CREAT",
              "codeName": "CLOUD DATABASE(VPC) Server Create OP"
            },
            "cloudHadoopNotebookServerRole": {
              "code": "N",
              "codeName": "Notebook Node"
            }, 
            "cloudHadoopNotebookProductCode": "SVR.VCHDP.NTBND.STAND.C004.M016.NET.HDD.B050.G002",
            "regionCode": "KR",
            "zoneCode": "KR-2",
            "vpcNo": "3977",
            "subnetNo": "5747",
            "cpuCount": 4,
            "memorySize": 17179869184,
            "dataStorageSize": 107374182400,
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
             },
            "createDate": "2023-02-07T20:40:50+0900"
          }
        ]
      }
    ],
    "requestId": "9a425589-09e1-4202-94df-f2102dcca882",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
<createCloudHadoopNotebookInstanceResponse>
  <requestId>ff98794d-34b7-42ac-8154-14b7afa479cb</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <cloudHadoopNotebookInstanceList>
    <cloudHadoopNotebookInstance>
      <cloudHadoopNotebookInstanceNo>2766068</cloudHadoopNotebookInstanceNo>
      <cloudHadoopNotebookName>test123</cloudHadoopNotebookName>
      <cloudHadoopNotebookImageProductCode>SW.VCHDP.LNX64.CNTOS.0708.HDNTB.10.B050</cloudHadoopNotebookImageProductCode>
      <cloudHadoopNotebookInstanceStatusName>creating</cloudHadoopNotebookInstanceStatusName>
      <cloudHadoopNotebookInstanceStatus>
        <code>INIT</code>
        <codeName>CLOUD DATABASE(VPC) Init State</codeName>
      </cloudHadoopNotebookInstanceStatus>
      <cloudHadoopNotebookInstanceOperation>
        <code>CREAT</code>
        <codeName>CLOUD DATABASE(VPC) Creat OP</codeName>
      </cloudHadoopNotebookInstanceOperation>
      <cloudHadoopNotebookVersion>
        <code>NOTEBOOK1.0</code>
        <codeName>Notebook 1.0</codeName>
      </cloudHadoopNotebookVersion>
      <cloudHadoopNotebookComponent>
        <code>NOTEBOOK_COMPONENT_CODE1</code>
        <codeName>Jupyter notebook 6.4.10 , JupyterLab : 3.2.9</codeName>
      </cloudHadoopNotebookComponent>
      <createDate>2023-02-07T20:16:55+0900</createDate>
      <loginKey>newkey</loginKey>
      <objectStorageBucket>aabbcc</objectStorageBucket>
      <accessControlGroupNoList/>
      <cloudHadoopClusterName>fsdfds</cloudHadoopClusterName>
      <clusterDirectAccessAccount>sshuser</clusterDirectAccessAccount>
      <useNotebookBlockStorage>true</useNotebookBlockStorage>
      <cloudHadoopNotebookServerInstanceList>
        <cloudHadoopNotebookServerInstance>
          <cloudHadoopNotebookServerName>n-001-test123-15d8-hd</cloudHadoopNotebookServerName>
          <cloudHadoopNotebookServerInstanceStatusName>creating</cloudHadoopNotebookServerInstanceStatusName>
          <cloudHadoopNotebookServerInstanceStatus>
            <code>PEND</code>
            <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
          </cloudHadoopNotebookServerInstanceStatus>
          <cloudHadoopNotebookServerInstanceOperation>
            <code>CREAT</code>
            <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
          </cloudHadoopNotebookServerInstanceOperation>
          <cloudHadoopNotebookServerRole>
            <code>N</code>
            <codeName>Notebook Node</codeName>
          </cloudHadoopNotebookServerRole> 
          <cloudHadoopNotebookProductCode>SVR.VCHDP.NTBND.STAND.C004.M016.NET.HDD.B050.G002</cloudHadoopNotebookProductCode>
          <regionCode>KR</regionCode>
          <zoneCode>KR-2</zoneCode>
          <vpcNo>3977</vpcNo>
          <subnetNo>5747</subnetNo>
          <cpuCount>4</cpuCount>
          <memorySize>17179869184</memorySize>
          <dataStorageSize>107374182400</dataStorageSize>
          <isPublicSubnet>false</isPublicSubnet>
          <dataStorageType>
    <code>SSD</code>
    <codeName>SSD</codeName>
</dataStorageType> 
          <createDate>2023-02-07T20:16:55+0900</createDate>
        </cloudHadoopNotebookServerInstance>
      </cloudHadoopNotebookServerInstanceList>
    </cloudHadoopNotebookInstance>
  </cloudHadoopNotebookInstanceList>
</createCloudHadoopNotebookInstanceResponse>