Documentation Index

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

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

createCloudHadoopNotebookInstance

Prev Next

개요

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 String generationCode;
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 FKR --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": "****154",
        "cloudHadoopNotebookName": "****",
        "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"
        },
        "generationCode": "G2",
        "createDate": "2023-02-07T20:40:50+0900",
        "loginKey": "newkey",
        "objectStorageBucket": "****c",
        "accessControlGroupNoList": [],
        "cloudHadoopClusterName": "****",
        "clusterDirectAccessAccount": "sshuser",
        "useNotebookBlockStorage": true,
        "cloudHadoopNotebookServerInstanceList": [
          {
            "cloudHadoopNotebookServerName": "n-001-****-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": "FKR",
            "zoneCode": "FKR-2",
            "vpcNo": "**77",
            "subnetNo": "**47",
            "cpuCount": 4,
            "memorySize": 17179869184,
            "dataStorageSize": 107374182400,
            "isPublicSubnet": false,
            "dataStorageType": {
              "code": "SSD",
              "codeName": "SSD"
             },
            "createDate": "2023-02-07T20:40:50+0900"
          }
        ]
      }
    ],
    "requestId": "9a425589-09e1-****-94df-****2dcca882",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
<createCloudHadoopNotebookInstanceResponse>
  <requestId>ff98794d-34b7-****-8154-****afa479cb</requestId>
  <returnCode>0</returnCode>
  <returnMessage>success</returnMessage>
  <totalRows>1</totalRows>
  <cloudHadoopNotebookInstanceList>
    <cloudHadoopNotebookInstance>
      <cloudHadoopNotebookInstanceNo>****068</cloudHadoopNotebookInstanceNo>
      <cloudHadoopNotebookName>****</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>
      <generationCode>G2</generationCode>
      <createDate>2023-02-07T20:16:55+0900</createDate>
      <loginKey>newkey</loginKey>
      <objectStorageBucket>aabbcc</objectStorageBucket>
      <accessControlGroupNoList/>
      <cloudHadoopClusterName>****</cloudHadoopClusterName>
      <clusterDirectAccessAccount>sshuser</clusterDirectAccessAccount>
      <useNotebookBlockStorage>true</useNotebookBlockStorage>
      <cloudHadoopNotebookServerInstanceList>
        <cloudHadoopNotebookServerInstance>
          <cloudHadoopNotebookServerName>n-001-****-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>FKR</regionCode>
          <zoneCode>FKR-2</zoneCode>
          <vpcNo>**77</vpcNo>
          <subnetNo>**47</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>