Couchbase Cloud 버전 1.6의 출시를 발표하게 되어 기쁘게 생각합니다.를 통해 계정 관리를 간소화하고, 데이터 마이그레이션을 개선하며, Couchbase Cloud로 작업하는 방식을 간소화하는 기능을 소개합니다.
이 글에서는 공개 API, 개선된 데이터 가져오기 기능, 더 쉬워진 가입/등록 환경, 확장된 AWS 지역 범위 등 새로운 기능에 대한 일반적인 개요를 알려드리겠습니다. 새로운 기능 목록의 중요성 때문에 이 글의 대부분을 멋진 새 API에 할애하겠습니다.
카우치베이스 클라우드 API
그리고 카우치베이스 클라우드 API 는 중요하고 강력한 기능으로 Couchbase Cloud 계정에서 운영을 자동화할 수 있는 새로운 문을 열어줍니다. 이 기능을 사용하면 안전한 RESTful API를 사용하여 다양한 관리 기능을 수행하기 위해 Couchbase Cloud 컨트롤 플레인과 프로그래밍 방식으로 상호 작용할 수 있습니다.
API를 사용하면 클러스터, 버킷, 데이터베이스 사용자를 생성 및 삭제하고, 클라우드를 나열하고, 프로젝트를 관리하는 등의 작업을 할 수 있습니다. API를 사용하여 새 애플리케이션을 위한 새 클러스터 및 사용자 스핀업과 같은 반복적인 수동 작업을 자동화하는 애플리케이션을 만들 수 있으며, 이를 사용하여 컨트롤 플레인 기능을 다른 애플리케이션에 통합하거나 Couchbase Cloud 데이터베이스 에코시스템에 대한 실시간 인사이트를 제공하는 애플리케이션을 구축할 수 있습니다.
Couchbase Cloud API를 통해 고객은 다음과 같은 계정 작업을 수행하기 위해 Couchbase Cloud와 통합할 수 있습니다:
-
- 사용자 온보딩/오프보딩
- 클러스터의 수명 주기 관리하기
- 클러스터에 대한 모니터링 정보 얻기
퍼블릭 API의 첫 번째 반복은 클러스터의 수명 주기 및 관련 기능에 중점을 둡니다. 높은 수준에서 API는 다음과 같은 기능을 수행할 수 있습니다:
클러스터의 경우
-
- 클러스터, 버킷, 사용자 목록, 생성 및 삭제
- 허용 목록으로 액세스 관리
프로젝트의 경우
-
- 프로젝트 목록, 생성 및 삭제
클라우드의 경우
-
- 클라우드 목록 및 클라우드에 대한 자세한 정보 얻기
API 엔드포인트
다음 표에는 애플리케이션에서 사용할 수 있는 공개 API 엔드포인트와 메서드가 나열되어 있습니다:
baseURL = "https://cloudapi.cloud.couchbase.com"
API | 방법 | 설명 |
{baseURL}/v2/status | GET | 공개 API의 상태를 반환합니다. |
{baseURL}/v2/clouds | GET | 각 클라우드에 대한 요약 정보의 페이지가 지정된 목록을 반환합니다. |
{baseURL}/v2/clouds/{id} | GET | 클라우드에 대한 자세한 정보를 반환합니다. |
{baseURL}/v2/projects | GET, POST | 각 프로젝트에 대한 요약 정보의 페이지가 지정된 목록을 반환하거나(GET) 프로젝트를 생성합니다(POST). |
{baseURL}/v2/projects/{id} | 가져오기, 삭제 | 프로젝트에 대한 자세한 정보를 반환하거나( GET ), 삭제합니다( DELETE ). |
{baseURL}/v2/clusters | GET, POST | 각 클러스터에 대한 요약 정보의 페이지가 지정된 목록을 반환하거나(GET), 클러스터를 생성합니다(POST). |
{baseURL}/v2/clusters/{id} | 가져오기, 삭제 | 프로젝트에 대한 자세한 정보를 반환하거나( GET ), 삭제합니다( DELETE ). |
{baseURL}/v2/clusters/{id}/버킷 | 가져오기, 게시, 삭제 | 버킷에 대한 상세 정보를 반환하거나(GET), 버킷을 생성하거나(POST), 삭제합니다(DELETE). |
{baseURL}/v2/clusters/{id}/allowlist | 가져오기, 게시, 삭제 | 허용 목록에 대한 상세 정보를 반환하거나( GET), 허용 목록을 생성하거나( POST), 삭제합니다( DELETE). |
API 정보 흐름
카우치베이스 클라우드 API는 통신에 TLS 암호화를 사용하여 안전합니다. 또한 인증 및 권한 부여를 위해 액세스 키와 비밀 키가 필요합니다.
다음 다이어그램은 API를 사용할 때의 기본 정보 흐름을 보여줍니다:

카우치베이스 클라우드 API 정보 흐름
- 고객 운영 애플리케이션에서 카우치베이스 클라우드 퍼블릭 API 서비스 엔드포인트에 대한 보안 REST 호출이 이루어집니다.
- API 서비스는 각 호출을 카우치베이스 클라우드 컨트롤 플레인으로 전달한 다음, 고객 계정의 데이터 플레인으로 호출을 전달합니다.
- 작업은 데이터 플레인에서 수행되고 응답은 제어 플레인을 통해 API 서비스로 전송된 다음 고객 운영 애플리케이션으로 다시 전송됩니다.
기본 사용법 및 엔드포인트 호출
API 사용 방법은 간단하며 3단계로 구성되어 있습니다:
- API 키 생성
- 카우치베이스 클라우드 컨트롤 플레인을 사용하여 액세스 키 및 비밀 키 만들기
- 인증
- 권한 부여 및 카우치베이스-타임스탬프를 사용하여 헤더 생성하기
- API 호출
- 인증 헤더를 포함하고 REST 호출을 실행합니다.
그리고 공개 API 참조 에서는 매개변수와 응답을 포함하여 사용 가능한 모든 엔드포인트에 대한 자세한 내용을 제공합니다. 이 참조 가이드는 API에 대해 자세히 알아보는 데 필수적인 리소스입니다.
API 키와 헤더를 생성하는 방법에 대한 문서는 여기에서 확인할 수 있습니다.를 통해 API 엔드포인트를 호출하는 방법을 간단히 살펴보겠습니다.
여러 클라우드와 클라우드 제공업체(예: AWS 및 Azure)에서 다양한 애플리케이션을 구동하기 위해 Couchbase Cloud를 사용한다고 가정해 보겠습니다. 효율적인 운영을 유지하려면 클라우드 에코시스템의 현재 상태, 즉 각 클라우드의 특정 시점의 상태를 이해하는 것이 중요합니다. 운영 애플리케이션의 일부로 이 정보를 포함하기 위해 클라우드
엔드포인트.
전화로 클라우드 엔드포인트는 이름, 상태, 클라우드 공급자 및 지역 등의 정보를 포함하여 계정에 있는 모든 클라우드의 페이지가 매겨진 목록을 반환합니다. 엔드포인트를 다음과 같이 호출합니다: GET /v2/clouds
클라우드 엔드포인트는 클라우드 요약 데이터 필드와 함께 ListCloudsResponse를 반환합니다:

카우치베이스 클라우드 API CloudSummary
다음은 간단한 호출 예시입니다. 클라우드 엔드포인트에서 파이썬을 사용하여 GET_CLOUDS_From_API 함수는 엔드포인트를 호출한 다음 ListCloudsResponse 데이터에서 반환된 각 클라우드 이름, 공급자, 지역 및 ID 필드를 가져와 테이블에 표시할 행으로 작성합니다:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 |
def GET_CLOUDS_From_API(): clouds_api_response = cbc_api_get('/v2/clouds') cloud_list = [] 만약 clouds_api_response['응답 상태'] 는 not 없음: 목록_오브_클라우드 = clouds_api_response['responseContent'] # 목록이 나왔나요? 만약 목록_오브_클라우드 는 not 없음: 에 대한 클라우드 in 목록_오브_클라우드['데이터']: # 테이블에 표시할 행을 작성합니다. cloud_list.추가([클라우드['name'],클라우드['공급자'] , 클라우드['region'], 클라우드['id']]) 반환(cloud_list) |
이 코드가 실제로 작동하는지 확인하고 클러스터 생성 및 삭제, 사용자 나열, 프로젝트 생성 등의 작업을 수행하는 다양한 사전 빌드된 샘플 앱을 사용해 보려면 다음을 활용하세요. 카우치베이스 클라우드 API 예제API를 학습하고 직접 애플리케이션 개발을 시작하는 데 사용할 수 있는 작동 중인 애플리케이션의 완전한 보완 자료입니다. API 샘플을 시작하기 위한 지침은 여기에서 확인할 수 있습니다..
API 사용은 간단하면서도 강력하기 때문에 프로그래밍 방식으로 Couchbase Cloud 컨트롤 플레인을 호출하여 반복적인 수동 작업을 자동화할 수 있습니다. 예를 들어, 새 클러스터를 생성하고 기존 클러스터를 자주 폐기하는 개발 샌드박스와 같이 수명 주기가 짧은 여러 애플리케이션을 구동하기 위해 Couchbase Cloud를 활용하는 고객은 API를 사용하여 클러스터를 프로비저닝하고 관리한 다음 더 이상 필요하지 않을 때 클러스터를 폐기하는 유틸리티를 생성함으로써 프로세스를 간소화할 수 있습니다.
이 유틸리티는 클라우드, 프로젝트, 클러스터에 대한 요약을 나열하고 각각의 세부 데이터를 실시간으로 얻을 수 있어 조직이 Couchbase Cloud 에코시스템을 보다 효율적이고 효과적으로 관리할 수 있도록 도와줍니다. 이는 API를 사용할 수 있는 다양한 방법 중 한 가지 예일 뿐이며, 저희는 새로운 기능에 대해 매우 기쁘게 생각하며 고객들이 이 기능을 유용하게 사용할 것으로 기대합니다!
향상된 데이터 가져오기
또한 Couchbase Cloud 1.6에는 향상된 가져오기 기능을 도입하여 다음을 수행할 수 있습니다. 데이터 마이그레이션 를 더 쉽고 새로운 방식으로 Couchbase Cloud로 가져올 수 있습니다. 이제 새로운 가져오기 도구 인터페이스를 사용하여 로컬 컴퓨터에서 브라우저를 사용하거나 API에서 제공하는 cURL 명령을 사용하여 수동으로 JSON(줄, 목록, 아카이브) 및 CSV 파일을 Couchbase Cloud로 가져올 수 있습니다.

카우치베이스 클라우드 가져오기
새로운 기능의 중요한 측면은 CSV 행 또는 JSON 목록 플랫 파일에서 추출된 각 문서의 키를 자동 생성(UUID)하거나, 생성된 키 이름 표현식을 사용하여 지정할 수 있다는 것입니다. cbimport 유틸리티(새 기능의 기반이 되는)를 사용하세요.

가져오기 시 사용자 지정 키
사용자 지정 키 생성 기능은 Couchbase Cloud 고객의 데이터 마이그레이션 작업을 간소화하고 효율화할 수 있는 환영할 만한 개선 사항입니다.
가져오기를 만들 때 문서 건너뛰기, 문서 제한, 필드 무시, 필드 유형 유추(CSV만 해당), 빈 필드 생략(CSV만 해당) 등 다양한 구성 옵션 중에서 선택할 수 있습니다. 비동기 또는 동시 작업, 활동 추적, 장기 가져오기에 대한 이메일 알림, 다시 가져오기 등 다른 향상된 기능도 있습니다.
새로운 가져오기 기능은 고객이 백업/복원 및 XDCR과 함께 데이터를 Couchbase Cloud로 마이그레이션할 수 있는 또 다른 방법이 됩니다.
기타 새로운 기능
간소화된 가입 환경
신규 고객에게 프로세스를 더 잘 안내하고 가능한 한 빠르고 쉽게 가입할 수 있도록 Couchbase Cloud의 가입 절차가 개선되었습니다. Couchbase Cloud에 가입하려면 다음을 방문하세요. 카우치베이스 클라우드에 가입하기.
확장된 AWS 지역 범위
Couchbase Cloud는 전 세계적으로 지원 지역을 계속 늘려가고 있으며, 이제 AWS 중동(바레인) 지역에서도 사용할 수 있습니다. 지원되는 AWS 리전의 전체 목록은 다음을 참조하세요. AWS에 대한 클라우드 제공업체 요구 사항.
제 동료인 Prasad Doddi가 심층적으로 작성한 블로그 에서 새로운 가져오기 도구 인터페이스에 대한 훌륭한 튜토리얼이 포함된 새로운 Couchbase 클라우드 가져오기 기능을 다루고 있습니다. 꼭 읽어보시길 적극 추천합니다!
카우치베이스 클라우드의 최신 기능은 고객이 최대한 강력하고 쉽게 사용할 수 있는 서비스를 만들기 위한 당사의 노력을 확인시켜 줍니다.
아직 카우치베이스 클라우드 무료 체험판 하지만 지금이 바로 시작하는 것이 얼마나 쉬운지 직접 확인할 때입니다!