createCloudHadoopNotebookInstance
    • PDF

    createCloudHadoopNotebookInstance

    • PDF

    기사 요약

    VPC 환경에서 이용 가능합니다.

    Cloud Hadoop Notebook 인스턴스를 생성합니다.

    요청

    요청 파라미터

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

    요청 헤더

    공통 가이드 참조

    요청 바디

    {
      "regionCode": "string",
      "cloudHadoopNotebookName": "string",
      "cloudHadoopNotebookImageProductCode": "string",
      "cloudHadoopNotebookComponent": "string",
      "loginKeyName": "string",
      "bucketName": "string",
      "notebookNodeProductCode": "string",
      "notebookNodeSubnetNo": "string",
      "notebookNodeDataStorageTypeCode": "string",
      "notebookNodeDataStorageSize": 0,
      "useNotebookBlockStorage": "string",
      "cloudHadoopInstanceNo": "string",
      "responseFormatType": "string"
    }
    

    응답

    응답 바디

    오류 코드

    Cloud Hadoop(VPC) 개요 참조

    예시

    요청 예시

    GET {API_URL}/createCloudHadoopNotebookInstance
    ?regionCode=KR
    &cloudHadoopNotebookName=test***
    &cloudHadoopNotebookImageProductCode=SW.VCHDP.LNX64.CNTOS.0708.HDNTB.10.B050
    &cloudHadoopNotebookComponent=NOTEBOOK_1.0 
    &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_1.0</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>
    

    오류응답 예시

    {
      "responseError": {
        "returnCode": "5001386",
        "returnMessage": "Notebook node storage type/capacity selection is available only if you select Add Notebook Node Storage."
      }
    }
    

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.