Qdrant Cloud API
Qdrant Cloud API (cloud-api)
Qdrant Cloud API는 Qdrant Cloud 플랫폼 자체를 자동화할 수 있게 해 주는 API예요. 계정, 클러스터, 백업 일정, 인증 방식, 하이브리드 클라우드 환경까지 이 API 하나로 관리할 수 있어요.
잠깐, 헷갈리지 마세요. 이건 데이터베이스 자체의 Qdrant REST나 gRPC API가 아니에요. 데이터베이스에 직접 접근하는 API와 SDK가 궁금하다면 '인터페이스' 페이지를 살펴보세요.
소개
다양한 통합 요구를 맞추기 위해 Qdrant Cloud API는 두 가지 상호 작용 모델을 제공해요.
- gRPC API: 고성능, 저지연, 타입 안전(type-safe) 통신을 위한 방식이에요. 최대 효율이 필요한 백엔드 서비스나 애플리케이션에 추천돼요. 이 API는 Protocol Buffers로 정의돼요.
- REST/JSON API: JSON 페이로드를 사용하는 전통적인 HTTP/1.1(및 HTTP/2) 인터페이스예요. 이 API는 gRPC Gateway를 통해 제공돼요. RESTful 호출을 gRPC 메시지로 변환해서, 웹 클라이언트나 스크립트, 그리고 더 넓은 도구 호환성을 쉽게 확보할 수 있게 해 줘요.
API 정의와 생성된 클라이언트 라이브러리는 Qdrant Cloud Public API GitHub 저장소에서 찾을 수 있어요. 참고로 이 API는 사용하기 쉽도록 여러 개의 서비스로 나뉘어 있어요.
Qdrant Cloud API 엔드포인트
- gRPC 엔드포인트:
grpc.cloud.qdrant.io:443 - REST/JSON 엔드포인트:
https://api.cloud.qdrant.io
인증
대부분의 Qdrant Cloud API 요청은 인증이 필요해요. 인증은 관리 키(management key) 라고 부르는 API 키로 처리하며, Authorization 헤더에 넣어 보내야 해요.
Authorization: apikey <API키>
<API키> 자리에는 Qdrant Cloud 대시보드에서 얻거나 프로그램 방식으로 생성한 실제 API 키를 넣어요. 관리 키는 Cloud Console UI에서 만들 수 있어요. Access Management > Cloud Management Keys로 이동하면 돼요.
API 키는 공개 저장소나 로그에 노출되지 않도록 안전하게 보관해야 해요. 인증이 끝나면 이 API로 클러스터와 백업 일정을 관리하고, 계정에서 사용할 수 있는 다른 작업도 수행할 수 있어요.
샘플
grpcurl, curl 같은 도구나 제공되는 SDK로 API를 사용하는 방법에 대한 샘플은 Qdrant Cloud Public API 저장소에서 확인할 수 있어요.
Terraform Provider
Qdrant Cloud는 Qdrant Cloud 리소스를 관리하기 위한 Terraform Provider도 제공해요. 자세한 내용은 관련 문서를 참고하면 돼요.
출처: Qdrant 공식문서