MENU
      Search Engine Cluster 생성

        Search Engine Cluster 생성


        기사 요약

        VPC 환경에서 이용 가능합니다.

        Search Engine Cluster를 생성합니다.

        요청

        요청 URL

        POST https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/createSearchEngineCluster [KR]
        POST https://vpcsearchengine.apigw.ntruss.com/api/sgn-v2/cluster/createSearchEngineCluster [SGN]
        POST https://vpcsearchengine.apigw.ntruss.com/api/jpn-v2/cluster/createSearchEngineCluster [JPN]
        HTTP

        요청 헤더

        헤더명설명
        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- 클러스터 이름
        영문자(소문자), 숫자, 연속되지 않은 붙임표( - )로만 구성 가능
        첫 글자는 영문, 마지막 글자는 영문자 또는 숫자만 가능
        searchEngineVersionCodeStringY- 사용할 Search Engine 버전
        getSearchEngineVersionList 액션을 통해 획득 가능
        searchEngineDashboardPortStringY- Search Engine Dashboard(Kibana 또는 Opensearch Dashboard)의 http port
        9090, 9200, 9300port는 사용 불가능
        1025-65534 사이의 port만 사용 가능
        searchEngineUserNameStringY- Search Engine Dashboard 접속 ID
        영문자(소문자), 숫자, 연속되지 않은 붙임표( - )로만 구성 가능
        첫 글자는 영문, 마지막 글자는 영문자 또는 숫자만 가능
        searchEngineUserPasswordStringY- Search Engine 접속 Password
        8자 이상, 영어대소문자/특수문자/숫자 각각 1자 이상 포함 필수
        softwareProductCodeStringY- 사용할 할 OS 타입
        getOsProductList 액션을 통해 획득 가능
        vpcNoIntegerY- 사용할 VPC No
        getVpcList 액션을 통해 획득 가능
        isDualManagerBooleanY매니저 노드 이중화 여부
        managerNodeSubnetNoIntegerY- 매니저 노드가 위치할 Subnet No
        getSubnetList
        managerNodeProductCodeStringY- 매니저 노드의 HW 스펙
        getNodeProductList
        isMasterOnlyNodeActivatedBooleanY마스터 전용 노드 활성화 여부
        masterNodeSubnetNoIntegerN- 마스터 노드가 위치할 Subnet No
        getSubnetList
        masterNodeProductCodeStringN- 마스터 노드의 HW 스펙
        getNodeProductList
        masterNodeCountIntegerN- 마스터 노드의 개수
        3대 또는 5대
        dataNodeSubnetNoIntegerY- 데이터 노드가 위치할 Subnet No
        getSubnetList
        dataNodeProductCodeStringY- 데이터 노드의 HW 스펙
        getNodeProductList
        dataNodeCountIntegerY- 데이터 노드 개수
        최소 3대 이상, 최대 10대까지 생성 가능
        dataNodeStorageSizeIntegerY- 데이터 노드의 스토리지 용량
        최소 100GB, 최대 2000GB 까지 10GB단위 선택 가능
        loginKeyNameStringY- 매니저 노드 SSH 접속 시 사용할 인증키 이름
        getLoginKeyList

        요청 예시

        POST https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/createSearchEngineCluster
        HOST: vpcsearchengine.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": "testcluster",
          "searchEngineVersionCode": "133",
          "searchEngineDashboardPort" : "5601",
          "searchEngineUserName": "test,
          "searchEngineUserPassword": "qwe123!@#",
          "softwareProductCode": "SW.VELST.OS.LNX64.CNTOS.0703.B050",
          "vpcNo": 1236,
          "managerNodeProductCode": "SVR.VELST.STAND.C002.M004.NET.SSD.B050.G001",
          "managerNodeSubnetNo": 1300,
          "dataNodeProductCode": "SVR.VELST.STAND.C002.M004.NET.SSD.B050.G001",
          "dataNodeCount": 3,
          "dataNodeSubnetNo": 1301,
          "dataNodeStorageSize": 100,
          "loginKeyName": "testkey",
          "isDualManager": true,
          "isMasterOnlyNodeActivated" : false
        }
        HTTP
        curl -X POST "https://vpcsearchengine.apigw.ntruss.com/api/v2/cluster/createSearchEngineCluster" \
        -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": "testcluster",
          "searchEngineVersionCode": "133",
          "searchEngineDashboardPort" : "5601",
          "searchEngineUserName": "test,
          "searchEngineUserPassword": "qwe123!@#",
          "softwareProductCode": "SW.VELST.OS.LNX64.CNTOS.0703.B050",
          "vpcNo": 1236,
          "managerNodeProductCode": "SVR.VELST.STAND.C002.M004.NET.SSD.B050.G001",
          "managerNodeSubnetNo": 1300,
          "dataNodeProductCode": "SVR.VELST.STAND.C002.M004.NET.SSD.B050.G001",
          "dataNodeCount": 3,
          "dataNodeSubnetNo": 1301,
          "dataNodeStorageSize": 100,
          "loginKeyName": "testkey",
          "isDualManager": true,
          "isMasterOnlyNodeActivated" : false
        }'
        Bash

        응답 파라미터

        public class CreateClusterResponseVo {
                private Integer serviceGroupInstanceNo;
        }
        Java

        필드

        파라미터명타입설명
        serviceGroupInstanceNoInteger생성된 Cluster의 serviceGroupInstanceNo

        응답 예시

        {
            "code": 0,
            "message": "SUCCESS",
            "result": {
                "serviceGroupInstanceNo": 1484582
            },
            "requestId": "2ade3f23-4ef1-48da-9385-f6740a4ad078"
        }
        JSON

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

        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.