Available in VPC
Create a Cloud Data Streaming Service cluster. The cluster instance number is returned in the response.
Request
This section describes the request format. The method and URI are as follows:
Method | URI |
---|---|
POST | /api/v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo (Korea Region) |
POST | /api/sgn-v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo (Singapore Region) |
POST | /api/jpn-v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo (Japan Region) |
Request headers
For information about the headers common to all Cloud Data Streaming Service APIs, see Cloud Data Streaming Service request headers.
Request body
You can include the following data in the body of your request:
Field | Type | Required | Description |
---|---|---|---|
clusterName |
String | Required | Cluster name
|
kafkaVersionCode |
Integer | Required | Kafka version code
|
configGroupNo |
Integer | Required | Config group number
|
kafkaManagerUserName |
String | Required | CMAK access account ID
|
kafkaManagerUserPassword |
String | Required | CMAK access account password
|
softwareProductCode |
String | Required | Operating system type code |
vpcNo |
Integer | Required | VPC number
|
managerNodeSubnetNo |
Integer | Required | Manager node subnet number
|
managerNodeProductCode |
String | Required | Manager node server type code
|
brokerNodeSubnetNo |
Integer | Required | Broker node subnet number
|
brokerNodeCount |
Integer | Required | Number of broker nodes
|
brokerNodeProductCode |
String | Required | Broker node server type code
|
brokerNodeStorageSize |
Integer | Required | Broker node storage capacity (GB)
|
Request example
The request example is as follows:
curl --location --request POST 'https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo' \
--header 'x-ncp-apigw-timestamp: {Timestamp}' \
--header 'x-ncp-iam-access-key: {Access Key}' \
--header 'x-ncp-apigw-signature-v2: {API Gateway Signature}' \
--header 'Content-Type: application/json' \
--data '{
"clusterName": "cluster002",
"kafkaVersionCode": "3903006",
"configGroupNo": 3**,
"kafkaManagerUserName": "ncpadmin",
"kafkaManagerUserPassword": "**********",
"softwareProductCode": "SW.VCDSS.OS.LNX64.CNTOS.0708.B050",
"vpcNo": 4***,
"managerNodeSubnetNo": 30***,
"managerNodeProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
"brokerNodeSubnetNo": 33***,
"brokerNodeCount": 3,
"brokerNodeProductCode": "SVR.VCDSS.HICPU.C002.M004.NET.SSD.B050.G002",
"brokerNodeStorageSize": 100
}'
Response
This section describes the response format.
Response body
The response body includes the following data:
Field | Type | Required | Description |
---|---|---|---|
code |
Integer | - | Response code |
message |
String | - | Response message |
result |
Object | - | Response result |
result.serviceGroupInstanceNo |
Integer | - | Cluster instance number |
requestId |
String | - | ID for the request
|
Response status codes
For information about the HTTP status codes common to all Cloud Data Streaming Service APIs, see Cloud Data Streaming Service response status codes.
Response example
The response example is as follows:
{
"code": 0,
"message": "SUCCESS",
"result": {
"serviceGroupInstanceNo": 1009*****
},
"requestId": "b1c51f69-****-****-****-9371949cc985"
}