MENU
      클러스터 상태 확인

        클러스터 상태 확인


        기사 요약

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

        설명

        Cloud Data Streaming Service Cluster의 상태를 확인합니다.

        요청

        요청 URL

        GET https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/getClusterStatus/{service-group-instance-no} [KR]
        GET https://clouddatastreamingservice.apigw.ntruss.com/api/sgn-v1/cluster/getClusterStatus/{service-group-instance-no} [SGN]
        GET https://clouddatastreamingservice.apigw.ntruss.com/api/jpn-v1/cluster/getClusterStatus/{service-group-instance-no} [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

        요청 파라미터

        파라미터타입필수 여부설명
        serviceGroupInstanceNoStringY상태를 확인할 Cluster 번호

        요청 예시

        GET https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/getClusterStatus/1484848
        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
        HTTP
        curl -X GET "https://clouddatastreamingservice.apigw.ntruss.com/api/v1/cluster/getClusterStatus/1484848" \
        -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="
        Bash

        응답 파라미터

        public class GetBrokerNodeListsResponseVo {
            String clusterName;
            Integer brokerNodeTotalNumber;
            Integer brokerNumber;
            String brokerStatus;
            List<ProcessStatusVo> brokerStatusPerNode;
            Integer zookeeperTotalNumber;
            Integer zookeeperNumber;
            String zookeeperStatus;
            List<ProcessStatusVo> zookeeperStatusPerNode;
            String cmakStatus;
        }
        
        public class ProcessStatusVo {
            String hostname;
            String status;
        }
        Java

        필드

        파라미터명타입설명
        clusterNameStringCluster 이름
        brokerNodeTotalNumberInteger브로커 노드 총 개수
        brokerNumberInteger현재 작동하고 있는 브로커 노드 개수
        brokerStatusString브로커 상태(green 정상 작동, red 비정상 작동, gray 알 수 없음)
        brokerStatusPerNodeList노드별 브로커 상태
        zookeeperTotalNumberInteger주키퍼 노드 총 개수
        zookeeperNumberInteger현재 작동하고 있는 주키퍼 노드 개수
        zookeeperStatusString주키퍼 상태(green 정상 작동, red 비정상 작동)
        zookeeperStatusPerNodeList노드별 주키퍼 상태
        cmakStatusStringCMAK 상태(green 정상 작동, red 비정상 작동, gray 알 수 없음)
        hostnameString서버 인스턴스 이름
        statusString프로세스 상태(green 정상 작동, red 비정상 작동, gray 알 수 없음)

        응답 예시

        {
          "code": 0,
          "message": "SUCCESS",
          "result": {
            "clusterName": "test",
            "brokerNodeTotalNumber": 3,
            "brokerNumber": 3,
            "brokerStatus": "green",
            "brokerStatusPerNode": [
              {
                "hostname": "test-b-95q",
                "status": "green"
              },
              {
                "hostname": "test-b-95r",
                "status": "green"
              },
              {
                "hostname": "test-b-95s",
                "status": "green"
              }
            ],
            "zookeeperTotalNumber": 3,
            "zookeeperNumber": 3,
            "zookeeperStatus": "green",
            "zookeeperStatusPerNode": [
              {
                "hostname": "test-b-95q",
                "status": "green"
              },
              {
                "hostname": "test-b-95r",
                "status": "green"
              },
              {
                "hostname": "test-b-95s",
                "status": "green"
              }
            ],
            "cmakStatus": "green"
          },
          "requestId": "c2ce20ec-d296-43dd-872b-3a1d5e860a8b"
        }
        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.