---
title: "CloudCacheInstance"
slug: "common-vapidatatype-cloudcacheinstance"
updated: 2026-09-17T09:15:39Z
published: 2026-09-17T09:15:39Z
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

VPC 환경에서 이용 가능합니다.

Cloud DB for Cache 인스턴스입니다.

## 구문

구문은 다음과 같습니다.

```
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;
```

## 필드

필드에 대한 설명은 다음과 같습니다.

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `cloudCacheInstanceNo` | String | Required | Cloud DB for Cache 인스턴스 번호 |
| `cloudCacheDbmsCode` | String | Required | Cloud DB for Cache 인스턴스의 DBMS 코드 - `Redis` \| `Valkey` |
| `cloudCacheServiceName` | String | Required | Cloud DB for Cache 서비스 이름 |
| `cloudCacheInstanceStatusName` | String | Required | Cloud DB for Cache 인스턴스 상태 - `creating` \| `deleted` \| `deleting` \| `downgrading` \| `pending` \| `recovering` \| `restarting` \| `running` \| `settingup` \| `shuttingdown` \| `stopped` \| `upgrading` |
| `cloudCacheInstanceStatus` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | Cloud DB for Cache 인스턴스 상태 - `INIT` \| `CREAT` \| `DEL` - `INIT`: Initiated - `CREAT`: Created - `DEL`: Deleted |
| `cloudCacheInstanceOperation` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | Cloud DB for Cache 인스턴스 운영 상태 - `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 이미지 상품 코드 |
| `engineVersion` | String | Optional | Cloud DB for Cache 엔진 버전 |
| `license` | [CommonCode](/docs/common-vapidatatype-commoncode) | Optional | Cloud DB for Cache 라이선스 |
| `cloudCachePort` | Integer | Optional | Cloud DB for Cache 포트 |
| `isHa` | Boolean | Required | 고가용성 여부 - `true` \| `false` |
| `cloudCacheServerPrefix` | String | Optional | Cloud Cache 서버 이름 Prefix |
| `isBackup` | Boolean | Optional | 백업 여부 - `true` \| `false` |
| `backupFileRetentionPeriod` | Integer | Optional | 백업 파일 보관 기간 |
| `backupTime` | String | Optional | 백업 시간 |
| `backupSchedule` | String | Optional | 자동 백업 설정 여부 |
| `createDate` | Date | Optional | 생성 일시 |
| `shardCount` | Integer | Optional | Cloud DB for Cache 샤드 수 |
| `shardCopyCount` | Integer | Optional | Cloud DB for Cache 샤드당 복제본 |
| `accessControlGroupNoList` | [AccessControlGroupNoList](/docs/common-vapidatatype-accesscontrolgroupnolist) | Optional | ACG 번호 목록 |
| `configGroupNo` | configGroupNo | Optional | Cloud DB for Cache Config 그룹 번호 |
| `configGroupName` | configGroupName | Optional | Cloud DB for Cache Config 그룹 이름 |
| `role` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | Cloud DB for Cache 구성 |
| `cloudCacheServerInstanceList` | List<[CloudCacheServerInstance](/docs/common-vapidatatype-cloudcacheserverinstance)> | Required | Cloud DB for Cache 서버 인스턴스 목록 |