Creating a cloud data streaming service cluster

Article summary

Did you find this summary helpful?

Thank you for your feedback

Available in VPC

Description

How to create a cloud data streaming service cluster

Requests

Request URL

POST https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/createCDSSCluster [KR]
POST https://clouddatastreamingservice.apigw.ntruss.com/api/sgn-v1/cluster/createCDSSCluster [SGN]
POST https://clouddatastreamingservice.apigw.ntruss.com/api/jpn-v1/cluster/createCDSSCluster [JPN]

Request headers

Header name	Description
x-ncp-apigw-timestamp	Time elapsed in milliseconds since January 1, 1970, 00:00:00 UTC If the time difference compared to the API Gateway server is more than 5 minutes, then the request is considered invalid. `x-ncp-apigw-timestamp:{Timestamp}`
x-ncp-iam-access-key	Access key ID value issued from NAVER Cloud Platform portal `x-ncp-iam-access-key:{Account Access Key}`
x-ncp-apigw-signature-v2	Signature encrypted with the access key ID value and secret key `x-ncp-apigw-signature-v2:{API Gateway Signature}`
Content-Type	Set the request body content type to application/json `Content-Type: application/json`

Request parameters

Parameter	Type	Requirement status	Description
clusterName	String	Y	- Cluster name Only lowercase alphanumeric characters, numbers, and non-consecutive hyphens (-) allowed First character must be a letter, but the last character may be a letter or a number
kafkaVersionCode	String	Y	- Cloud Data Streaming Service version to be used Can be obtained via getCDSSVersion action
kafkaManagerUserName	String	Y	- CMAK access ID Only lowercase alphanumeric characters, numbers, and non-consecutive hyphens (-) allowed First character must be a letter, but the last character may be a letter or a number
kafkaManagerUserPassword	String	Y	- CMAK access password Must be at least 8 characters and contain at least one of each: English uppercase letter, lowercase letter, special character, and number
softwareProductCode	String	Y	- OS type to be used Can be obtained via getOsProductList action
vpcNo	Integer	Y	- VPC number to be used Can be obtained via getVpcList action
managerNodeProductCode	String	Y	- HW specifications of the manager node Can be obtained via getNodeProductList action
managerNodeSubnetNo	Integer	Y	- Subnet number where the manager node is to be located Can be obtained via getSubnetList action
brokerNodeProductCode	String	Y	- HW specifications of the broker node Can be obtained via getNodeProductList action
brokerNodeSubnetNo	Integer	Y	- Subnet number where the broker node is to be located Can be obtained via getSubnetList action
brokerNodeCount	Integer	Y	- Number of broker nodes At least 3 units, up to 10 units allowed
brokerNodeStorageSize	Integer	Y	- Broker node storage capacity At least 100 GB, up to 2000 GB. Must be in units of 10 GB
configGroupNo	Integer	Y	- ConfigGroup number to be used Can be obtained via getKafkaVersionConfigGroupList action

Request examples

POST https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/createCDSSCluster
HOST: clouddatastreamingservice.apigw.ntruss.com
Content-Type: application/json
x-ncp-apigw-signature-v2: zq0FrtlU8JZJi9esTK31bCQUNG3H+jo4CMjMkJDoWSc=
x-ncp-apigw-timestamp: 1593848345548
x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw

{
  "clusterName": "test",
  "kafkaVersionCode": "2403005",
  "kafkaManagerUserName": "test",
  "kafkaManagerUserPassword": "qwe123!@#",
  "softwareProductCode": "SW.VCDSS.OS.LNX64.CNTOS.0708.B050",
  "vpcNo": 1236,
  "managerNodeProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
  "managerNodeSubnetNo": 1300,
  "brokerNodeProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
  "brokerNodeCount": 3,
  "brokerNodeSubnetNo": 1301,
  "brokerNodeStorageSize": 100,
  "configGroupNo": 127
}

curl -X POST "https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/createCDSSCluster" \
-H "accept: application/json" \
-H "Content-Type: application/json" \
-H "x-ncp-iam-access-key: 7fIvgFY428mtY6sY8maw" \
-H "x-ncp-apigw-timestamp: 1601971222179" \
-H "x-ncp-apigw-signature-v2: zrCelnR48AADdK/uh6Xe3yy468i8KpQoewYHUmeqYh4=" \
-d \
'{
   "clusterName": "test",
   "kafkaVersionCode": "2403005",
   "kafkaManagerUserName": "test",
   "kafkaManagerUserPassword": "qwe123!@#",
   "softwareProductCode": "SW.VCDSS.OS.LNX64.CNTOS.0708.B050",
   "vpcNo": 1236,
   "managerNodeProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
   "managerNodeSubnetNo": 1300,
   "brokerNodeProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
   "brokerNodeCount": 3,
   "brokerNodeSubnetNo": 1301,
   "brokerNodeStorageSize": 100,
   "configGroupNo": 127
 }'

Response examples

{
  "code": 0,
  "message": "SUCCESS",
  "result": true,
  "requestId": "1d70c609-2a04-4bf6-9987-6778f512f423"
}

Was this article helpful?

What's Next

Creating a Cloud Data Streaming Service Cluster (Return ID)

Table of contents

Description
Requests