Cloud Data Streaming Service Cluster 생성 (Return ID)
    • PDF

    Cloud Data Streaming Service Cluster 생성 (Return ID)

    • PDF

    Article Summary

    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-v2Access Key ID 값과 Secret Key로 암호화한 서명
    x-ncp-apigw-signature-v2:{API Gateway Signature}
    Content-TypeRequest body content type을 application/json으로 지정
    Content-Type: application/json

    요청 파라미터

    파라미터타입필수 여부설명
    clusterNameStringY- 클러스터 이름
    - 영문자(소문자), 숫자, 연속되지 않은 붙임표( - )로만 구성됨
    - 첫 글자는 영문, 마지막 글자는 영문자 또는 숫자여야 함
    kafkaVersionCodeStringY- 사용할 Cloud Data Streaming Service 버전
    - getCDSSVersion 액션을 통해 획득 가능
    kafkaManagerUserNameStringY- CMAK 접속 ID
    - 영문자(소문자), 숫자, 연속되지 않은 붙임표( - )로만 구성됨
    첫 글자는 영문, 마지막 글자는 영문자 또는 숫자여야 함
    kafkaManagerUserPasswordStringY- CMAK 접속 Password
    - 8자 이상, 영어대소문자/특수문자/숫자 각각 1자 이상 포함되어야 함
    softwareProductCodeStringY- 사용할 할 OS 타입
    - getOsProductList 액션을 통해 획득 가능
    vpcNoIntegerY- 사용할 VPC No
    - getVpcList 액션을 통해 획득 가능
    managerNodeProductCodeStringY- 매니저 노드의 HW 스펙
    - getNodeProductList 액션을 통해 획득 가능
    managerNodeSubnetNoIntegerY- 매니저 노드가 위치할 Subnet No
    - getSubnetList 액션을 통해 획득 가능
    brokerNodeProductCodeStringY- 브로커 노드의 HW 스펙
    - getNodeProductList 액션을 통해 획득 가능
    brokerNodeSubnetNoIntegerY- 브로커 노드가 위치할 Subnet No
    - getSubnetList 액션을 통해 획득 가능
    brokerNodeCountIntegerY- 브로커 노드의 개수
    - 최소 3대 이상, 최대 10대까지 생성 가능
    brokerNodeStorageSizeIntegerY- 브로커 노드의 스토리지 용량
    - 최소 100GB, 최대 2000GB 까지 10GB단위 선택 가능
    configGroupNoIntegerY- 사용할 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;
    }
    

    필드

    파라미터명타입설명
    serviceGroupInstanceNoInteger생성된 클러스터의 고유 번호

    응답 예시

    {
      "code": 0,
      "message": "SUCCESS",
      "result": {
        "serviceGroupInstanceNo": 2435417
      },
      "requestId": "179bf48d-34e7-4a04-ba8c-1d51dee9abef"
    }
    

    이 문서가 도움이 되었습니까?

    Changing your password will log you out immediately. Use the new password to log back in.
    First name must have atleast 2 characters. Numbers and special characters are not allowed.
    Last name must have atleast 1 characters. Numbers and special characters are not allowed.
    Enter a valid email
    Enter a valid password
    Your profile has been successfully updated.