---
title: "CloudRedisInstance"
slug: "common-vapidatatype-cloudredisinstance"
tags: ["VPC", "Cloud DB for Redis"]
updated: 2026-07-23T09:04:03Z
published: 2026-07-23T09:04:03Z
canonical: "api.ncloud-docs.com/common-vapidatatype-cloudredisinstance"
---

> ## 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.

# CloudRedisInstance

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

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

## 구문

구문은 다음과 같습니다.

```
private String cloudRedisInstanceNo;
private String cloudRedisServiceName;
private String cloudRedisInstanceStatusName;
private CommonCode cloudRedisInstanceStatus;
private CommonCode cloudRedisInstanceOperation;
private String cloudRedisImageProductCode;
private String engineVersion;
private CommonCode licence;
private Integer cloudRedisPort;
private Boolean isHa;
private String cloudRedisServerPrefix;
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<CloudRedisServerInstance> cloudRedisServerInstanceList;
```

## 필드

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

| 필드 | 타입 | 필수 여부 | 설명 |
| --- | --- | --- | --- |
| `cloudRedisInstanceNo` | String | Required | Cloud DB for Cache 인스턴스 번호 |
| `cloudRedisServiceName` | String | Required | Cloud DB for Cache 서비스 이름 |
| `cloudRedisInstanceStatusName` | String | Required | Cloud DB for Cache 인스턴스 상태명 - `creating` \| `deleted` \| `deleting` \| `downgrading` \| `pending` \| `recovering` \| `restarting` \| `running` \| `settingup` \| `shuttingdown` \| `stopped` \| `upgrading` |
| `cloudRedisInstanceStatus` | [CommonCode](/docs/common-vapidatatype-commoncode) | Required | Cloud DB for Cache 인스턴스 상태 - `INIT` \| `CREAT` \| `DEL` - `INIT`: Initiated - `CREAT`: Created - `DEL`: Deleted |
| `cloudRedisInstanceOperation` | [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 |
| `cloudRedisImageProductCode` | String | Optional | Cloud DB for Cache 이미지 상품 코드 |
| `engineVersion` | String | Optional | Cloud DB for Cache 엔진 버전 |
| `license` | [CommonCode](/docs/common-vapidatatype-commoncode) | Optional | Cloud DB for Cache 라이선스 |
| `cloudRedisPort` | Integer | Optional | Cloud DB for Cache 포트 |
| `isHa` | Boolean | Required | 고가용성 여부 - `true` \| `false` |
| `cloudRedisServerPrefix` | String | Optional | Cloud Redis 서버 이름 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 구성 |
| `cloudRedisServerInstanceList` | List<[CloudRedisServerInstance](/docs/common-vapidatatype-cloudredisserverinstance)> | Required | Cloud DB for Cache 서버 인스턴스 목록 |