createCloudHadoopNotebookInstance

인쇄
공유
PDF

기사 요약

이 요약이 도움이 되었나요?

의견을 보내 주셔서 감사합니다.

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 액션을 통해서 획득할 수 있음
engineVersionCode	Conditional	String		엔진 버전 코드 getCloudHadoopImageProductList를 통해 확인 Rocky 클러스터로 생성 시에만 입력, CentOS 스펙은 무시 미입력 시 현재 제공 중인 최신 버전으로 생성
responseFormatType	No	String		응답 결과의 포맷 타입 - Options: xml \| json - Default: xml

요청 헤더

Cloud Hadoop(VPC) 개요 참조

요청 바디

{
  "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"
}

응답

응답 바디

CloudHadoopNotebookInstanceList

오류 코드

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."
  }
}

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

What's Next

deleteCloudHadoopInstance

요청
응답
오류 코드
예시

태그

Cloud Hadoop