Cloud DB for Cache (VPC)の概要

Prev Next

VPC環境で利用できます。

Cloud DB for Cacheは、Redisキャッシュをいくつかの設定やクリックだけで簡単に構築して、NAVERの最適化設定で安定的に運用し、障害が発生すると自動復旧する完全管理型クラウドキャッシュサービスです。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の範囲に応じて2つのバージョンを提供しています。

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は次の通りです。

v2: https://ncloud.apigw.ntruss.com/vcache/v2
v1: https://ncloud.apigw.ntruss.com/vredis/v2

リクエストヘッダ

リクエストヘッダの説明は次の通りです。

フィールド 必須の有無 説明
x-ncp-apigw-timestamp Required 1970年1月1日00:00:00協定世界時(UTC)からの経過時間(ミリ秒)
  • API Gatewayサーバとの時間差が5分以上の場合は無効なリクエストとみなす
  • Unix Timestamp形式
x-ncp-iam-access-key Required NAVERクラウドプラットフォームから発行された Access Key
x-ncp-apigw-signature-v2 Required NAVERクラウドプラットフォームから発行された Access Keyとマッピングする Secret Keyと HMAC暗号化アルゴリズム(HmacSHA256)でリクエスト情報を暗号化した後、Base64にエンコードした署名
Content-Type Required リクエストデータの形式
  • application/json

レスポンス

共通レスポンス形式を説明します。

レスポンスステータスコード

Cloud DB for Cache APIは NAVERクラウドプラットフォームの共通レスポンスステータスコードを使用します。NAVERクラウドプラットフォームで共通して使用されるレスポンスステータスコードの詳細は、Ncloud APIのレスポンスステータスコードをご参照ください。

Cloud DB for Cache API

Cloud DB for Cache APIサービスが提供する APIの説明は次の通りです。

API 説明
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のバックアップを削除
exportBackupToObjectStorage Cloud DB for Cacheのバックアップファイルを Object Storageに転送
flushAllCloudCacheServerInstance Cloud DB for Cache FlushAllコマンドを利用し、選択した Redis 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リストを照会
getCloudCacheTargetVpcList 使用可能な VPCリストを照会
rebootCloudCacheServerInstance Cloud DB for Cacheサーバインスタンスを再起動

Cloud DB for Cache関連リソース

Cloud DB for Cache APIについてユーザーの理解に役立つよう、さまざまな関連リソースを提供しています。