概要

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-iam-access-key	Naverクラウドプラットフォームから発行された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
getCloudDBBackupDetailList	MySQL only
exportBackupToObjectStorage	MySQL only
getDbServerLogList	MySQL only
exportDbServerLogToObjectStorage	MySQL only

DMS

DMSはData Migration Serviceの略字であり、オンプレミスで運営していたデータベースをCloudDBにリカバリーするかCloudDBで自動バックアップされたバックアップファイルをオブジェクトストレージに移動できるサービスです。
該当サービスはAPI Gatewayを利用したAPIであり、オブジェクトストレージにバケットを作成してから使えます。大容量データベースも分単位の少ないサービス中止時間のみでクラウドデータベースに移動できます。

API名	説明
setObjectStorageInfo	オブジェクトストレージ情報を設定します。(ファイルアップロードやダウンロードのために必ず設定する必要があるし、Naverクラウドプラットフォームや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を確認します。

この記事は役に立ちましたか?

概要
共通設定
オペレーション
- Cloud DB
- DMS

タグ

Cloud DB