---
title: "CloudCacheInstance"
slug: "common-vapidatatype-cloudcacheinstance"
updated: 2026-09-17T09:25:09Z
published: 2026-09-17T09:25:09Z
canonical: "api.ncloud-docs.com/common-vapidatatype-cloudcacheinstance"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://api.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# CloudCacheInstance

Available in VPC

This is a Cloud DB for Cache instance.

## Syntax

The syntax is as follows:

```
private String cloudCacheInstanceNo;
private String cloudCacheDbmsCode;
private String cloudCacheServiceName;
private String cloudCacheInstanceStatusName;
private CommonCode cloudCacheInstanceStatus;
private CommonCode cloudCacheInstanceOperation;
private String cloudCacheImageProductCode;
private String engineVersion;
private CommonCode licence;
private Integer cloudCachePort;
private Boolean isHa;
private String cloudCacheServerPrefix;
private Boolean isBackup;
private Integer backupFileRetentionPeriod;
private String backupTime;
private String backupSchedule;
private Date createDate;
private Integer shardCount;
private Integer shardCopyCount;
private AccessControlGroupNoList accessControlGroupNoList;
private String configGroupNo;
private String configGroupName;
private CommonCode role;
private List<CloudCacheServerInstance> cloudCacheServerInstanceList;
```

## Field

The following describes the fields.

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `cloudCacheInstanceNo` | String | Required | Cloud DB for Cache instance number |
| `cloudCacheDbmsCode` | String | Required | Cloud DB for Cache instance's DBMS code - `Redis` \| `Valkey` |
| `cloudCacheServiceName` | String | Required | Cloud DB for Cache service name |
| `cloudCacheInstanceStatusName` | String | Required | Cloud DB for Cache instance status - `creating` \| `deleted` \| `deleting` \| `downgrading` \| `pending` \| `recovering` \| `restarting` \| `running` \| `settingup` \| `shuttingdown` \| `stopped` \| `upgrading` |
| `cloudCacheInstanceStatus` | [CommonCode](/docs/en/common-vapidatatype-commoncode) | Required | Cloud DB for Cache instance status - `INIT` \| `CREAT` \| `DEL` - `INIT`: Initiated - `CREAT`: Created - `DEL`: Deleted |
| `cloudCacheInstanceOperation` | [CommonCode](/docs/en/common-vapidatatype-commoncode) | Required | Cloud DB for Cache instance operation status - `CREAT` \| `DEL` \| `FO` \| `NULL` \| `SETUP` \| `UPGD` \| `DWGD` \| `BKP` - `CREAT`: Create - `DEL`: Delete - `FO`: Failover - `NULL`: No Operation - `SETUP`: Setup - `UPGD`: Upgrade - `DWGD`: Downgrade - `BKP`: Backup |
| `cloudCacheImageProductCode` | String | Optional | Cloud DB for Cache image product code |
| `engineVersion` | String | Optional | Cloud DB for Cache engine version |
| `license` | [CommonCode](/docs/en/common-vapidatatype-commoncode) | Optional | Cloud DB for Cache license |
| `cloudCachePort` | Integer | Optional | Cloud DB for Cache port |
| `isHa` | Boolean | Required | High availability status - `true` \| `false` |
| `cloudCacheServerPrefix` | String | Optional | Cloud Cache server name prefix |
| `isBackup` | Boolean | Optional | Backup status - `true` \| `false` |
| `backupFileRetentionPeriod` | Integer | Optional | Backup file retention period |
| `backupTime` | String | Optional | Backup time |
| `backupSchedule` | String | Optional | Whether automatic backups are set up |
| `createDate` | Date | Optional | Creation date and time |
| `shardCount` | Integer | Optional | Cloud DB for Cache shard count |
| `shardCopyCount` | Integer | Optional | Cloud DB for Cache replica per shard |
| `accessControlGroupNoList` | [AccessControlGroupNoList](/docs/en/common-vapidatatype-accesscontrolgroupnolist) | Optional | ACG number list |
| `configGroupNo` | configGroupNo | Optional | Cloud DB for Cache config group number |
| `configGroupName` | configGroupName | Optional | Cloud DB for Cache config group name |
| `role` | [CommonCode](/docs/en/common-vapidatatype-commoncode) | Required | Cloud DB for Cache configuration |
| `cloudCacheServerInstanceList` | List<[CloudCacheServerInstance](/docs/en/common-vapidatatype-cloudcacheserverinstance)> | Required | Cloud DB for Cache server instance list |