Cloud DB

참고

네이버 클라우드 플랫폼의 상품 사용 방법을 보다 상세하게 제공하고, 다양한 API의 활용을 돕기 위해 [설명서][API 참조서]를 구분하여 제공하고 있습니다.

Cloud DB API 참조서 바로가기 >>
Cloud DB for MySQL 설명서 바로가기 >>
Cloud DB for MSSQL 설명서 바로가기 >>
Cloud DB for Redis 설명서 바로가기 >>

개요

CloudDB API는 CloudDB for MSSQL , CloudDB for MySQL , CloudDB for Redis 에서 공통으로 사용할 수 있습니다.

공통설정

API URL

https://ncloud.apigw.ntruss.com/clouddb/v2

요청 헤더

헤더 명 설명
x-ncp-apigw-timestamp 1970년 1월 1일 00:00:00 협정 세계시(UTC)부터의 경과 시간을 밀리초(Millisecond)로 나타낸 것이다.
API Gateway 서버와 시간차가 5분 이상 나는 경우 유효하지 않은 요청으로 간주
x-ncp-apigw-api-key API Gateway에서 발급받은 키 값, v2를 사용할 경우 api-key는 사용하지 않습니다.
x-ncp-iam-access-key 네이버 클라우드 플랫폼에서 발급받은 API Key 또는 IAM에서 발급받은 AccessKey
x-ncp-apigw-signature-v2 위 예제의 Body를 AccessKey와 맵핑되는 SecretKey로 암호화한 서명
HMAC 암호화 알고리즘은 HmacSHA256 사용

API KEY 확인하기

  • 마이페이지 > 계정관리 > 인증키 관리 화면에서 access key와 secret key를 확인할 수 있습니다.

오퍼레이션

Cloud DB

API 명 Available DB
createCloudDBInstance MSSQL , MySQL , Redis
deleteCloudDBServerInstance MSSQL , MySQL , Redis
getCloudDBInstanceList MSSQL , MySQL , Redis
getCloudDBConfigGroupList MSSQL only
getCloudDBImageProductList MSSQL , MySQL , Redis
getCloudDBProductList MSSQL , MySQL , Redis
rebootCloudDBServerInstance MSSQL , MySQL
flushCloudDBInstance Redis only

DMS

DMS는 Data Migration Service의 약자로 온프레미스에서 운영하던 데이터 베이스를 CloudDB로 복구하거나 CloudDB에서 자동 백업된 백업 파일을 오브젝트 스토리지로 옮길 수 있는 서비스입니다.
해당 서비스는 API Gateway를 이용한 API이며 오브젝트 스토리지에 버킷을 생성한 후 사용할 수 있습니다. 대용량 데이터 베이스도 단 몇 분의 서비스 중지 시간만으로 클라우드 데이터 베이스로 옮길 수 있습니다.

API 명 설명
setObjectStorageInfo 오브젝트 스토리지 정보를 설정합니다. (파일 업로드 다운로드를 위해 반드시 설정되어야 하며 NAVER CLOUD PLATFORM 나 Amazon S3 호환 API 오브젝트 스토리지, 아카이브 스토리지로부터 복구할 수 있습니다.)
현재 DMS는 MSSQL만 지원되고 있습니다. ↩
downloadDmsFile setObjectStorageInfo를 이용해 저장한 정보를 이용해 Amazon S3 호환 스토리지부터 내부 복구용 스토리지로 백업 파일을 다운로드 합니다.
내부 복구용 스토리지로 파일이 옮겨져야 해당 백업파일을 이용해 데이터베이스를 복구할 수 있습니다.
예제 출력에서 requestNo를 저장 후 getDmsOperation API를 이용해 진행 상태를 조회할 수 있습니다.
uploadDmsFile 운영 중이던 데이터 베이스는 자동으로 백업을 수행하게 되고 해당 백업 파일을 오브젝트 스토리지로 업로드합니다. (downloadDmsFile이 참조하는 내부 복구 전용 디렉토리와 uploadDmsFile이 참조하는 백업 디렉토리는 백업 파일의 안정성 문제로 서로 다른 물리적 경로입니다.)
getObjectStorageBackupList 오브젝트 스토리지에서 내부 백업 스토리로 올린 백업 파일 리스트를 조회합니다.
데이터 베이스 리스토어는 내부 백업 스토리지로 옮겨진 파일을 대상으로 진행할 수 있습니다.
내부 백업 스토리지 파일은 15일 후 완전히 삭제되며 사용자가 삭제할 수 없습니다.(같은 파일명으로 오브젝트 스토리지로부터 내부 백업 스토리지로 다운로드 명령을 수행하면 새로운 파일로 변경됩니다.)
리스트를 출력해 온프레미스, 오브젝트 스토리지, 내부 백업 스토리지의 용량이 같은지 확인합니다.↩
getBackupList 자동 백업 리스트를 조회합니다.
restoreDmsDatabase 내부 백업 스토리지로 옮긴 파일을 이용해 데이터 베이스를 복구합니다.
별도로 restore database [userdb] with recovery API를 제공하지 않기 때문에 isRecovery 옵션에 주의합니다.
응답의 requestNo를 getDmsOperation API를 이용해 진행 상태를 조회할 수 있습니다.
restoreDmsTransactionLog DMS 트랜잭션 로그를 복구합니다.
getDmsOperation DMS 상태를 조회합니다. 예제 응답에서 codeName을 확인합니다.
아쉬운 점이 있다면 이야기해 주세요.
0/5000
내용을 입력해 주세요
의견 보내기