createCloudHadoopInstance

Article summary

Did you find this summary helpful?

Thank you for your feedback

We are preparing a localization service for the content. We will do our best to provide the localization service as soon as possible.

Overview

Creates a Cloud Hadoop cluster.

Request

Request Header

Refer to Cloud Hadoop API Guide

Request Body

Parameter	Description	Required	Default value	Available values	Data type
zoneNo	Zone number	N	3	`[3] for KR-2 Zone`	String
regionNo	Region number	N	1	`[1] for KR Region`	String
cloudHadoopClusterName	Cloud Hadoop cluster name	Y		See the table below.	String
cloudHadoopImageProductCode	Cloud Hadoop image product code	N			String
cloudHadoopClusterTypeCode	Cloud Hadoop cluster type code	Y		`[CHADP]Core Hadoop, [HBASE] Hbase, [SPARK] Spark`	String
cloudHadoopAdminName	Cloud Hadoop administrator name	Y			String
cloudHadoopAdminPassword	Cloud Hadoop administrator password	Y			String
loginKeyName	Login key name	Y			String
bucketName	Bucket name	Y			String
masterNodeProductCode	Master node product code	Y		See the table below.	String
masterNodeCount	Number of master nodes	N	2	MIN: 1, MAX: 2	Integer
workerNodeProductCode	Worker node product code	Y		See the table below.	String
workerNodeCount	Number of worker nodes	N	4	MIN: 1, MAX: 8	Integer

cloudHadoopImageProductCode

Product code	Product name	Product type	Description
SPSWCHADPLINUX01	Cloud Hadoop 1.0	LINUX	CentOS 7.3 with Cloud Hadoop 1.0

masterNodeProductCode, workerNodeProductCode

Product code	Product name
SPSVRCHADP000001	vCPU 4EA, Memory 8 GB
SPSVRCHADP000002	vCPU 4EA, Memory 16 GB
SPSVRCHADP000003	vCPU 8EA, Memory 16 GB
SPSVRCHADP000004	vCPU 8EA, Memory 32 GB
SPSVRCHADP000005	vCPU 16EA, Memory 32 GB
SPSVRCHADP000006	vCPU 4EA, Memory 32 GB
SPSVRCHADP000007	vCPU 8EA, Memory 64 GB
SPSVRCHADP000008	vCPU 16EA, Memory 128 GB
SPSVRCHADP000009	vCPU 32EA, Memory 256 GB

Response

Success

{
    "createCloudHadoopInstanceResponse": {
        "requestId": "<api-call-request-id>",
        "returnCode": "0",
        "returnMessage": "success",
        "totalRows": <response-list-length>,
        "cloudHadoopInstanceList": [
            {
                "cloudHadoopInstanceNo": "<cluster-id>",
                "cloudHadoopClusterName": "<cluster-name>",
                "cloudHadoopImageProductCode": "<image-code-installed-in-cluster>",
                "cloudHadoopClusterType": {
                    "code": "<cluster-type-code>",
                    "codeName": "<cluster-type-name>"
                },
                "masterNodeCpuCount": <masternode-cpu-count>,
                "masterNodeCount": <masternode-instance-count>,
                "masterNodeMemorySize": <masternode-memory(Byte)>,
                "workerNodeCpuCount": <workernode-cpu-count>,
                "workerNodeCount": <workernode-instance-count>,
                "workerNodeMemorySize": <workernode-memory(Byte)>,
                "cloudHadoopInstanceOperation": {
                    "code": "<cluster-work-code>",
                    "codeName": "<cluster-work-name>"
                },
                "cloudHadoopInstanceStatus": {
                    "code": "<cluster-status-code>",
                    "codeName": "<cluster-status-name>"
                },
                "cloudHadoopInstanceStatusName": "<cluster-status-name>",
                "publicDnsName": "<public-domain-name>",
                "publicIp": "<public-ip>",
                "isHa": <whether-HA-is-enabled>,
                "zone": {
                    "zoneNo": "<Zone-id>",
                    "zoneName": "<Zone-name>",
                    "zoneCode": "<Zone-code>",
                    "zoneDescription": "<Zone-description>",
                    "regionNo": "<Region-id>"
                },
                "region": {
                    "regionNo": "<Region-id>",
                    "regionCode": "<Region-code>",
                    "regionName": "<Region-name>"
                },
                "masterNodeServerName": "",
                "createDate": "<creation-date>",
                "dataArchitecture": "<",
                "bucketName": "<object-storage-name>",
                "directConnectionAccount": "<server-access-account>",
                "loginKeyName": "<login-pem-key-name>",
                "accessControlGroupList": [
                    {
                        "accessControlGroupConfigurationNo": "<ACG-id>",
                        "accessControlGroupName": "<ACG-name>",
                        "accessControlGroupDescription": "<ACG-description>",
                        "isDefault": <whether-it-is-default-ACG>,
                        "createDate": "<ACG-creation-time>"
                    }
                ]
            }
        ]
    }
}

Authentication failed

{
    "error": {
        "errorCode": "<return-code>",
        "message": "<return-message>"
    }
}

Bad parameter

{
    "responseError": {
        "returnCode": "<return-code>",
        "returnMessage": "<return-message>"
    }
}

Examples

Request Example

curl -d '{"cloudHadoopClusterName":"cluster-01", "cloudHadoopClusterTypeCode":'CHADP', \
    "cloudHadoopAdminName":'admin', "cloudHadoopAdminPassword":'admin^password', \
    "loginKeyName":'user-dev-key', "bucketName":"user-bucket", \
    "masterNodeProductCode":'SPSVRCHADP000001', "workerNodeProductCode":'SPSVRCHADP000001', \
    "responseFormatType":"json"}'
   -H "content-type:application/x-www-form-urlencoded"
   -H "accept:application/json"
   -H "x-ncp-apigw-timestamp:1505290625682" \
   -H "x-ncp-iam-access-key:D78BB444D6D3C84CA38A" \
   -H "x-ncp-apigw-signature-v2:WTPItrmMIfLUk/UyUIyoQbA/z5hq9o3G8eQMolUzTEo=" \
   -X POST https://ncloud.apigw.ntruss.com/hadoop/v2/createCloudHadoopInstanceResponse \

Request Example

{
    "createCloudHadoopInstanceResponse": {
        "requestId": "a4d67aee-fef6-4cb4-bf80-63c9763a1a76",
        "returnCode": "0",
        "returnMessage": "success",
        "totalRows": 1,
        "cloudHadoopInstanceList": [
            {
                "cloudHadoopInstanceNo": "1137409",
                "cloudHadoopClusterName": "cluster-01",
                "cloudHadoopClusterType": {
                    "code": "CHADP",
                    "codeName": "Core Hadoop"
                },
                "masterNodeCpuCount": 4,
                "masterNodeCount": 2,
                "masterNodeMemorySize": 8589934592,
                "workerNodeCpuCount": 4,
                "workerNodeCount": 4,
                "workerNodeMemorySize": 8589934592,
                "cloudHadoopInstanceOperation": {
                    "code": "CREAT",
                    "codeName": "Cloud Hadoop CREATE OP"
                },
                "cloudHadoopInstanceStatus": {
                    "code": "INIT",
                    "codeName": "Cloud Hadoop INIT State"
                },
                "cloudHadoopInstanceStatusName": "creating",
                "isHa": true,
                "zone": {
                    "zoneNo": "3",
                    "zoneName": "KR-2",
                    "zoneCode": "KR-2",
                    "zoneDescription": "\ud3c9\ucd0c zone",
                    "regionNo": "1"
                },
                "region": {
                    "regionNo": "1",
                    "regionCode": "KR",
                    "regionName": "Korea"
                },
                "masterNodeServerName": "m-001-cluster-01-hd",
                "createDate": "2018-12-21T18:50:34+0900",
                "dataArchitecture": "Object Storage",
                "bucketName": "user-bucket",
                "directConnectionAccount": "sshuser",
                "loginKeyName": "user-dev-key",
                "accessControlGroupList": [
                    {
                        "accessControlGroupConfigurationNo": "75554",
                        "accessControlGroupName": "cloud-hadoop-odmp",
                        "accessControlGroupDescription": "Group for Cloud Hadoop cluster 'cluster-01' (automatically created)",
                        "isDefault": false,
                        "createDate": "2018-12-21T18:50:35+0900"
                    }
                ]
            }
        ]
    }
}

Was this article helpful?

What's Next

deleteCloudHadoopInstance

Table of contents

Overview
Request
Response
Examples