Cloud Data Streaming Service 개요

Prev Next

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

Cloud Data Streaming Service는 실시간 스트리밍 데이터 파이프라인 및 애플리케이션 빌드를 위한 오픈 소스 플랫폼인 Apache Kafka 클러스터를 손쉽게 배포, 보호, 운영 및 확장할 수 있는 네이버 클라우드 플랫폼의 서비스입니다. Cloud Data Streaming Service 서비스에서는 Cluster, Monitoring, Config Group 기능에 대한 API를 RESTful 형태로 제공합니다.

Cloud Data Streaming Service 공통 설정

Cloud Data Streaming Service API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.

요청

공통 요청 형식을 설명합니다.

API URL

요청 API URL은 다음과 같습니다.

https://clouddatastreamingservice.apigw.gov-ntruss.com

요청 헤더

요청 헤더에 대한 설명은 다음과 같습니다.

필드 필수 여부 설명
x-ncp-apigw-timestamp Required 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
  • API Gateway 서버와 5분 이상 시간차 발생 시 유효하지 않은 요청으로 간주
x-ncp-iam-access-key Required 네이버 클라우드 플랫폼에서 발급받은 Access Key
x-ncp-apigw-signature-v2 Required 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명
Content-type Optional 요청 데이터의 형식
  • application/json

응답

공통 응답 형식을 설명합니다.

응답 상태 코드

Cloud Data Streaming Service API는 네이버 클라우드 플랫폼의 공통 응답 상태 코드를 사용합니다. 네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.

Cloud Data Streaming Service API

Cloud Data Streaming Service에서 제공하는 API에 대한 설명은 다음과 같습니다.

Cluster

Cluster 관련 API에 대한 설명은 다음과 같습니다.

API 설명
계정 비밀번호 초기화 Cloud Data Streaming Service 클러스터의 CMAK 접속 계정 비밀번호 초기화
버전 조회 사용 가능한 Cloud Data Streaming Service 버전 조회
버전 업그레이드 Cloud Data Streaming Service 버전 업그레이드
버전 업그레이드 사전 체크 Cloud Data Streaming Service 버전 업그레이드 사전 체크
버전 업그레이드 상태 조회 Cloud Data Streaming Service 버전 업그레이드의 진행 상태 조회
서버 타입 조회 사용 가능한 노드 서버 타입 조회
운영 체제 타입 조회 사용 가능한 운영 체제 타입 조회
Subnet 목록 조회 사용 가능한 Subnet 목록 조회
VPC 목록 조회 사용 가능한 VPC 목록 조회
클러스터 생성 Cloud Data Streaming Service 클러스터 생성
클러스터 생성(ID 반환) Cloud Data Streaming Service 클러스터 생성(ID 반환)
클러스터 목록 조회 Cloud Data Streaming Service 클러스터 목록 조회
클러스터 상태 조회 Cloud Data Streaming Service 클러스터 상태 조회
클러스터 인증서 조회 Cloud Data Streaming Service 클러스터 통신 구간 암호화에 사용되는 인증서 조회
클러스터 조회 Cloud Data Streaming Service 클러스터 상세 정보 조회
클러스터 ACG 목록 조회 Cloud Data Streaming Service 클러스터 ACG 규칙 목록 조회
클러스터 전체 서비스 재시작 Cloud Data Streaming Service 클러스터의 전체 서비스 재시작
클러스터 CMAK 재시작 Cloud Data Streaming Servic 클러스터의 CMAK 재시작
클러스터 Kafka 재시작 Cloud Data Streaming Service 클러스터의 Kafka 및 Zookeeper 재시작
클러스터 Public 도메인 비활성화 Cloud Data Streaming Service 클러스터의 관리 도구 접속용 Public 도메인 비활성화
클러스터 Public 도메인 활성화 Cloud Data Streaming Service 클러스터의 관리 도구 접속용 Public 도메인 활성화
클러스터 삭제 Cloud Data Streaming Service 클러스터 삭제
노드 추가 Cloud Data Streaming Service 클러스터 브로커 노드 추가
노드 목록 조회 Cloud Data Streaming Service 클러스터 전체 노드 목록 조회
노드 변경 가능 스펙 조회 Cloud Data Streaming Service 클러스터 노드별 변경 가능 서버 스펙 조회
노드 스펙 조회 Cloud Data Streaming Service 클러스터 노드별 서버 스펙 조회
노드 통신 정보 조회 Cloud Data Streaming Service 클러스터 브로커 노드 통신 정보 조회
노드 스펙 변경 Cloud Data Streaming Service 클러스터 노드별 서버 스펙 변경
노드 롤링 재시작 Cloud Data Streaming Service 클러스터 전체 노드 롤링 재시작
노드 롤링 재시작 사전 체크 Cloud Data Streaming Service 클러스터 전체 노드 롤링 재시작 사전 체크
노드 롤링 재시작 상태 조회 Cloud Data Streaming Service 클러스터 전체 노드 롤링 재시작의 진행 상태 조회
노드 Kafka 재시작 Cloud Data Streaming Service 클러스터 내 지정된 노드의 Kafka 재시작
노드 Public Endpoint 비활성화 Cloud Data Streaming Service 클러스터 브로커 노드의 Public Endpoint 비활성화
노드 Public Endpoint 활성화 Cloud Data Streaming Service 클러스터 브로커 노드의 Public Endpoint 활성화
로드밸런서 목록 조회 Cloud Data Streaming Service 클러스터 브로커 노드의 Public Endpoint로 사용 가능한 로드밸런서 목록 조회

Monitoring

Monitoring 관련 API에 대한 설명은 다음과 같습니다.

API 설명
모니터링 결과 조회 Cloud Data Streaming Service 클러스터 및 노드 서버의 모니터링 데이터 조회
운영 체제 모니터링 결과 조회 Cloud Data Streaming Service 노드 서버의 운영 체제 모니터링 데이터 조회

Config Group

Config Group 관련 API에 대한 설명은 다음과 같습니다.

API 설명
Config Group 생성 클러스터 생성 시 필요한 Config Group 생성
Config Group 목록 조회 Kafka 버전별로 생성한 Config Group 목록 조회
Config Group 적용 클러스터 조회 Config Group이 적용된 클러스터 조회
Config Group 조회 Config Group 상세 정보 조회
Config Group Kafka 설정 조회 Config Group의 Kafka 상세 설정 조회
Config Group 설명 변경 Config Group 설명 변경
Config Group 클러스터 적용 Config Group을 클러스터에 적용
Config Group Kafka 설정 변경 Config Group의 Kafka 상세 설정 변경
Config Group 삭제 Config Group 삭제

Cloud Data Streaming Service 연관 리소스

Cloud Data Streaming Service API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.