createCloudHadoopInstance
  • PDF

createCloudHadoopInstance

  • PDF

It can be used in a VPC environment.

Summary

Create a Cloud Hadoop instance.

Request

Request parameters

Parameter name Requirement status Type Restrictions Description
regionCode No String - Region code
- You can decide the region in which the Cloud Hadoop instance will be created.
- You can obtain the regionCode through the getRegionList action.
- Default: Select the first region of the getRegionList search results.
vpcNo Yes String - VPC number
- Determine the VPC where the Cloud Hadoop instance will be created.
- You can obtain the vpcNo through the getVpcList action.
cloudHadoopImageProductCode No String - Cloud Hadoop image product code
- You can obtain the cloudHadoopImageProductCode through the productCode of the getCloudHadoopImageProductList action.
- It will be created with the default value if no input is entered.
- Default : The latest version of CloudHadoop
masterNodeProductCode Conditional String - Cloud Hadoop master server product code
- You can decide the server specifications of the Cloud Hadoop instance to be created.
- You can obtain the masterNodeProductCode by setting the getCloudHadoopProductList action's infraResourceDetailTypeCode = 'MSTDT' and calling.
- Default: The minimum specifications are selected. The minimum specifications are: 1. Memory, 2. CPU.
edgeNodeProductCode Conditional String - Cloud Hadoop edge server product code
- You can decide the server specifications of the Cloud Hadoop instance to be created.
- You can obtain the edgeNodeProductCode by setting the getCloudHadoopProductList action's infraResourceDetailTypeCode = 'EDGND' and calling it.
- Default: The minimum specifications are selected. The minimum specifications are: 1. Memory, 2. CPU.
workerNodeProductCode Conditional String - Cloud Hadoop worker server product code
- You can decide the server specifications of the Cloud Hadoop instance to be created.
- You can obtain the workerNodeProductCode by setting the getCloudHadoopProductList action's infraResourceDetailTypeCode = 'MSTDT' and calling it.
- Default: The minimum specifications are selected. The minimum specifications are: 1. Memory, 2. CPU.
cloudHadoopClusterName Yes String - Only Korean and English letters, numbers, and some special characters (-) can be entered.
- It must start and end with an English letter (lowercase) or a number.
- Min: 3, Max: 15
Cloud Hadoop cluster name
cloudHadoopClusterTypeCode Yes String - Cloud Hadoop cluster type code
- You can obtain the cloudHadoopClusterTypeCode through the getCloudHadoopClusterTypeList action.
cloudHadoopAddOnCodeList No List<String> - Cloud Hadoop add-on list
- It's only used in CloudHadoop versions 1.5 or higher.
- You can obtain the cloudHadoopAddOnCode through the getCloudHadoopAddOnList action.
- Options: PRESTO | HBASE
- ex) cloudHadoopAddOnCodeList PRESTO,HBASE
cloudHadoopAdminUserName Yes String - It must contain at least one uppercase English letter, one special character, and one number.
- ',", ₩, /, &, ` and spaces can't be included.
- Min:8, Max:20
- Cluster admin password
- It's the password for admin account required to access Ambari management console.
cloudHadoopAdminUserPassword Yes String - It must only contain English letters (lowercase), numbers, and hyphens (-).
- It must start and end with an English letter (lowercase) or a number.
- Min : 3, Max: 15
Cluster admin user name
- It's the admin account required to access Ambari management console.
loginKeyName Yes String - Name of the authentication key.
- loginKeyName can be obtained through getCloudHadoopLoginKeyList action.
- Set the SSH authentication key required for connecting directly to the node.
edgeNodeSubnetNo Yes String - Edge node's subnet number
- You can select a subnet in which you'll locate an edge node. Edge nodes can be located in private/public subnets.
- You can obtain the edgeNodeSubnetNo through the getSubnetList action.
masterNodeSubnetNo Yes String - Master node's subnet number
- You can select a subnet in which you'll locate the master node. Master node can be located in private/public subnets.
- You can obtain the masterNodeSubnetNo through the getSubnetList action.
bucketName Yes String - Bucket name
- Meaning the space to store data in Object Storage
- bucketName can be obtained through getCloudHadoopBucketList action
workerNodeSubnetNo Yes String - Worker node's subnet number
- You can select a subnet in which you'll locate worker nodes. Worker nodes can only be located in private subnets.
- You can obtain the workerNodeSubnetNo through the getSubnetList action.
masterNodeDataStorageTypeCode Yes String SSD | HDD - Master node's data storage type code
- The data storage type can't be changed after installation.
- Options: SSD | HDD
Default: SSD
workerNodeDataStorageTypeCode Yes String SSD | HDD - Worker node's data storage type code
- The data storage type can't be changed after installation.
- Options: SSD | HDD
Default: SSD
masterNodeDataStorageSize Yes Integer Min: 100, Max: 2000 - Master node's data storage size
- It can be entered in the units of 10 GB, between 100 GB and 2000 GB. 4000 GB and 6000 GB storages are also available.
workerNodeDataStorageSize Yes Integer Min: 100, Max: 2000 - Worker node's data storage size
- It can be entered in the units of 10 GB, between 100 GB and 2000 GB. 4000 GB and 6000 GB storages are also available.
workerNodeCount No Integer - Number of worker nodes
- You can select the number of the worker nodes between 2 and 8.
- Default : 2
useKdc No Boolean - Whether to use Kerberos authentication configuration
- Kerberos is used to configure secure Hadoop clusters.
- Default: false
kdcRealm Conditional String - KDC's realm information
- Only the domain rules in the realm format are allowed.
kdcPassword Conditional String KDC admin account's password
useBootstrapScript No Boolean - Whether to use Cloud Hadoop bootstrap script
- Default: false
bootstrapScript Conditional String - Only English letters are supported. Spaces and special characters are not allowed.
- The maximum length is 1024 bytes.
- Cloud Hadoop bootstrap script
- The script can only be run onto the bucket linked to Cloud Hadoop.
- Down to the folder and file names should be entered, excluding the bucket name.
- Default: false
output No String - Format type for the response results
- Options: xml | json
- Default: json

Response

Response data type

  • CloudHadoopInstanceList type
CloudHadoopInstanceList extends CommonResponse
private Integer totalRows;
private List<CloudHadoopInstance> cloudHadoopInstanceList = new ArrayList<>();
CloudHadoopInstance
private String cloudHadoopInstanceNo;
private String cloudHadoopClusterName;
private String cloudHadoopInstanceStatusName;
private CommonCode cloudHadoopInstanceStatus;
private CommonCode cloudHadoopInstanceOperation;
private CloudHadoopClusterType cloudHadoopClusterType;
private CloudHadoopVersion cloudHadoopVersion;
private List<CloudHadoopAddOn> cloudHadoopAddOnList
private String ambariServerHost;
private String clusterDirectAccessAccount;
private String loginKey;
private String objectStorageBucket;
private String kdcRealm;
private String cloudHadoopImageProductCode;
private Boolean isHa;
private String domain;
private AccessControlGroupNoList accessControlGroupNoList;
private Date createDate;
private List<CloudHadoopServerInstance> cloudHadoopServerInstanceList;
CloudHadoopAddOn
private String code;
private String codeName;
CloudHadoopClusterType
private String code;
private String codeName;
CloudHadoopVersion
private String code;
private String codeName;
AccessControlGroupNoList
private List<String> accessControlGroupNoList = new ArrayList<>();
CloudHadoopServerInstance
private String cloudHadoopServerInstanceNo;
private String cloudHadoopServerName;
private String cloudHadoopServerInstanceStatusName;
private CommonCode cloudHadoopServerInstanceStatus;
private CommonCode cloudHadoopServerInstanceOperation;
private CommonCode cloudHadoopServerRole;
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 cloudHadoopProductCode;
private CommonCode dataStorageType;

Examples

Request example

ncloud vhadoop createCloudHadoopInstance --regionCode KR --vpcNo **65 --cloudHadoopImageProductCode SW.VCHDP.LNX64.CNTOS.0708.HDP.15.B050 --masterNodeProductCode SVR.VCHDP.MSTDT.HIMEM.C004.M032.NET.HDD.B050.G002 --edgeNodeProductCode SVR.VCHDP.EDGND.STAND.C004.M016.NET.HDD.B050.G002 --workerNodeProductCode SVR.VCHDP.MSTDT.HICPU.C008.M016.NET.HDD.B050.G002 --cloudHadoopClusterName test*** --cloudHadoopClusterTypeCode CORE_HADOOP_WITH_SPARK --cloudHadoopAddOnCodeList PRESTO --cloudHadoopAdminUserName test-*** --cloudHadoopAdminUserPassword ******* --loginKeyName key**** --bucketName buc*** --edgeNodeSubnetNo 11** --masterNodeSubnetNo 11** --workerNodeSubnetNo 12** --masterNodeDataStorageTypeCode SSD --workerNodeDataStorageTypeCode SSD --masterNodeDataStorageSize 100 --workerNodeDataStorageSize 100 --workerNodeCount 2 --useKdc true --kdcRealm EX**LE.COM --kdcPassword ********* --useBootstrapScript true --bootstrapScript init-script/example.sh

Response example


<createCloudHadoopInstanceResponse>
    <requestId>b8828eca-c3f8-4ddb-86dd-3355026b4b94</requestId>
    <returnCode>0</returnCode>
    <returnMessage>success</returnMessage>
    <totalRows>1</totalRows>
    <cloudHadoopInstanceList>
        <cloudHadoopInstance>
            <cloudHadoopInstanceNo>***4904</cloudHadoopInstanceNo>
            <cloudHadoopClusterName>test***</cloudHadoopClusterName>
            <cloudHadoopInstanceStatusName>creating</cloudHadoopInstanceStatusName>
            <cloudHadoopInstanceStatus>
                <code>INIT</code>
                <codeName>CLOUD DATABASE(VPC) Init State</codeName>
            </cloudHadoopInstanceStatus>
            <cloudHadoopInstanceOperation>
                <code>CREAT</code>
                <codeName>CLOUD DATABASE(VPC) Creat OP</codeName>
            </cloudHadoopInstanceOperation>
            <cloudHadoopClusterType>
                <code>CORE_HADOOP_WITH_SPARK</code>
                <codeName>Core Hadoop with Spark : HDFS(3.1.1), YARN(3.1.1), Zookeeper(3.4.6), Ranger(1.2.0), HIVE(3.1.0), Hue(4.3.0), Zepplin Notebook(0.8.0), Spark(2.4.8)</codeName>
            </cloudHadoopClusterType>
            <cloudHadoopVersion>
                <code>SW.VCHDP.LNX64.CNTOS.0708.HDP.16.B050</code>
                <codeName>Cloud Hadoop 1.6</codeName>
            </cloudHadoopVersion>
            <ambariServerHost>e-001-dasfxc-mel-hd</ambariServerHost>
            <clusterDirectAccessAccount>***user</clusterDirectAccessAccount>
            <loginKey>****</loginKey>
            <objectStorageBucket>****</objectStorageBucket>
            <cloudHadoopImageProductCode>SW.VCHDP.LNX64.CNTOS.0708.HDP.16.B050</cloudHadoopImageProductCode>
            <isHa>true</isHa>
            <createDate>2021-11-09T18:55:29+0900</createDate>
            <accessControlGroupNoList>
                <accessControlGroupNo>11728</accessControlGroupNo>
            </accessControlGroupNoList>
            <cloudHadoopServerInstanceList>
                <cloudHadoopServerInstance>
                    <cloudHadoopServerName>****</cloudHadoopServerName>
                    <cloudHadoopServerRole>
                        <code>E</code>
                        <codeName>Edge Node</codeName>
                    </cloudHadoopServerRole>
                    <cloudHadoopServerInstanceStatusName>creating</cloudHadoopServerInstanceStatusName>
                    <cloudHadoopServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudHadoopServerInstanceStatus>
                    <cloudHadoopServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudHadoopServerInstanceOperation>
                    <cloudHadoopProductCode>SVR.VCHDP.EDGND.STAND.C004.M016.NET.HDD.B050.G002</cloudHadoopProductCode>
                    <regionCode>KR</regionCode>
                    <zoneCode>KR-2</zoneCode>
                    <vpcNo>**65</vpcNo>
                    <subnetNo>**23</subnetNo>
                    <isPublicSubnet>false</isPublicSubnet>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>4</cpuCount>
                    <memorySize>17179869184</memorySize>
                    <createDate>2021-11-09T18:55:29+0900</createDate>
                </cloudHadoopServerInstance>
                <cloudHadoopServerInstance>
                    <cloudHadoopServerName>****</cloudHadoopServerName>
                    <cloudHadoopServerRole>
                        <code>M</code>
                        <codeName>Master Node</codeName>
                    </cloudHadoopServerRole>
                    <cloudHadoopServerInstanceStatusName>creating</cloudHadoopServerInstanceStatusName>
                    <cloudHadoopServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudHadoopServerInstanceStatus>
                    <cloudHadoopServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudHadoopServerInstanceOperation>
                    <cloudHadoopProductCode>SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002</cloudHadoopProductCode>
                    <regionCode>KR</regionCode>
                    <zoneCode>KR-2</zoneCode>
                    <vpcNo>**65</vpcNo>
                    <subnetNo>**23</subnetNo>
                    <isPublicSubnet>false</isPublicSubnet>
                    <dataStorageType>
                        <code>SSD</code>
                        <codeName>SSD</codeName>
                    </dataStorageType>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>4</cpuCount>
                    <memorySize>17179869184</memorySize>
                    <createDate>2021-11-09T18:55:29+0900</createDate>
                </cloudHadoopServerInstance>
                <cloudHadoopServerInstance>
                    <cloudHadoopServerName>****</cloudHadoopServerName>
                    <cloudHadoopServerRole>
                        <code>M</code>
                        <codeName>Master Node</codeName>
                    </cloudHadoopServerRole>
                    <cloudHadoopServerInstanceStatusName>creating</cloudHadoopServerInstanceStatusName>
                    <cloudHadoopServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudHadoopServerInstanceStatus>
                    <cloudHadoopServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudHadoopServerInstanceOperation>
                    <cloudHadoopProductCode>SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002</cloudHadoopProductCode>
                    <regionCode>KR</regionCode>
                    <zoneCode>KR-2</zoneCode>
                    <vpcNo>**65</vpcNo>
                    <subnetNo>**23</subnetNo>
                    <isPublicSubnet>false</isPublicSubnet>
                    <dataStorageType>
                        <code>SSD</code>
                        <codeName>SSD</codeName>
                    </dataStorageType>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>4</cpuCount>
                    <memorySize>17179869184</memorySize>
                    <createDate>2021-11-09T18:55:29+0900</createDate>
                </cloudHadoopServerInstance>
                <cloudHadoopServerInstance>
                    <cloudHadoopServerName>****</cloudHadoopServerName>
                    <cloudHadoopServerRole>
                        <code>D</code>
                        <codeName>Date Node</codeName>
                    </cloudHadoopServerRole>
                    <cloudHadoopServerInstanceStatusName>creating</cloudHadoopServerInstanceStatusName>
                    <cloudHadoopServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudHadoopServerInstanceStatus>
                    <cloudHadoopServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudHadoopServerInstanceOperation>
                    <cloudHadoopProductCode>SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002</cloudHadoopProductCode>
                    <regionCode>KR</regionCode>
                    <zoneCode>KR-2</zoneCode>
                    <vpcNo>**65</vpcNo>
                    <subnetNo>**23</subnetNo>
                    <isPublicSubnet>false</isPublicSubnet>
                    <dataStorageType>
                        <code>SSD</code>
                        <codeName>SSD</codeName>
                    </dataStorageType>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>4</cpuCount>
                    <memorySize>17179869184</memorySize>
                    <createDate>2021-11-09T18:55:29+0900</createDate>
                </cloudHadoopServerInstance>
                <cloudHadoopServerInstance>
                    <cloudHadoopServerName>****</cloudHadoopServerName>
                    <cloudHadoopServerRole>
                        <code>D</code>
                        <codeName>Date Node</codeName>
                    </cloudHadoopServerRole>
                    <cloudHadoopServerInstanceStatusName>creating</cloudHadoopServerInstanceStatusName>
                    <cloudHadoopServerInstanceStatus>
                        <code>PEND</code>
                        <codeName>CLOUD DATABASE(VPC) Server Pending State</codeName>
                    </cloudHadoopServerInstanceStatus>
                    <cloudHadoopServerInstanceOperation>
                        <code>CREAT</code>
                        <codeName>CLOUD DATABASE(VPC) Server Create OP</codeName>
                    </cloudHadoopServerInstanceOperation>
                    <cloudHadoopProductCode>SVR.VCHDP.MSTDT.STAND.C004.M016.NET.HDD.B050.G002</cloudHadoopProductCode>
                    <regionCode>KR</regionCode>
                    <zoneCode>KR-2</zoneCode>
                    <vpcNo>**65</vpcNo>
                    <subnetNo>**23</subnetNo>
                    <isPublicSubnet>false</isPublicSubnet>
                    <dataStorageType>
                        <code>SSD</code>
                        <codeName>SSD</codeName>
                    </dataStorageType>
                    <dataStorageSize>107374182400</dataStorageSize>
                    <cpuCount>4</cpuCount>
                    <memorySize>17179869184</memorySize>
                    <createDate>2021-11-09T18:55:29+0900</createDate>
                </cloudHadoopServerInstance>
            </cloudHadoopServerInstanceList>
        </cloudHadoopInstance>
    </cloudHadoopInstanceList>
</createCloudHadoopInstanceResponse>

Was this article helpful?