createCloudHadoopNotebookInstance

인쇄
공유
PDF

기사 요약

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

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

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 액션을 통해서 획득할 수 있음
responseFormatType	No	String		응답 결과의 포맷 타입 - 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"
}

응답

응답 바디

CloudHadoopNotebookInstanceList

오류 코드

Cloud Hadoop 개요 참조

예시

요청 예시

GET {API_URL}/createCloudHadoopNotebookInstance
?regionCode=FKR
&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": "FKR",
            "zoneCode": "FKR-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>FKR</regionCode>
          <zoneCode>FKR-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