Cloud Data Streaming Service Cluster 생성 (Return ID)
- 인쇄
- PDF
Cloud Data Streaming Service Cluster 생성 (Return ID)
- 인쇄
- PDF
기사 요약
이 요약이 도움이 되었나요?
의견을 보내 주셔서 감사합니다.
VPC 환경에서 이용 가능합니다.
설명
Cloud Data Streaming Service Cluster를 생성 후 serviceGroupInstanceNo를 Return합니다.
요청
요청 URL
POST https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo [KR]
POST https://clouddatastreamingservice.apigw.ntruss.com/api/sgn-v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo [SGN]
POST https://clouddatastreamingservice.apigw.ntruss.com/api/jpn-v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo [JPN]
요청 헤더
| 헤더명 | 설명 |
|---|---|
| x-ncp-apigw-timestamp | - 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타냄 - API Gateway 서버와 시간 차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주 x-ncp-apigw-timestamp:{Timestamp} |
| x-ncp-iam-access-key | 네이버 클라우드 플랫폼 포털에서 발급받은 Access Key ID 값x-ncp-iam-access-key:{Account Access Key} |
| x-ncp-apigw-signature-v2 | Access Key ID 값과 Secret Key로 암호화한 서명x-ncp-apigw-signature-v2:{API Gateway Signature} |
| Content-Type | Request body content type을 application/json으로 지정Content-Type: application/json |
요청 파라미터
| 파라미터 | 타입 | 필수 여부 | 설명 |
|---|---|---|---|
| clusterName | String | Y | - 클러스터 이름 - 영문자(소문자), 숫자, 연속되지 않은 붙임표( - )로만 구성됨 - 첫 글자는 영문, 마지막 글자는 영문자 또는 숫자여야 함 |
| kafkaVersionCode | String | Y | - 사용할 Cloud Data Streaming Service 버전 - getCDSSVersion 액션을 통해 획득 가능 |
| kafkaManagerUserName | String | Y | - CMAK 접속 ID - 영문자(소문자), 숫자, 연속되지 않은 붙임표( - )로만 구성됨 첫 글자는 영문, 마지막 글자는 영문자 또는 숫자여야 함 |
| kafkaManagerUserPassword | String | Y | - CMAK 접속 Password - 8자 이상, 영어대소문자/특수문자/숫자 각각 1자 이상 포함되어야 함 |
| softwareProductCode | String | Y | - 사용할 할 OS 타입 - getOsProductList 액션을 통해 획득 가능 |
| vpcNo | Integer | Y | - 사용할 VPC No - getVpcList 액션을 통해 획득 가능 |
| managerNodeProductCode | String | Y | - 매니저 노드의 HW 스펙 - getNodeProductList 액션을 통해 획득 가능 |
| managerNodeSubnetNo | Integer | Y | - 매니저 노드가 위치할 Subnet No - getSubnetList 액션을 통해 획득 가능 |
| brokerNodeProductCode | String | Y | - 브로커 노드의 HW 스펙 - getNodeProductList 액션을 통해 획득 가능 |
| brokerNodeSubnetNo | Integer | Y | - 브로커 노드가 위치할 Subnet No - getSubnetList 액션을 통해 획득 가능 |
| brokerNodeCount | Integer | Y | - 브로커 노드의 개수 - 최소 3대 이상, 최대 10대까지 생성 가능 |
| brokerNodeStorageSize | Integer | Y | - 브로커 노드의 스토리지 용량 - 최소 100GB, 최대 2000GB 까지 10GB단위 선택 가능 |
| configGroupNo | Integer | Y | - 사용할 ConfigGroup No - getKafkaVersionConfigGroupList 액션을 통해 획득 가능 |
요청 예시
POST https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/createCDSSClusterReturnServiceGroupInstanceNo
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/createCDSSClusterReturnServiceGroupInstanceNo" \
-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
}'
응답 파라미터
public class CreateClusterResponseVo {
Integer serviceGroupInstanceNo;
}
필드
| 파라미터명 | 타입 | 설명 |
|---|---|---|
| serviceGroupInstanceNo | Integer | 생성된 클러스터의 고유 번호 |
응답 예시
{
"code": 0,
"message": "SUCCESS",
"result": {
"serviceGroupInstanceNo": 2435417
},
"requestId": "179bf48d-34e7-4a04-ba8c-1d51dee9abef"
}
이 문서가 도움이 되었습니까?