VPC 환경에서 이용 가능합니다.
Cloud DB for Cache는 Redis 캐시를 몇 가지 설정과 클릭만으로 간편하게 구축하고 네이버의 최적화 설정을 통해 안정적으로 운영하며, 장애 발생 시 자동 복구하는 완전 관리형 클라우드 캐시 서비스입니다. Cloud DB for Cache에서는 데이터베이스 관리 기능에 대한 API를 RESTful 형태로 제공합니다.
2025년 6월 19일부로 기존 'Cloud DB for Redis' 서비스명을 'Cloud DB for Cache'로 변경했습니다. 기존 데이터 및 이용 이력 등은 변경 없이 유지되며 서비스 이용에 영향은 없습니다. 자세한 내용은 Cloud DB for Cache 상품명 및 URL 변경 안내 (6/19)를 참조해 주십시오.
Cloud DB for Cache API는 지원하는 DBMS 범위에 따라 두 가지 버전을 제공합니다.
| API v1 | API v2 | |
|---|---|---|
| Base URL | https://ncloud.apigw.gov-ntruss.com/vredis/v2 | https://ncloud.apigw.gov-ntruss.com/vcache/v2 |
| 지원 DBMS | Redis | Redis, Valkey |
Cloud DB for Cache 공통 설정
Cloud DB for Cache API에서 공통으로 사용하는 요청 형식과 응답 형식을 설명합니다.
요청
공통 요청 형식을 설명합니다.
API URL
요청 API URL은 다음과 같습니다.
https://ncloud.apigw.gov-ntruss.com/vcache/v2
https://ncloud.apigw.gov-ntruss.com/vredis/v2
요청 헤더
요청 헤더에 대한 설명은 다음과 같습니다.
| 필드 | 필수 여부 | 설명 |
|---|---|---|
x-ncp-apigw-timestamp |
Required | 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간(밀리초)
|
x-ncp-iam-access-key |
Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key |
x-ncp-apigw-signature-v2 |
Required | 네이버 클라우드 플랫폼에서 발급받은 Access Key에 맵핑되는 Secret Key 및 HMAC 암호화 알고리즘(HmacSHA256)으로 요청 정보를 암호화한 후 Base64로 인코딩한 서명 |
응답
공통 응답 형식을 설명합니다.
응답 상태 코드
Cloud DB for Cache API는 네이버 클라우드 플랫폼의 공통 응답 상태 코드를 사용합니다. 네이버 클라우드 플랫폼에서 공통으로 사용하는 응답 상태 코드에 대한 정보는 Ncloud API 응답 상태 코드를 참조해 주십시오.
Cloud DB for Cache API
Cloud DB for Cache API 서비스에서 제공하는 API에 대한 설명은 다음과 같습니다.
| API | 설명 |
|---|---|
| addCloudCacheUserList | Cloud DB for Cache User를 추가 |
| changeCloudCacheUserList | Cloud DB for Cache User를 수정 |
| createCloudCacheConfigGroup | Cloud DB for Cache Config Group을 생성 |
| createCloudCacheInstance | Cloud DB for Cache 인스턴스를 생성 |
| createCloudCacheManualBackup | Cloud DB for Cache Manual 백업을 생성 |
| deleteCloudCacheConfigGroup | Cloud DB for Cache Config group을 삭제 |
| deleteCloudCacheInstance | Cloud DB for Cache 인스턴스를 삭제 |
| deleteCloudCacheManualBackup | Cloud DB for Cache Manual 백업을 삭제 |
| deleteCloudCacheUserList | Cloud DB for Cache User를 삭제 |
| exportBackupToObjectStorage | Cloud DB for Cache 백업 파일을 Object Storage로 전송 |
| flushAllCloudCacheServerInstance | Cloud DB for Cache FlushAll 명령어를 이용해서 선택한 DB Server의 모든 Data를 삭제 |
| getCloudCacheBackupDetailList | Cloud DB for Cache 백업 상세 정보를 조회 |
| getCloudCacheBackupList | Cloud DB for Cache 백업 리스트를 조회 |
| getCloudCacheBucketList | Cloud DB for Cache에서 사용할 수 있는 Object Storage 버킷 리스트를 조회 |
| getCloudCacheConfigGroupList | Cloud DB for Cache Config group 리스트를 조회 |
| getCloudCacheConfigGroupVersionList | Cloud DB for Cache Config group 버전 리스트를 조회 |
| getCloudCacheImageProductList | Cloud DB for Cache 상품 코드 리스트를 조회 |
| getCloudCacheInstanceDetail | Cloud DB for Cache 인스턴스 상세 정보를 조회 |
| getCloudCacheInstanceList | Cloud DB for Cache 인스턴스 리스트를 조회 |
| getCloudCacheManualBackupDetailList | 사용 가능한 Cloud DB for Cache Manual 백업 상세 정보 목록을 조회 |
| getCloudCacheManualBackupList | Cloud DB for Cache Manual 백업 리스트를 조회 |
| getCloudCacheProductList | 사용 가능한 Cloud DB for Cache 서버 스펙 코드 리스트를 조회 |
| getCloudCacheTargetSubnetList | 사용할 수 있는 Subnet 리스트x를 조회 |
| getCloudCacheTargetVpcList | 사용할 수 있는 VPC 리스트를 조회 |
| getCloudCacheUserList | Cloud DB for Cache User를 조회 |
| rebootCloudCacheServerInstance | Cloud DB for Cache 서버 인스턴스를 재시작 |
Cloud DB for Cache 연관 리소스
Cloud DB for Cache API에 대한 사용자의 이해를 돕기 위해 다양한 연관 리소스를 제공하고 있습니다.
- Cloud DB for Cache API 사용 방법
- 서명(시그니처) 생성: 요청 헤더에 추가할 서명 생성 방법
- API Gateway 사용 가이드: 요청 헤더에 추가할 API Key 발급
- Sub Account 사용 가이드: 요청 헤더에 추가할 Access Key 발급 방법
- Ncloud 공통 응답 상태 코드: Cloud DB for Cache 에서 사용하는 네이버 클라우드 플랫폼의 공통 응답 상태 코드 정보
- Cloud DB for Cache 서비스 사용 방법
- Cloud DB for Cache 사용 가이드: 네이버 클라우드 플랫폼 콘솔에서 Cloud DB for Cache 사용하는 방법
- Ncloud 사용 환경 가이드: VPC, Classic 환경 및 지원 여부에 대한 가이드
- 요금 소개, 특징, 상세 기능: Cloud DB for Cache 의 요금 체계, 특징, 상세 기능 요약
- 서비스 최신 소식: Cloud DB for Cache 관련 최신 소식
- 자주 하는 질문: Cloud DB for Cache 사용자들이 자주 하는 질문
- 문의하기: API 가이드를 통해서도 궁금증이 해결되지 않는 경우 직접 문의